[#ASN1_STRING_set_by_NID]
= ASN1_STRING_set_by_NID
:mrdocs:

Create or update an ASN.1 string from multibyte input using the string table for `nid.`

== Synopsis

Declared in `<openssl/asn1.h>`

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

== Return Value

Resulting ASN1_STRING, or NULL on error.

== Parameters

[cols="1,4"]
|===
| Name| Description
| *out*
| Optional destination; if NULL a new string is allocated and returned.
| *in*
| Input bytes in the encoding given by `inform.`
| *inlen*
| Length of `in` in bytes, or ‐1 if `in` is NUL‐terminated.
| *inform*
| Input encoding (MBSTRING_ASC, MBSTRING_BMP, MBSTRING_UNIV, or MBSTRING_UTF8).
| *nid*
| Object NID whose ASN1_STRING_TABLE entry selects allowed string types and size limits.
|===


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