NAME
ASN1_PRINTABLE_type —
classify a single-byte character
string
SYNOPSIS
#include
<openssl/asn1.h>
int
ASN1_PRINTABLE_type(const unsigned
char *string, int len);
DESCRIPTION
ASN1_PRINTABLE_type()
assumes that the given string consists of single-byte
characters and classifies it according to which kinds characters occur. If
len is greater than 0, at most
len characters are inspected. Otherwise, the
string needs to be NUL-terminated.
RETURN VALUES
If the given string contains a character
outside the ascii(7) range, ASN1_PRINTABLE_type()
returns V_ASN1_T61STRING.
Otherwise, if it contains a character that is neither a letter nor
a digit nor the space character
(‘ ’, ASCII 0x20) nor the
apostrophe quote (‘'’, ASCII 0x27) nor
contained in the set "()+,-./:=?", it returns
V_ASN1_IA5STRING.
Otherwise, including if string is a
NULL pointer or points to an empty string, it
returns V_ASN1_PRINTABLESTRING.
SEE ALSO
ASN1_mbstring_copy(3), ASN1_STRING_new(3), ASN1_STRING_to_UTF8(3), isascii(3), ascii(7)
HISTORY
ASN1_PRINTABLE_type() first appeared in
SSLeay 0.4.5d, has been part of the public API since SSLeay 0.5.1, and has
been available since OpenBSD 2.4.
CAVEATS
The ASN.1 notion of what constitutes a PrintableString is more restrictive than what the C library function isprint(3) considers printable.