[#ASN1_STRING_to_UTF8]
= ASN1_STRING_to_UTF8
:mrdocs:

Convert an ASN.1 string to a newly allocated UTF‐8 byte sequence.

== Synopsis

Declared in `<openssl/asn1.h>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
int
ASN1_STRING_to_UTF8(
    unsigned char** out,
    xref:ASN1_STRING.adoc[ASN1_STRING] const* in);
----

== Return Value

Number of UTF‐8 bytes written to *`out` on success, or a negative value on error.

== Parameters

[cols="1,4"]
|===
| Name| Description
| *out*
| On success, set to a buffer allocated with OPENSSL_malloc() holding UTF‐8 octets (caller frees).
| *in*
| Source ASN.1 string of any supported string type.
|===


[.small]#Created with https://www.mrdocs.com[MrDocs]#