duplocale(3)               Library Functions Manual               duplocale(3)

NUME
       duplocale - duplica un obiect de configura<?>ie regionala

BIBLIOTECA
       Biblioteca C standard (libc, -lc)

SINOPSIS
       #include <locale.h>

       locale_t duplocale(locale_t locobj);

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

       duplocale():
           Incepand cu glibc 2.10
               _XOPEN_SOURCE >= 700
           Inainte de glibc 2.10:
               _GNU_SOURCE

DESCRIERE
       Func<?>ia duplocale() creeaza un duplicat al obiectului parametrului
       regional la care se face referire prin locobj.

       Daca locobj este LC_GLOBAL_LOCALE, duplocale() creeaza un obiect de
       configura<?>ie regionala care con<?>ine o copie a parametrului regional
       global determinat de setlocale(3).

VALOAREA RETURNATA
       In caz de succes, duplocale() returneaza un gestionar pentru noul
       obiect de configura<?>ie regionala. In caz de eroare, returneaza
       (locale_t) 0 <?>i configureaza errno pentru a indica eroarea.

ERORI-IE<?>IRE
       ENOMEM Memorie insuficienta pentru a crea obiectul de configura<?>ie
              regionala duplicat.

STANDARDE
       POSIX.1-2008.

ISTORIC
       glibc 2.3.

NOTE
       Duplicarea unei configura<?>ii regionale poate servi urmatoarelor
       scopuri:

       o  Pentru a crea o copie a unui obiect configura<?>ie regionala in care
          una sau mai multe categorii urmeaza sa fie modificate (utilizand
          newlocale(3)).

       o  Pentru a ob<?>ine un gestionar pentru configura<?>ia regionala
          curenta, care poate fi utilizat in alte func<?>ii care utilizeaza un
          gestionar de configura<?>ie regionala, cum ar fi toupper_l(3). Acest
          lucru se face prin aplicarea duplocale() la valoarea returnata de
          urmatorul apel:

              loc = uselocale((locale_t) 0);

          Aceasta tehnica este necesara, deoarece apelul uselocale(3) de mai
          sus poate returna valoarea LC_GLOBAL_LOCALE, ceea ce duce la un
          comportament nedefinit daca este transmis unor func<?>ii precum
          toupper_l(3). Apelul duplocale() poate fi utilizat pentru a se
          asigura ca valoarea LC_GLOBAL_LOCALE este convertita intr-un obiect
          de configura<?>ie regionala utilizabil. A se vedea sec<?>iunea
          EXEMPLE, de mai jos.

       Fiecare obiect de configura<?>ie regionala creat de duplocale() trebuie
       sa fie eliberat cu ajutorul freelocale(3).

EXEMPLE
       Programul de mai jos utilizeaza uselocale(3) <?>i duplocale() pentru a
       ob<?>ine un gestionar pentru parametrul regional curent, care este apoi
       transmis la toupper_l(3). Programul prime<?>te un argument de linie de
       comanda, un <?>ir de caractere care este convertit in majuscule <?>i
       afi<?>at la ie<?>irea standard. Un exemplu de utilizare a acestui
       program este urmatorul:

           $ ./a.out abc;
           ABC

   Sursa programului
       #define _XOPEN_SOURCE 700
       #include <ctype.h>

       #include <err.h>
       #include <locale.h>
       #include <stdio.h>
       #include <stdlib.h>

       int
       main(int argc, char *argv[])
       {
           locale_t loc, nloc;

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

           /* Aceasta secven<?>a este necesara, deoarece uselocale() ar putea
              returna valoarea LC_GLOBAL_LOCALE, care nu poate fi transmisa
              ca argument pentru toupper_l(). */*/

           loc = uselocale((locale_t) 0);
           if (loc == (locale_t) 0)
               err(EXIT_FAILURE, "uselocale");

           nloc = duplocale(loc);
           if (nloc == (locale_t) 0)
               err(EXIT_FAILURE, "duplocale");

           for (char *p = argv[1]; *p; p++)
               putchar(toupper_l(*p, nloc));

           printf("\n");

           freelocale(nloc);

           exit(EXIT_SUCCESS);
       }

CONSULTA<?>I <?>I
       freelocale(3), newlocale(3), setlocale(3), uselocale(3), locale(5),
       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.18 8 februarie 2026                   duplocale(3)