ASN1_STRING_LENGTH(3ssl)            OpenSSL           ASN1_STRING_LENGTH(3ssl)


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

SINOPSIS
        #include <openssl/asn1.h>

        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);

DESCRIERE
       Aceste func<?>ii permit manipularea unei structuri ASN1_STRING.

       ASN1_STRING_length() returneaza lungimea con<?>inutului x. x NU TREBUIE
       sa fie NULL.

       ASN1_STRING_get0_data() returneaza un indicator intern catre datele din
       x. Deoarece acesta este un indicator intern, el nu trebuie eliberat sau
       modificat in niciun fel. x NU TREBUIE sa fie NULL.

       ASN1_STRING_data() este similara cu ASN1_STRING_get0_data(), cu
       excep<?>ia faptului ca valoarea returnata nu este constanta. Aceasta
       func<?>ie este depreciata: aplica<?>iile ar trebui sa utilizeze in
       schimb ASN1_STRING_get0_data().

       ASN1_STRING_dup() returneaza o copie a structurii a.

       ASN1_STRING_cmp() compara a <?>i b, returnand 0 daca cele doua sunt
       identice. Se compara tipurile <?>i con<?>inutul <?>irurilor.

       ASN1_STRING_set() stabile<?>te datele <?>irului str in tamponul data
       sau lungimea len. Datele furnizate sunt copiate. Daca len este -1,
       atunci lungimea este determinata de strlen(data).

       ASN1_STRING_type() returneaza tipul lui x, utilizand constante standard
       precum V_ASN1_OCTET_STRING.

       ASN1_STRING_to_UTF8() converte<?>te <?>irul in in format UTF8, datele
       convertite fiind alocate intr-un tampon in *out. Se returneaza lungimea
       out sau un cod de eroare negativ. Tamponul *out trebuie eliberat
       folosind OPENSSL_free().

NOTE
       Aproape toate tipurile ASN1 din OpenSSL sunt reprezentate ca o
       structura ASN1_STRING. Alte tipuri, cum ar fi ASN1_OCTET_STRING, sunt
       pur <?>i simplu ,,tipedef"-ate la ASN1_STRING, iar func<?>iile apeleaza
       echivalentele ASN1_STRING. ASN1_STRING este utilizat <?>i pentru unele
       tipuri CHOICE care constau in intregime din tipuri de <?>iruri
       primitive, cum ar fi DirectoryString <?>i Time.

       Aceste func<?>ii nu trebuie utilizate pentru a examina sau modifica
       tipurile ASN1_INTEGER sau ASN1_ENUMERATED: in schimb, trebuie utilizate
       func<?>iile utilitare relevante INTEGER sau ENUMERATED.

       In general, nu se poate presupune ca datele returnate de
       ASN1_STRING_data() sunt terminate cu null sau nu con<?>in null-uri
       incorporate. Formatul real al datelor va depinde de tipul real al
       <?>irului in sine: de exemplu, pentru un IA5String, datele vor fi
       ASCII, pentru un BMPString, vor fi doi octe<?>i per caracter in format
       big endian, iar pentru un UTF8String, vor fi in format UTF8.

       Trebuie sa se acorde o aten<?>ie similara pentru a se asigura ca datele
       sunt in formatul corect atunci cand se apeleaza ASN1_STRING_set().

VALORI RETURNATE
       ASN1_STRING_length() returneaza lungimea con<?>inutului x.

       ASN1_STRING_get0_data() <?>i ASN1_STRING_data() returneaza un indicator
       intern catre datele din x.

       ASN1_STRING_dup() returneaza o structura ASN1_STRING valida sau NULL
       daca a aparut o eroare.

       ASN1_STRING_cmp() returneaza un numar intreg mai mare, egal sau mai mic
       decat 0, in func<?>ie de faptul daca a este mai mare, egal sau mai mic
       decat b.

       ASN1_STRING_set() returneaza 1 in caz de succes sau 0 in caz de eroare.

       ASN1_STRING_type() returneaza tipul lui x.

       ASN1_STRING_to_UTF8() returneaza numarul de octe<?>i din <?>irul de
       ie<?>ire out sau o valoare negativa daca a aparut o eroare.

CONSULTA<?>I <?>I
       ERR_get_error(3)

DREPTURI DE AUTOR
       Drepturi de autor 2002-2020 The OpenSSL Project Authors. Toate
       drepturile rezervate.

       Licen<?>iat sub Licen<?>a Apache 2.0 (,,License"). Nu ave<?>i voie sa
       utiliza<?>i acest fi<?>ier decat in conformitate cu licen<?>a. Pute<?>i
       ob<?>ine o copie din fi<?>ierul LICENSE din distribu<?>ia sursei sau de
       la <https://www.openssl.org/source/license.html>.

TRADUCERE
       Traducerea in limba romana a acestui manual a fost facuta de Remus-
       Gabriel Chelu <remusgabriel.chelu@disroot.org>

       Aceasta traducere este documenta<?>ie gratuita; citi<?>i Licen<?>a
       publica generala GNU Versiunea 3
       <https://www.gnu.org/licenses/gpl-3.0.html> sau o versiune ulterioara
       cu privire la condi<?>ii privind drepturile de autor.  NU se asuma
       NICIO RESPONSABILITATE.

       Daca gasi<?>i erori in traducerea acestui manual, va rugam sa
       trimite<?>i un e-mail la <translation-team-ro@lists.sourceforge.net>.

3.5.2                            5 august 2025        ASN1_STRING_LENGTH(3ssl)