Функция библиотеки 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 <stdio.h>
#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()С помощью этой функции программисты могут более гибко управлять информацией о локализации программы и переключать её, тем самым поддерживая разработку интернационализированных приложений.

Стандартная библиотека C - <locale.h>

Другие расширения