[#ASN1_mbstring_ncopy]
= ASN1_mbstring_ncopy
:mrdocs:

Like ASN1_mbstring_copy(), also enforcing minimum and maximum character counts.

== Synopsis

Declared in `<openssl/asn1.h>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
int
ASN1_mbstring_ncopy(
    xref:ASN1_STRING.adoc[ASN1_STRING]** out,
    unsigned char const* in,
    int len,
    int inform,
    unsigned long mask,
    long minsize,
    long maxsize);
----

== Return Value

Positive ASN.1 string type on success, or a negative value on error.

== Parameters

[cols="1,4"]
|===
| Name| Description
| *out*
| Destination; if NULL a new string is allocated, otherwise *`out` may be reused.
| *in*
| Input bytes in the encoding given by `inform.`
| *len*
| Length of `in` in bytes, or ‐1 if `in` is NUL‐terminated.
| *inform*
| Input encoding (MBSTRING_ASC, MBSTRING_BMP, MBSTRING_UNIV, or MBSTRING_UTF8).
| *mask*
| B_ASN1_* bitmask of permitted output string types (0 selects the default mask).
| *minsize*
| Minimum character count (0 disables the check).
| *maxsize*
| Maximum character count (0 disables the check).
|===


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