.\" -*- coding: UTF-8 -*- .de Sp \" Vertical space (when we can't use .PP) .if t .sp .5v .if n .sp .. .\" -*- mode: troff; coding: utf-8 -*- .\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45) .\" .\" Standard preamble: .\" ======================================================================== .de Vb \" Begin verbatim text .ft CW .nf .ne \\$1 .. .de Ve \" End verbatim text .ft R .fi .. .ie n \{\ . ds C` "" . ds C' "" 'br\} .el\{\ . ds C` . ds C' 'br\} .\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>. .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" .\" Escape single quotes in literal strings from groff's Unicode transform. .de IX .. .\" .\" If the F register is >0, we'll generate index entries on stderr for .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index .\" entries marked with X<> in POD. Of course, you'll have to process the .\" output yourself in some meaningful fashion. .\" .\" Avoid warning from groff about undefined register 'F'. .nr rF 0 .if \n(.g .if rF .nr rF 1 .if (\n(rF:(\n(.g==0)) \{\ . if \nF \{\ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . if !\nF==2 \{\ . nr % 0 . nr F 2 . \} . \} .\} .rr rF .if n .ds AD l .\" .\" Required to disable full justification in groff 1.23.0. .\" ======================================================================== .\" .IX Title "ASN1_STRING_LENGTH 3ssl" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH ASN1_STRING_LENGTH 3ssl "5 août 2025" 3.5.2 OpenSSL .if n .ad l .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .nh .SH 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 .SH SYNOPSIS .IX Header SYNOPSIS .Vb 1 \& #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); .Ve .SH DESCRIPTION .IX Header DESCRIPTION Ces fonctions permettent la manipulation d'une structure \fBASN1_STRING\fP. .PP \&\fBASN1_STRING_length()\fP renvoie la longueur du contenu de \fIx\fP. \fIx\fP \fBNE DOIT PAS\fP être NULL. .PP \&\fBASN1_STRING_get0_data()\fP renvoie un pointeur interne vers les données de \fIx\fP. Dans la mesure où c'est un pointeur interne, il ne doit \fBpas\fP être libéré ou modifié de quelque manière que ce soit. \fIx\fP \fBNE DOIT PAS\fP être .PP \&\fBASN1_STRING_data()\fP est identique à \fBASN1_STRING_get0_data()\fP sauf que la valeur renvoyée n'est pas constante. Cette fonction est obsolète : les applications doivent utiliser \fBASN1_STRING_get0_data()\fP à la place. .PP \&\fBASN1_STRING_dup()\fP renvoie une copie de la structure \fIa\fP. .PP \&\fBASN1_STRING_cmp()\fP compare \fIa\fP et \fIb\fP, en renvoyant \fB0\fP si les deux sont identiques. Les types de chaîne et les contenus sont comparés. .PP \&\fBASN1_STRING_set()\fP définit le membre data de la chaîne \fIstr\fP avec le le contenu du tampon \&\fIdata\fP de longueur \fIlen\fP. Les données fournies sont copiées. Si \fIlen\fP est \-1, la longueur est déterminée par strlen(data). .PP \&\fBASN1_STRING_type()\fP renvoie le type de \fIx\fP en utilisant des constantes standard telles que \fBV_ASN1_OCTET_STRING\fP. .PP \&\fBASN1_STRING_to_UTF8()\fP convertit la chaîne \fIin\fP au format UTF\-8, les données converties sont allouées dans un tampon \fI*out\fP. La longueur de \&\fIout\fP ou un code d'erreur négatif est renvoyée. Le tampon \fI*out\fP doit être libéré en utilisant \fBOPENSSL_free()\fP. .SH NOTES .IX Header NOTES Almost all ASN1 types in OpenSSL are represented as an \fBASN1_STRING\fP structure. Other types such as \fBASN1_OCTET_STRING\fP are simply typedef\*(Aqed to \fBASN1_STRING\fP and the functions call the \fBASN1_STRING\fP equivalents. \&\fBASN1_STRING\fP is also used for some \fBCHOICE\fP types which consist entirely of primitive string types such as \fBDirectoryString\fP and \&\fBTime\fP. .PP Ces fonctions ne doivent \fBpas\fP être utilisées pour examiner ou modifier les types \fBASN1_INTEGER\fP ou \fBASN1_ENUMERATED\fP : les fonctions utilitaires \fBINTEGER\fP ou \fBENUMERATED\fP appropriées doivent être utilisées à la place. .PP En général, il n'est pas possible de supposer que les données renvoyées par \fBASN1_STRING_data()\fP sont terminées par un octet NULL ou ne contiennent pas d'octets NULL incorporés. Le format réel des données dépendra du type réel de chaîne lui\-même : par exemple, pour une chaîne IA5String, les données seront au format ASCII, pour une chaîne BMPString, deux octets par caractère, au format grand boutiste, et pour une chaîne UTF8String les données seront au format UTF\-8. .PP Des précautions similaires doivent être prises pour s'assurer que les données sont au format correct lors de l'appel de \fBASN1_STRING_set()\fP. .SH "VALEURS RENVOYÉES" .IX Header "VALEURS RENVOYÉES" \&\fBASN1_STRING_length()\fP renvoie la longueur du contenu de \fIx\fP. .PP \&\fBASN1_STRING_get0_data()\fP et \fBASN1_STRING_data()\fP renvoient un pointeur interne vers les données de\ \fIx\fP. .PP \&\fBASN1_STRING_dup()\fP renvoie une structure \fBASN1_STRING\fP valable ou NULL en cas d'erreur. .PP \&\fBASN1_STRING_cmp()\fP renvoie un entier supérieur, égal ou inférieur à 0 selon que \fIa\fP est supérieur, égal ou inférieur à \fIb\fP. .PP \&\fBASN1_STRING_set()\fP renvoie \fB1\fP en cas de succès et \fB0\fP en cas d'erreur. .PP \&\fBASN1_STRING_type()\fP renvoie le type de \fIx\fP. .PP \&\fBASN1_STRING_to_UTF8()\fP renvoie le nombre d'octets dans la chaîne de sortie \fIout\fP ou une valeur négative en cas d'erreur. .SH "VOIR AUSSI" .IX Header "VOIR AUSSI" \&\fBERR_get_error\fP\|(3) .SH COPYRIGHT .IX Header COPYRIGHT Copyright 2002\-2020 Les auteurs du projet OpenSSL. Tous droits réservés. .PP Sous licence Apache 2.0 (la « Licence »). Vous ne pouvez utiliser ce fichier que conformément à la Licence. Vous trouverez une copie dans le fichier \s-1LICENSE\s0 de la distribution du source ou à l'adresse . .PP .SH TRADUCTION La traduction française de cette page de manuel a été créée par Nicolas François , David Prévot , Oliver Hamm et Jean-Pierre Giraud . .PP Cette traduction est une documentation libre ; veuillez vous reporter à la .UR https://www.gnu.org/licenses/gpl-3.0.html GNU General Public License version 3 .UE concernant les conditions de copie et de distribution. Il n'y a aucune RESPONSABILITÉ LÉGALE. .PP Si vous découvrez un bogue dans la traduction de cette page de manuel, veuillez envoyer un message à .MT debian-l10n-french@lists.debian.org .ME .