setlocale(3)               Library Functions Manual               setlocale(3)

NUME
       setlocale - define<?>te parametrii regionali curen<?>i

BIBLIOTECA
       Biblioteca C standard (libc, -lc)

SINOPSIS
       #include <locale.h>

       char *setlocale(int category, const char *locale);

DESCRIERE
       Func<?>ia setlocale()  este utilizata pentru a defini sau interoga
       parametrii regionali curen<?>i ai programului.

       Daca locale nu este NULL, parametrii regionali curen<?>i ai programului
       sunt modifica<?>i in func<?>ie de argumente. Argumentul category
       determina care par<?>i ai configura<?>iei regionale curente a
       programului trebuie modificate.

       Categorie           Parametri modifica<?>i
       LC_ALL              To<?>i parametrii regionali
       LC_ADDRESS          Formatarea adreselor <?>i a elementelor legate de
                           geografie (*)
       LC_COLLATE          Ordinea de sortare a <?>irurilor de caractere
       LC_CTYPE            Clasificarea caracterelor
       LC_IDENTIFICATION   Metadate care descriu parametrii regionali (locale)
                           (*)
       LC_MEASUREMENT      Parametri referitori la masuratori (sistemul metric
                           fa<?>a de sistemul american) (*)
       LC_MESSAGES         Mesaje traduse in limba din regiunea curenta
       LC_MONETARY         Formatarea valorilor monetare
       LC_NAME             Formatarea formulelor de salut pentru persoane (*)
       LC_NUMERIC          Formatarea valorilor numerice nemonetare
       LC_PAPER            Parametri referitori la dimensiunea standard a
                           hartiei (*)
       LC_TELEPHONE        Formate care trebuie utilizate cu serviciile
                           telefonice (*)
       LC_TIME             Formatarea valorilor de data <?>i ora

       Categoriile marcate cu asterisc in tabelul de mai sus sunt extensii
       GNU. Pentru mai multe informa<?>ii despre aceste categorii regionale,
       consulta<?>i locale(7).

       Argumentul locale este un indicator catre un <?>ir de caractere care
       con<?>ine configurarea necesara pentru categorie.  Un astfel de <?>ir
       este fie o constanta binecunoscuta, cum ar fi ,,C" sau ,,ro_RO" (vezi
       mai jos), fie un <?>ir opac care a fost returnat de o alta apelare a
       setlocale().

       Daca locale este un <?>ir gol, "", fiecare parte a parametrilor
       regionali care trebuie modificata este configurata in conformitate cu
       variabilele de mediu. Detaliile depind de implementare.  Pentru glibc,
       mai intai (indiferent de categorie), este verificata variabila de mediu
       LC_ALL, apoi variabila de mediu cu acela<?>i nume ca <?>i categoria
       (vezi tabelul de mai sus) <?>i, in final, variabila de mediu LANG. Este
       utilizata prima variabila de mediu existenta. Daca valoarea acesteia nu
       este o specifica<?>ie de parametri regionali valida, configura<?>ia
       regionala ramane neschimbata, iar setlocale() returneaza NULL.

       Parametrul regional "C" sau "POSIX" este un parametru regional
       portabil; acesta exista pe toate sistemele conforme.

       Un nume de parametru regional are de obicei forma limba
       [_teritoriu][.codificarea][@modificator], unde limba este un cod de
       limba ISO 639, teritoriu este un cod de <?>ara ISO 3166, iar
       codificarea este un set de caractere sau un identificator de
       codificare, cum ar fi ISO-8859-1 sau UTF-8. Pentru o lista a tuturor
       parametrilor regionali accepta<?>i, incerca<?>i <<locale -a>>
       (consulta<?>i locale(1)).

       Daca locale este NULL, configura<?>ia regionala curenta este doar
       interogata, nu modificata.

       La pornirea programului principal, valoarea parametrului regional
       portabil "C" este selectata ca implicita. Un program poate fi facut
       portabil pentru toate configura<?>iile regionale prin apelarea:

           setlocale(LC_ALL, "");

       dupa ini<?>ializarea programului, <?>i apoi:

       o  utilizand valorile returnate de o apelare localeconv(3) pentru
          informa<?>ii dependente de parametrii regionali;

       o  utilizarea func<?>iilor multi-octet <?>i caractere late pentru
          procesarea textului daca MB_CUR_MAX > 1;

       o  utilizarea strcoll(3)  <?>i strxfrm(3)  pentru compararea
          <?>irurilor de caractere; <?>i

       o  utilizarea wcscoll(3)  <?>i wcsxfrm(3)  pentru a compara <?>iruri de
          caractere late.

VALOAREA RETURNATA
       O apelare reu<?>ita a setlocale()  returneaza un <?>ir opac care
       corespunde parametrilor regionali. Acest <?>ir poate fi alocat in
       memoria statica. <?>irul returnat este astfel incat o apelare
       ulterioara cu acel <?>ir <?>i categoria asociata va restabili acea
       parte a procesului corespondenta parametrilor regionali. Valoarea
       returnata este NULL daca cererea nu poate fi onorata.

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

       +-------------------+---------------------+----------------------------+
       |Interfa<?>a        | Atribut             | Valoare                    |
       +-------------------+---------------------+----------------------------+
       |setlocale()        | Siguran<?>a firelor | MT-Unsafe const:locale env |
       +-------------------+---------------------+----------------------------+
STANDARDE
       C11, POSIX.1-2008.

   Categorii
       LC_ALL
       LC_COLLATE
       LC_CTYPE
       LC_MONETARY
       LC_NUMERIC
       LC_TIME
              C11, POSIX.1-2008.

       LC_MESSAGES
              POSIX.1-2008.

       Altele:
              GNU.

ISTORIC
       POSIX.1-2001, C89.

   Categorii
       LC_ALL
       LC_COLLATE
       LC_CTYPE
       LC_MONETARY
       LC_NUMERIC
       LC_TIME
              C89, POSIX.1-2001.

       LC_MESSAGES
              POSIX.1-2001.

       Altele:
              GNU.

CONSULTA<?>I <?>I
       locale(1), localedef(1), isalpha(3), localeconv(3), nl_langinfo(3),
       rpmatch(3), strcoll(3), strftime(3), charsets(7), locale(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.15    17 mai 2025                     setlocale(3)