НАИМЕНОВАНИЕ

       duplocale - создаёт копию объекта локали

БИБЛИОТЕКА

       Стандартная библиотека языка C (libc, -lc)

ОБЗОР

       #include <locale.h>

       locale_t duplocale(locale_t locobj);

   Требования макроса тестирования свойств для glibc (см. feature_test_macros(7)):

       duplocale():
           Начиная с glibc 2.10:
               _XOPEN_SOURCE >= 700
           До glibc 2.10:
               _GNU_SOURCE

ОПИСАНИЕ

       Функция duplocale() создаёт копию объекта локали, на которую указывает locobj.

       Если  значение  locobj  равно  LC_GLOBAL_LOCALE,  то  duplocale() создаёт объект локали, содержащий копию
       глобальной локали, задаваемой setlocale(3).

ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ

       On success, duplocale()  returns a handle for the new locale object.  On error, it returns  (locale_t) 0,
       and sets errno to indicate the error.

ОШИБКИ

       ENOMEM Недостаточно памяти для создания копии объекта локали.

СТАНДАРТЫ

       POSIX.1-2008.

ИСТОРИЯ

       glibc 2.3.

ПРИМЕЧАНИЯ

       Создание копии локали может пригодиться в следующих случаях:

       •  Для  создания  копии  объекта  локали,  в  которой  одна или более категорий будут изменены (с помощью
          newlocale(3)).

       •  Для получения описателя текущей локали, который может использоваться  в  других  функциях,  таких  как
          toupper_l(3). Для этого duplocale() передаётся значение, полученное от следующего вызова:

              loc = uselocale((locale_t) 0);

          This   technique   is   necessary,   because  the  above  uselocale(3)   call  may  return  the  value
          LC_GLOBAL_LOCALE, which results in undefined behavior if passed to  functions  such  as  toupper_l(3).
          Calling  duplocale()  can be used to ensure that the LC_GLOBAL_LOCALE value is converted into a usable
          locale object.  See EXAMPLES, below.

       Каждый объект локали, созданный duplocale(), должен освобождаться с помощью freelocale(3).

ПРИМЕРЫ

       Представленная ниже программа использует uselocale(3)  и  duplocale()  для  получения  описателя  текущей
       локали,  который  затем  передаётся  в toupper_l(3). Программа распознаёт один аргумент командной строки,
       строку символов, которая  приводится  к  верхнему  регистру  и  выводится  в  стандартный  вывод.  Пример
       использования:

           $ ./a.out abc
           ABC

   Исходный код программы

       #define _XOPEN_SOURCE 700
       #include <ctype.h>
       #include <locale.h>
       #include <stdio.h>
       #include <stdlib.h>

       #define errExit(msg)    do { perror(msg); exit(EXIT_FAILURE); \
                               } while (0)

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

           if (argc != 2) {
               fprintf(stderr, "Usage: %s string\n", argv[0]);
               exit(EXIT_FAILURE);
           }

           /* This sequence is necessary, because uselocale() might return
              the value LC_GLOBAL_LOCALE, which can't be passed as an
              argument to toupper_l(). */

           loc = uselocale((locale_t) 0);
           if (loc == (locale_t) 0)
               errExit("uselocale");

           nloc = duplocale(loc);
           if (nloc == (locale_t) 0)
               errExit("duplocale");

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

           printf("\n");

           freelocale(nloc);

           exit(EXIT_SUCCESS);
       }

СМОТРИТЕ ТАКЖЕ

       freelocale(3), newlocale(3), setlocale(3), uselocale(3), locale(5), locale(7)

ПЕРЕВОД

       Русский  перевод  этой  страницы  руководства разработал(и) Yuri Kozlov <yuray@komyakino.ru>, Иван Павлов
       <pavia00@gmail.com> и Kirill Rekhov <krekhov.dev@gmail.com>

       Этот перевод является свободной программной документацией; он распространяется на условиях  общедоступной
       лицензии  GNU  (GNU  General Public License - GPL, https://www.gnu.org/licenses/gpl-3.0.html версии 3 или
       более поздней) в отношении авторского права, но БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ.

       Если вы обнаружите какие-либо ошибки в переводе этой страницы руководства, пожалуйста, сообщите  об  этом
       разработчику(ам)   по   его(их)  адресу(ам)  электронной  почты  или  по  адресу  списка рассылки русских
       переводчиков.

Справочные страницы Linux 6.9.1                  15 июня 2024 г.                                    duplocale(3)