.\" -*- 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 Titlu "ASN1_STRING_LENGTH 3ssl" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH ASN1_STRING_LENGTH 3ssl "5 august 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 NUME 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 \- funcții utilitare ASN1_STRING .SH SINOPSIS .IX Antet SINOPSIS .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 DESCRIERE .IX Antet DESCRIERE Aceste funcții permit manipularea unei structuri \fBASN1_STRING\fP. .PP \&\fBASN1_STRING_length()\fP returnează lungimea conținutului \fIx\fP. \fIx\fP \fBNU TREBUIE\fP să fie NULL. .PP \&\fBASN1_STRING_get0_data()\fP returnează un indicator intern către datele din \fIx\fP. Deoarece acesta este un indicator intern, el nu trebuie eliberat sau modificat în niciun fel. \fIx\fP NU TREBUIE să fie NULL. .PP \&\fBASN1_STRING_data()\fP este similară cu \fBASN1_STRING_get0_data()\fP, cu excepția faptului că valoarea returnată nu este constantă. Această funcție este depreciată: aplicațiile ar trebui să utilizeze în schimb \fBASN1_STRING_get0_data()\fP. .PP \&\fBASN1_STRING_dup()\fP returnează o copie a structurii \fIa\fP. .PP \&\fBASN1_STRING_cmp()\fP compară \fIa\fP și \fIb\fP, returnând 0 dacă cele două sunt identice. Se compară tipurile și conținutul șirurilor. .PP \&\fBASN1_STRING_set()\fP stabilește datele șirului \fIstr\fP în tamponul \fIdata\fP sau lungimea \fIlen\fP. Datele furnizate sunt copiate. Dacă \fIlen\fP este \-1, atunci lungimea este determinată de strlen(data). .PP \&\fBASN1_STRING_type()\fP returnează tipul lui \fIx\fP, utilizând constante standard precum \fBV_ASN1_OCTET_STRING\fP. .PP \&\fBASN1_STRING_to_UTF8()\fP convertește șirul \fIin\fP în format UTF8, datele convertite fiind alocate într\-un tampon în \fI*out\fP. Se returnează lungimea \&\fIout\fP sau un cod de eroare negativ. Tamponul \fI*out\fP trebuie eliberat folosind \fBOPENSSL_free()\fP. .SH NOTE .IX Antet NOTE Aproape toate tipurile ASN1 din OpenSSL sunt reprezentate ca o structură \fBASN1_STRING\fP. Alte tipuri, cum ar fi \fBASN1_OCTET_STRING\fP, sunt pur și simplu „tipedef”\-ate la \fBASN1_STRING\fP, iar funcțiile apelează echivalentele \fBASN1_STRING\fP. \fBASN1_STRING\fP este utilizat și pentru unele tipuri \fBCHOICE\fP care constau în întregime din tipuri de șiruri primitive, cum ar fi \fBDirectoryString\fP și \fBTime\fP. .PP Aceste funcții \fBnu\fP trebuie utilizate pentru a examina sau modifica tipurile \fBASN1_INTEGER\fP sau \fBASN1_ENUMERATED\fP: în schimb, trebuie utilizate funcțiile utilitare relevante \fBINTEGER\fP sau \fBENUMERATED\fP. .PP În general, nu se poate presupune că datele returnate de \fBASN1_STRING_data()\fP sunt terminate cu null sau nu conțin null\-uri încorporate. Formatul real al datelor va depinde de tipul real al șirului în sine: de exemplu, pentru un IA5String, datele vor fi ASCII, pentru un BMPString, vor fi doi octeți per caracter în format big endian, iar pentru un UTF8String, vor fi în format UTF8. .PP Trebuie să se acorde o atenție similară pentru a se asigura că datele sunt în formatul corect atunci când se apelează \fBASN1_STRING_set()\fP. .SH "VALORI RETURNATE" .IX Antet "VALORI RETURNATE" \&\fBASN1_STRING_length()\fP returnează lungimea conținutului \fIx\fP. .PP \&\fBASN1_STRING_get0_data()\fP și \fBASN1_STRING_data()\fP returnează un indicator intern către datele din \fIx\fP. .PP \&\fBASN1_STRING_dup()\fP returnează o structură \fBASN1_STRING\fP validă sau NULL dacă a apărut o eroare. .PP \&\fBASN1_STRING_cmp()\fP returnează un număr întreg mai mare, egal sau mai mic decât 0, în funcție de faptul dacă \fIa\fP este mai mare, egal sau mai mic decât \fIb\fP. .PP \&\fBASN1_STRING_set()\fP returnează 1 în caz de succes sau 0 în caz de eroare. .PP \&\fBASN1_STRING_type()\fP returnează tipul lui \fIx\fP. .PP \&\fBASN1_STRING_to_UTF8()\fP returnează numărul de octeți din șirul de ieșire \fIout\fP sau o valoare negativă dacă a apărut o eroare. .SH "CONSULTAȚI ȘI" .IX Antet "CONSULTAȚI ȘI" \&\fBERR_get_error\fP\|(3) .SH "DREPTURI DE AUTOR" .IX Antet "DREPTURI DE AUTOR" Drepturi de autor 2002\-2020 The OpenSSL Project Authors. Toate drepturile rezervate. .PP Licențiat sub Licența Apache 2.0 („License”). Nu aveți voie să utilizați acest fișier decât în conformitate cu licența. Puteți obține o copie din fișierul LICENSE din distribuția sursei sau de la . .PP .SH TRADUCERE Traducerea în limba română a acestui manual a fost făcută de Remus-Gabriel Chelu . .PP Această traducere este documentație gratuită; citiți .UR https://www.gnu.org/licenses/gpl-3.0.html Licența publică generală GNU Versiunea 3 .UE sau o versiune ulterioară cu privire la condiții privind drepturile de autor. NU se asumă NICIO RESPONSABILITATE. .PP Dacă găsiți erori în traducerea acestui manual, vă rugăm să trimiteți un e-mail la .MT translation-team-ro@lists.sourceforge.net .ME .