strcmp(3)                  Library Functions Manual                  strcmp(3)

NUME
       strcmp, strncmp - compara doua <?>iruri

BIBLIOTECA
       Biblioteca C standard (libc, -lc)

REZUMAT
       #include <string.h>

       int strcmp(const char *s1, const char *s2);
       int strncmp(const char s1[.n], const char s2[.n], size_t n);

DESCRIERE
       Func<?>ia strcmp() compara cele doua <?>iruri s1 <?>i s2. Nu se ia in
       considerare loca<?>ia (pentru o compara<?>ie care <?>ine cont de
       loca<?>ie, a se vedea strcoll(3)). Compara<?>ia se face folosind
       caractere fara semn.

       strcmp() returneaza un numar intreg care indica rezultatul
       compara<?>iei, dupa cum urmeaza:

       o  0, in cazul in care s1 <?>i s2 sunt egale;

       o  o valoare negativa daca s1 este mai mic decat s2;

       o  o valoare pozitiva daca s1 este mai mare decat s2.

       Func<?>ia strncmp() este similara, cu excep<?>ia faptului ca aceasta
       compara numai primii (cel mult) n octe<?>i din s1 <?>i s2.

VALOAREA RETURNATA
       Func<?>iile strcmp() <?>i strncmp() returneaza un numar intreg mai mic,
       egal sau mai mare decat zero daca se constata ca s1 (sau primii n
       octe<?>i ai acestuia) este mai mic decat, se potrive<?>te sau este mai
       mare decat s2.

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

       +--------------------------------------+---------------------+---------+
       |Interfa<?>a                           | Atribut             | Valoare |
       +--------------------------------------+---------------------+---------+
       |strcmp(), strncmp()                   | Siguran<?>a firelor | MT-Safe |
       +--------------------------------------+---------------------+---------+
VERSIUNI
       POSIX.1 specifica doar ca:

              Semnul unei valori de returnare diferita de zero este determinat
              de semnul diferen<?>ei dintre valorile primei perechi de
              octe<?>i (ambele interpretate ca fiind de tip unsigned char)
              care difera in <?>irurile comparate.

       In glibc, ca <?>i in majoritatea celorlalte implementari, valoarea de
       returnare este rezultatul aritmetic al scaderii ultimului octet
       comparat din s2 din ultimul octet comparat din s1; (daca cele doua
       caractere sunt egale, aceasta diferen<?>a este 0).

STANDARDE
       C11, POSIX.1-2008.

ISTORIC
       POSIX.1-2001, C89, SVr4, 4.3BSD.

EXEMPLE
       Programul de mai jos poate fi utilizat pentru a demonstra
       func<?>ionarea lui strcmp() (atunci cand i se dau doua argumente) <?>i
       strncmp() (atunci cand i se dau trei argumente). Mai intai, cateva
       exemple care utilizeaza strcmp():

           $ ./string_comp ABC ABC
           <str1> <?>i <str2> sunt egale
           $ ./string_comp ABC AB      # codul ASCII de 'C' este 67; 'C' - '\0' = 67
           <str1> este mai mare decat <str2> (67)
           $ ./string_comp ABA ABZ     # codul ASCII de 'A' este 65; codul ASCII de 'Z' este 90
           <str1> este mai mic decat <str2> (-25)
           $ ./string_comp ABJ ABC
           <str1> este mai mare decat <str2> (7)
           $ ./string_comp $'\201' A   # 0201 - 0101 = 0100 (sau 64 zecimal)
           <str1> este mai mare decat <str2> (64)

       Ultimul exemplu utilizeaza o sintaxa specifica bash(1) pentru a produce
       un <?>ir care con<?>ine un cod ASCII pe 8 bi<?>i; rezultatul
       demonstreaza ca aceasta comparare a <?>irurilor utilizeaza caractere
       fara semn.

       <?>i apoi cateva exemple folosind strncmp():

           $ ./string_comp ABC AB 3
           <str1> este mai mare decat <str2> (67)
           $ ./string_comp ABC AB 2
           <str1> <?>i <str2> sunt egale in primii 2 octe<?>i

   Sursa programului
       /* string_comp.c

          Licen<?>iat sub licen<?>a publica generala GNU v2 sau o versiune ulterioara.
       */
       #include <stdio.h>
       #include <stdlib.h>
       #include <string.h>

       int
       main(int argc, char *argv[])
       {
           int res;

           if (argc < 3) {
               fprintf(stderr, "Utilizare: %s <str1> <str2> [<len>]\n", argv[0]);
               exit(EXIT_FAILURE);
           }

           if (argc == 3)
               res = strcmp(argv[1], argv[2]);
           else
               res = strncmp(argv[1], argv[2], atoi(argv[3]));

           if (res == 0) {
               printf("<str1> <?>i <str2> sunt egale");
               if (argc > 3)
                   printf(" in primii %d octe<?>i\n", atoi(argv[3]));
               printf("\n");
           } else if (res < 0) {
               printf("<str1> este mai mic decat <str2> (%d)\n", res);
           } else {
               printf("<str1> este mai mare decat <str2> (%d)\n", res);
           }

           exit(EXIT_SUCCESS);
       }

CONSULTA<?>I <?>I
       memcmp(3), strcasecmp(3), strcoll(3), string(3), strncasecmp(3),
       strverscmp(3), wcscmp(3), wcsncmp(3), ascii(7)

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.06 31 octombrie 2023                     strcmp(3)