ASN1_STRING_LENGTH(3ssl) OpenSSL ASN1_STRING_LENGTH(3ssl) NOM ASN1_STRING_dup, ASN1_STRING_cmp, ASN1_STRING_set, ASN1_STRING_length, ASN1_STRING_type, ASN1_STRING_get0_data, ASN1_STRING_data, ASN1_STRING_to_UTF8 - Fonctions utilitaires ASN1_STRING SYNOPSIS #include int ASN1_STRING_length(ASN1_STRING *x); const unsigned char *ASN1_STRING_get0_data(const ASN1_STRING *x); unsigned char *ASN1_STRING_data(ASN1_STRING *x); ASN1_STRING *ASN1_STRING_dup(const ASN1_STRING *a); int ASN1_STRING_cmp(ASN1_STRING *a, ASN1_STRING *b); int ASN1_STRING_set(ASN1_STRING *str, const void *data, int len); int ASN1_STRING_type(const ASN1_STRING *x); int ASN1_STRING_to_UTF8(unsigned char **out, const ASN1_STRING *in); DESCRIPTION Ces fonctions permettent la manipulation d'une structure ASN1_STRING. ASN1_STRING_length() renvoie la longueur du contenu de x. x NE DOIT PAS etre NULL. ASN1_STRING_get0_data() renvoie un pointeur interne vers les donnees de x. Dans la mesure ou c'est un pointeur interne, il ne doit pas etre libere ou modifie de quelque maniere que ce soit. x NE DOIT PAS etre ASN1_STRING_data() est identique a ASN1_STRING_get0_data() sauf que la valeur renvoyee n'est pas constante. Cette fonction est obsolete : les applications doivent utiliser ASN1_STRING_get0_data() a la place. ASN1_STRING_dup() renvoie une copie de la structure a. ASN1_STRING_cmp() compare a et b, en renvoyant 0 si les deux sont identiques. Les types de chaine et les contenus sont compares. ASN1_STRING_set() definit le membre data de la chaine str avec le le contenu du tampon data de longueur len. Les donnees fournies sont copiees. Si len est -1, la longueur est determinee par strlen(data). ASN1_STRING_type() renvoie le type de x en utilisant des constantes standard telles que V_ASN1_OCTET_STRING. ASN1_STRING_to_UTF8() convertit la chaine in au format UTF-8, les donnees converties sont allouees dans un tampon *out. La longueur de out ou un code d'erreur negatif est renvoyee. Le tampon *out doit etre libere en utilisant OPENSSL_free(). NOTES Almost all ASN1 types in OpenSSL are represented as an ASN1_STRING structure. Other types such as ASN1_OCTET_STRING are simply typedef'ed to ASN1_STRING and the functions call the ASN1_STRING equivalents. ASN1_STRING is also used for some CHOICE types which consist entirely of primitive string types such as DirectoryString and Time. Ces fonctions ne doivent pas etre utilisees pour examiner ou modifier les types ASN1_INTEGER ou ASN1_ENUMERATED : les fonctions utilitaires INTEGER ou ENUMERATED appropriees doivent etre utilisees a la place. En general, il n'est pas possible de supposer que les donnees renvoyees par ASN1_STRING_data() sont terminees par un octet NULL ou ne contiennent pas d'octets NULL incorpores. Le format reel des donnees dependra du type reel de chaine lui-meme : par exemple, pour une chaine IA5String, les donnees seront au format ASCII, pour une chaine BMPString, deux octets par caractere, au format grand boutiste, et pour une chaine UTF8String les donnees seront au format UTF-8. Des precautions similaires doivent etre prises pour s'assurer que les donnees sont au format correct lors de l'appel de ASN1_STRING_set(). VALEURS RENVOYEES ASN1_STRING_length() renvoie la longueur du contenu de x. ASN1_STRING_get0_data() et ASN1_STRING_data() renvoient un pointeur interne vers les donnees de x. ASN1_STRING_dup() renvoie une structure ASN1_STRING valable ou NULL en cas d'erreur. ASN1_STRING_cmp() renvoie un entier superieur, egal ou inferieur a 0 selon que a est superieur, egal ou inferieur a b. ASN1_STRING_set() renvoie 1 en cas de succes et 0 en cas d'erreur. ASN1_STRING_type() renvoie le type de x. ASN1_STRING_to_UTF8() renvoie le nombre d'octets dans la chaine de sortie out ou une valeur negative en cas d'erreur. VOIR AUSSI ERR_get_error(3) COPYRIGHT Copyright 2002-2020 Les auteurs du projet OpenSSL. Tous droits reserves. Sous licence Apache 2.0 (la << Licence >>). Vous ne pouvez utiliser ce fichier que conformement a la Licence. Vous trouverez une copie dans le fichier LICENSE de la distribution du source ou a l'adresse . TRADUCTION La traduction francaise de cette page de manuel a ete creee par Nicolas Francois , David Prevot , Oliver Hamm et Jean- Pierre Giraud Cette traduction est une documentation libre ; veuillez vous reporter a la GNU General Public License version 3 concernant les conditions de copie et de distribution. Il n'y a aucune RESPONSABILITE LEGALE. Si vous decouvrez un bogue dans la traduction de cette page de manuel, veuillez envoyer un message a . 3.5.2 5 aout 2025 ASN1_STRING_LENGTH(3ssl)