Функция библиотеки C -newlocale()
Стандартная библиотека C - <locale.h>
Описание
newlocale()является функцией в стандартной библиотеке C, используемой для создания нового объекта локали. Эта функция позволяет программе создавать конкретную настройку локали и может быть изменена или расширена на основе существующей локали.
Объявление
Ниже приведено объявление функции newlocale().
#include <locale.h> locale_t newlocale(int category_mask, const char *locale, locale_t base);
Параметр
-
category_mask: Маска одной или нескольких категорий локали для установки. Это может быть комбинация следующих макросов (с помощью побитового оператора OR|Комбинация):LC_COLLATE_MASK: Информация о локализации, относящаяся к сравнению строк.LC_CTYPE_MASKИнформация о локализации, относящаяся к классификации и преобразованию символов.LC_MONETARY_MASK: Информация о локализации, относящаяся к формату валюты.LC_NUMERIC_MASK: Информация о локализации, относящаяся к числовому формату.LC_TIME_MASK: Информация о локализации, относящаяся к формату времени.LC_MESSAGES_MASK: Информация о локализации, относящаяся к отображению сообщений.LC_ALL_MASKВсе категории локализации.
-
locale: Строка, задающая имя локали для установки (например, "en_US.UTF-8"). Если онаNULLто используется локаль по умолчанию. -
base: существующийlocale_tобъект, используемый в качестве основы для создания нового объекта локали. Если онNULLто новый объект создаётся с нуля.
Возвращаемое значение
- При успехе возвращает только что созданный объект локали (тип
locale_t)。 - При ошибке возвращает
NULL。
Пример
Ниже приведён пример кода для создания и использования нового объекта локали с помощью newlocale():
Пример
#include <locale.h>
#include <xlocale.h> // Требуется при использовании расширений GNU
int main() {
// Создать новый объект локали, используя настройку локали "en_US.UTF-8"
locale_t newloc = newlocale(LC_ALL_MASK, "en_US.UTF-8", (locale_t)0);
if (newloc == (locale_t)0) {
perror("newlocale");
return 1;
}
// Установить объект локали текущего потока в новый объект локали
locale_t oldloc = uselocale(newloc);
// Получить и вывести информацию о текущей локали
struct lconv *lc = localeconv();
printf("Символ десятичной точки в новой локали: %s\n", lc->decimal_point);
printf("Разделитель тысяч в новой локали: %s\n", lc->thousands_sep);
// Восстановить предыдущий объект локали
uselocale(oldloc);
// Освободить новый объект локали
freelocale(newloc);
return 0;
}
Давайте скомпилируем и запустим приведённую выше программу, которая выдаст следующий результат:
Decimal point character in new locale: . Thousands separator in new locale: ,
Пояснение кода
Создать новый объект локали
newlocale(LC_ALL_MASK, "en_US.UTF-8", NULL): Создать новый объект локали, используя локаль "en_US.UTF-8", на основе объекта локали по умолчанию.newlocale(LC_NUMERIC_MASK | LC_TIME_MASK, "fr_FR.UTF-8", NULL): Создать новый объект локали, установив числовой и временной форматы в "fr_FR.UTF-8" (французский — Франция), а для других категорий использовать настройки по умолчанию.
Установить объект локали потока
- Использование
uselocale(newloc)Установить объект локали текущего потока в только что созданный объект локали. - Использование
uselocale(oldloc)Восстановить предыдущий объект локали.
Освобождает объект локализации
- Использование
freelocale(newloc)Освободите только что созданный объект локали, чтобы избежать утечек памяти.
Примечания
newlocale()является частью стандарта POSIX.1-2008 и поддерживается не на всех платформах. Если вы используете библиотеку GNU C, обязательно включите<xlocale.h>Заголовочный файл.newlocale()возвращённыйlocale_tОбъект можно передать вuselocale()функцию, чтобы временно использовать другую локаль в потоке.
Итог
newlocale()функция позволяет создавать и использовать новые объекты локали, чтобы программы могли обрабатывать различные настройки локали и потребности локализации. Комбинируяnewlocale()、uselocale()иfreelocale()С помощью этой функции программисты могут более гибко управлять информацией о локализации программы и переключать её, тем самым поддерживая разработку интернационализированных приложений.