[#OPENSSL_utf82uni]
= OPENSSL_utf82uni
:mrdocs:

Convert a UTF‐8 string to PKCS#12 BMPString form (big‐endian UTF‐16).

== Synopsis

Declared in `<openssl/pkcs12.h>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
unsigned char*
OPENSSL_utf82uni(
    char const* asc,
    int asclen,
    unsigned char** uni,
    int* unilen);
----

== Return Value

Pointer to the BMPString (same as *`uni),` or NULL on error. Falls back to OPENSSL_asc2uni() if `asc` is not valid UTF‐8.

== Parameters

[cols="1,4"]
|===
| Name| Description
| *asc*
| UTF‐8 input string.
| *asclen*
| Length of `asc` in bytes, or ‐1 to use strlen().
| *uni*
| Address of pointer updated to the allocated BMPString buffer.
| *unilen*
| Address to receive BMPString length in bytes.
|===


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