[#OPENSSL_asc2uni]
= OPENSSL_asc2uni
:mrdocs:

Convert an ASCII/ISO‐8859‐1 string to PKCS#12 BMPString form (zero‐extended UTF‐16BE).

== Synopsis

Declared in `<openssl/pkcs12.h>`

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

== Return Value

Pointer to the BMPString (same as *`uni` when `uni` is non‐NULL), or NULL on error.

== Parameters

[cols="1,4"]
|===
| Name| Description
| *asc*
| Input octets (typically ASCII or Latin‐1).
| *asclen*
| Length of `asc` in bytes, or ‐1 to use strlen().
| *uni*
| Optional address of pointer updated to the allocated BMPString buffer.
| *unilen*
| Optional address to receive BMPString length in bytes (including double NUL).
|===


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