ИМЯ¶

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

СИНТАКСИС¶

#include <locale.h>

locale_t duplocale(locale_t locobj);

duplocale():

ОПИСАНИЕ¶

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

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

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

При успешном выполнении duplocale() возвращает описатель нового объекта локали. При ошибке возвращается (locale_t) 0, а errno присваивается код ошибки.

ОШИБКИ¶

ENOMEM

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

ВЕРСИИ¶

Функция duplocale() впервые появилась в версии 2.3 библиотеки GNU C.

СООТВЕТСТВИЕ СТАНДАРТАМ¶

POSIX.1-2008.

ЗАМЕЧАНИЯ¶

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

• Для создания копии объекта локали, в которой одна или более категорий будут изменены (с помощью 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 <stdio.h>
#include <stdlib.h>
#include <locale.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, "Использование: %s строка\n", argv[0]);


        exit(EXIT_FAILURE);


    }


    /* Эта последовательность необходима, так как uselocale() может


       вернуть значение LC_GLOBAL_LOCALE, которое нельзя


       передавать как аргумент в 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)

ЗАМЕЧАНИЯ¶

Эта страница является частью проекта Linux man-pages версии 5.10. Описание проекта, информацию об ошибках и последнюю версию этой страницы можно найти по адресу https://www.kernel.org/doc/man-pages/.

ПЕРЕВОД¶

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

Этот перевод является бесплатной документацией; прочитайте Стандартную общественную лицензию GNU версии 3 или более позднюю, чтобы узнать об условиях авторского права. Мы не несем НИКАКОЙ ОТВЕТСТВЕННОСТИ.

Если вы обнаружите ошибки в переводе этой страницы руководства, пожалуйста, отправьте электронное письмо на man-pages-ru-talks@lists.sourceforge.net.