UTF8

@Serializable(with = Asn1Utf8StringSerializer::class)

UTF8 STRING (ISO/IEC 10646, encoded as UTF-8 per RFC 3629).

isValid reports whether rawValue is well-formed UTF-8; it deliberately does not reject the legitimate replacement character U+FFFD.

Constructors

UTF8

constructor(value: String)

Properties

isValid

open override val isValid: Boolean

true iff rawValue is well-formed UTF-8, via a canonical round-trip: value decodes rawValue (replacing any malformed sequence with U+FFFD), and re-encoding reproduces rawValue exactly iff the input was well-formed. Bytes that genuinely encode U+FFFD round-trip and are reported valid; malformed/overlong sequences re-encode differently and are reported invalid.

performValidation

val performValidation: Boolean

rawValue

val rawValue: ByteArray

tag

open override val tag: ULong

value

val value: String

Always the UTF-8 interpretation of rawValue. The decoding is performed via String.decodeFromAsn1ContentBytes(rawValue), which internally uses the standard library's ByteArray.decodeToString.

Functions

encodeToDer

fun Asn1Encodable<*>.encodeToDer(): ByteArray

Convenience function to directly get the DER-encoded representation of the implementing object

fun Asn1Encodable<*>.encodeToDer(sink: Sink)

encodeToDerOrNull

fun Asn1Encodable<*>.encodeToDerOrNull(): ByteArray?

Exception-free version of encodeToDer

encodeToTlv

open override fun encodeToTlv(): Asn1Primitive

Encodes the implementing object into an A

encodeToTlvOrNull

fun <A : Asn1Element> Asn1Encodable<A>.encodeToTlvOrNull(): A?

Exception-free version of Asn1Encodable.encodeToTlv

equals

open operator override fun equals(other: Any?): Boolean

hashCode

open override fun hashCode(): Int

prettyPrintAsn1

open fun prettyPrintAsn1(): String

shorthand for Asn1Element.prettyPrint, hence, a call to this function encodes this encodable to an Asn1Element, holds it in memory, pretty prints it, and discards it. This characteristic may be relevant in memory-constrained environments.

toDerHexString

fun Asn1Encodable<*>.toDerHexString(lineLen: Int? = null): String

withImplicitTag

open infix fun withImplicitTag(tag: Asn1Element.Tag): Asn1Element

Creates a new implicitly tagged ASN.1 Element from this ASN.1 Element. NOTE: The TagClass of the provided tag will be used! If you want the result to have TagClass.CONTEXT_SPECIFIC, also invoke tag withClass TagClass.CONTEXT_SPECIFIC!. If a CONSTRUCTED Tag is applied to an ASN.1 Primitive, the CONSTRUCTED bit is overridden and set to zero

open infix fun withImplicitTag(template: Asn1Element.Tag.Template): Asn1Element

Creates a new implicitly tagged ASN.1 Element from this ASN.1 Structure. If the provided template's tagClass is not set, the class of the resulting structure defaults to TagClass.CONTEXT_SPECIFIC. If a CONSTRUCTED Tag is applied to an ASN.1 Primitive, the CONSTRUCTED bit is overridden and set to zero

open infix fun withImplicitTag(tagValue: ULong): Asn1Element

Creates a new implicitly tagged ASN.1 Element from this ASN.1 Element. Sets the class of the resulting structure to TagClass.CONTEXT_SPECIFIC