Linux Man на русском

  User    Syst    Libr    Device    Files    Other    Admin  



   uselocale - задаёт/получает локаль для вызывающей нити

uselocale(3) задаёт/получает локаль для вызывающей нити


ОБЗОР

#include <locale.h>
locale_t uselocale(locale_t newloc);

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

uselocale():


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


ОПИСАНИЕ

Функция uselocale() задаёт текущую локаль в вызвавшей нити и возвращает использовавшуюся локаль в этой нити ранее. После успешного выполнения uselocale() любые выполняемые нитью вызовы функций, зависящие от локали, будут работать с учётом установленной локали newloc.

В аргументе newloc можно указать одно из следующих значений:


Обработчик, полученный от вызовов newlocale(3) или duplocale(3) Текущая локаль вызвавшей нити будет равна указанной локали.
Специальный обработчик объекта локали LC_GLOBAL_LOCALE Текущая локаль вызвавшей нити будет равна глобальной локали, установленной setlocale(3).
(locale_t) 0 Текущая локаль вызвавшей нити останется неизменной (и текущая локаль возвращается как результат работы функции).


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

При успешном выполнении uselocale() возвращает обработчик локали, который был установлен предыдущим вызовом uselocale() в этой нити или LC_GLOBAL_HANDLE, если это первый вызов. При ошибке возвращается (locale_t) 0, а errno присваивается код ошибки.


ОШИБКИ

EINVAL Значение newloc не указывает на допустимый объект локали.

ВЕРСИИ

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


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

POSIX.1-2008.


ЗАМЕЧАНИЯ

В отличие от setlocale(3), uselocale() не позволяет выборочно указывать отдельные категории локали. Для задания локали, которая отличается только отдельными категориями от текущей локали, используйте вызов duplocale(3) и newlocale(3) для получения эквивалента объекта локали для текущей локали и измените желаемые категории в этом объекте.


ПРИМЕР

Смотрите newlocale(3) и duplocale(3).