duplocale(3) | Library Functions Manual | duplocale(3) |
НАИМЕНОВАНИЕ
duplocale - создаёт копию объекта локали
БИБЛИОТЕКА
Стандартная библиотека языка C (libc, -lc)
ОБЗОР
#include <locale.h>
locale_t duplocale(locale_t locobj);
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 или более поздней) в отношении авторского права, но БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ.
Если вы обнаружите какие-либо ошибки в переводе этой страницы руководства, пожалуйста, сообщите об этом разработчику(ам) по его(их) адресу(ам) электронной почты или по адресу списка рассылки русских переводчиков.
15 июня 2024 г. | Справочные страницы Linux 6.9.1 |