strtok(3)                  Library Functions Manual                  strtok(3)

NUME
       strtok, strtok_r - extrage simboluri din <?>iruri

BIBLIOTECA
       Biblioteca C standard (libc, -lc)

SINOPSIS
       #include <string.h>

       char *strtok(char *_Nullable restrict str, const char *restrict delim);
       char *strtok_r(char *_Nullable restrict str, const char *restrict delim,
                      char **restrict saveptr);

   Cerin<?>e pentru macrocomenzi de testare a caracteristicilor pentru glibc
   (consulta<?>i feature_test_macros(7)):

       strtok_r():
           _POSIX_C_SOURCE
               || /* glibc <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE

DESCRIERE
       Func<?>ia strtok() descompune un <?>ir de caractere intr-o secven<?>a
       de zero sau mai multe simboluri nevide. La primul apel la strtok(),
       <?>irul de caractere care trebuie analizat trebuie specificat in str.
       In fiecare apel ulterior care ar trebui sa analizeze acela<?>i <?>ir de
       caractere, str trebuie sa fie NULL.

       Argumentul delim specifica un set de octe<?>i care delimiteaza
       simbolurile din <?>irul analizat. Apelantul poate specifica <?>iruri
       diferite in delim in apeluri succesive care analizeaza acela<?>i <?>ir.

       Fiecare apel la strtok() returneaza un indicator catre un <?>ir cu
       termina<?>ie nula care con<?>ine urmatorul simbol. Acest <?>ir nu
       include octetul de delimitare. Daca nu se mai gasesc alte simboluri,
       strtok() returneaza NULL.

       O secven<?>a de apeluri la strtok() care opereaza asupra aceluia<?>i
       <?>ir de caractere men<?>ine un indicator care determina punctul de la
       care incepe cautarea urmatorului simbol. Primul apel la strtok()
       stabile<?>te acest indicator la primul octet al <?>irului de caractere.
       Inceputul urmatorului simbol este determinat prin scanarea inainte
       pentru urmatorul octet nedelimitator din str.  Daca se gase<?>te un
       astfel de octet, acesta este considerat ca fiind inceputul urmatorului
       simbol.  Daca nu se gase<?>te un astfel de octet, atunci nu mai exista
       alte simboluri, iar strtok() returneaza NULL.  (Un <?>ir de caractere
       care este gol sau care con<?>ine numai delimitatori va face astfel ca
       strtok() sa returneze NULL la primul apel).

       Sfar<?>itul fiecarui simbol este gasit prin scanarea inainte pana cand
       este gasit fie urmatorul octet de delimitare, fie octetul nul de
       terminare ('\0'). In cazul in care se gase<?>te un octet de delimitare,
       acesta este suprascris cu un octet nul pentru a incheia simbolul
       curent, iar strtok() salveaza un indicator la urmatorul octet; acest
       indicator va fi utilizat ca punct de plecare la cautarea urmatorului
       simbol. In acest caz, strtok() returneaza un indicator la inceputul
       simbolului gasit.

       Din descrierea de mai sus, rezulta ca o secven<?>a de doi sau mai
       mul<?>i octe<?>i delimitatori contigui in <?>irul analizat este
       considerata a fi un singur delimitator <?>i ca octe<?>ii delimitatori
       de la inceputul sau sfar<?>itul <?>irului sunt ignora<?>i. Altfel spus:
       simbolurile returnate de strtok() sunt intotdeauna <?>iruri de
       caractere nevide. Astfel, de exemplu, avand in vedere <?>irul
       ,,aaa;;bbb,", apelurile succesive la strtok() care specifica <?>irul
       delimitator ,,;," ar returna <?>irurile ,,aaa" <?>i ,,bbb", iar apoi un
       indicator nul.

       Func<?>ia strtok_r() este o versiune reentranta a strtok(). Argumentul
       saveptr este un indicator catre o variabila char * care este utilizata
       intern de strtok_r() pentru a men<?>ine contextul intre apelurile
       succesive care analizeaza acela<?>i <?>ir de caractere.

       La primul apel la strtok_r(), str trebuie sa indice <?>irul de
       caractere care urmeaza sa fie analizat, iar valoarea lui *saveptr este
       ignorata (dar a se vedea sec<?>iunea VERSIUNI). In apelurile
       ulterioare, str ar trebui sa fie NULL, iar saveptr (<?>i memoria tampon
       catre care acesta indica) ar trebui sa fie neschimbata de la apelul
       anterior.

       Diferite <?>iruri de caractere pot fi analizate concomitent folosind
       secven<?>e de apeluri la strtok_r() care specifica diferite argumente
       saveptr.

VALOAREA RETURNATA
       Func<?>iile strtok() <?>i strtok_r() returneaza un indicator catre
       urmatorul simbol, sau NULL daca nu mai exista simboluri.

ATRIBUTE
       Pentru o explica<?>ie a termenilor folosi<?>i in aceasta sec<?>iune, a
       se vedea attributes(7).

       +------------------------+---------------------+-----------------------+
       |Interfa<?>a             | Atribut             | Valoare               |
       +------------------------+---------------------+-----------------------+
       |strtok()                | Siguran<?>a firelor | MT-Unsafe race:strtok |
       +------------------------+---------------------+-----------------------+
       |strtok_r()              | Siguran<?>a firelor | MT-Safe               |
       +------------------------+---------------------+-----------------------+
VERSIUNI
       In unele implementari, *saveptr trebuie sa fie NULL la primul apel la
       strtok_r() care este utilizat pentru a analiza str.

STANDARDE
       strtok()
              C11, POSIX.1-2008.

       strtok_r()
              POSIX.1-2008.

ISTORIC
       strtok()
              POSIX.1-2001, C89, SVr4, 4.3BSD.

       strtok_r()
              POSIX.1-2001.

ERORI
       Fi<?>i precaut atunci cand utiliza<?>i aceste func<?>ii. Daca le
       utiliza<?>i, re<?>ine<?>i ca:

       o  Aceste func<?>ii modifica primul lor argument.

       o  Aceste func<?>ii nu pot fi utilizate pe <?>iruri constante.

       o  Identitatea octetului de delimitare este pierduta.

       o  Func<?>ia strtok() utilizeaza o memorie tampon statica in timpul
          analizei, deci nu este sigura pentru fire. Utiliza<?>i strtok_r()
          daca acest lucru este important pentru dumneavoastra.

EXEMPLE
       Programul de mai jos folose<?>te bucle imbricate care utilizeaza
       strtok_r() pentru a impar<?>i un <?>ir de caractere intr-o ierarhie de
       simboluri pe doua niveluri. Primul argument din linia de comanda
       specifica <?>irul de caractere care urmeaza sa fie analizat. Al doilea
       argument specifica octetul (octe<?>ii) delimitator(i) care urmeaza sa
       fie utiliza<?>i pentru a separa <?>irul in simboluri ,,majore". Al
       treilea argument specifica octetul (octe<?>ii) delimitator(i) care
       trebuie utiliza<?>i pentru a separa simbolurile ,,majore" in
       sub-simboluri.

       Un exemplu de ie<?>ire produsa de acest program este urmatorul:

           $ ./a.out 'a/bbb///cc;xxx:yyy:' ':;' '/'
           1: a/bbb///cc
                    --> a
                    --> bbb
                    --> cc
           2: xxx
                    --> xxx
           3: yyy
                    --> yyy

   Sursa programului
       #include <stdio.h>
       #include <stdlib.h>
       #include <string.h>

       int
       main(int argc, char *argv[])
       {
           char *str1, *str2, *token, *subtoken;
           char *saveptr1, *saveptr2;
           int j;

           if (argc != 4) {
               fprintf(stderr, "Utilizare: %s <?>ir delimitator sub-delimitator\n",
                       argv[0]);
               exit(EXIT_FAILURE);
           }

           for (j = 1, str1 = argv[1]; ; j++, str1 = NULL) {
               token = strtok_r(str1, argv[2], &saveptr1);
               if (token == NULL)
                   break;
               printf("%d: %s\n", j, simbol);

               for (str2 = token; ; str2 = NULL) {
                   subtoken = strtok_r(str2, argv[3], &saveptr2);
                   if (subtoken == NULL)
                       break;
                   printf("\t --> %s\n", sub-simbo);
               }
           }

           exit(EXIT_SUCCESS);
       }

       Un alt exemplu de program care utilizeaza strtok() poate fi gasit in
       getaddrinfo_a(3).

CONSULTA<?>I <?>I
       memchr(3), strchr(3), string(3), strpbrk(3), strsep(3), strspn(3),
       strstr(3), wcstok(3)

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>.

Pagini de manual de Linux 6.15    17 mai 2025                        strtok(3)