Функции библиотеки C -uselocale()

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

Описание

uselocale()Это функция в стандартной библиотеке C, используемая для установки или получения текущего объекта локали потока. Эта функция позволяет программам использовать разные настройки локали в разных потоках, тем самым поддерживая локализацию в многопоточной среде.

Объявление

Ниже приведено объявление функции uselocale().

#include <locale.h>

locale_t uselocale(locale_t newloc);

Параметр

  • newloc: объект, устанавливаемый в качестве объекта локали текущего потока.locale_tОбъект.
    • Если он равенLC_GLOBAL_LOCALE, то используйте глобальную локаль.
    • Если он равенNULL, то текущий объект локали не изменяется, и возвращается только текущий объект локали.
    • Другой допустимыйlocale_tОбъект будет установлен в качестве объекта локали текущего потока.

Возвращаемое значение

  • В случае успеха вернуть предыдущийlocale_tОбъект (объект локали текущего потока).
  • При ошибке возвращаетLC_GLOBAL_LOCALEи установить соответствующий код ошибки.

Пример

В следующем примере показано, как использовать freelocale() для освобождения объекта локали, созданного 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;
    }

    // Получить и вывести информацию о текущей локали
    struct lconv *lc = localeconv();
    printf("Десятичная точка локали по умолчанию: %s\n", lc->decimal_point);
    printf("Разделитель тысяч локали по умолчанию: %s\n", lc->thousands_sep);

    // Установить объект локали текущего потока в новый объект локали
    locale_t oldloc = uselocale(newloc);

    // Получить и вывести новую информацию о локализации
    lc = localeconv();
    printf("Десятичная точка новой локали: %s\n", lc->decimal_point);
    printf("Разделитель тысяч новой локали: %s\n", lc->thousands_sep);

    // Восстановить предыдущий объект локали
    uselocale(oldloc);

    // Получить и вывести восстановленную информацию о локализации
    lc = localeconv();
    printf("Десятичная точка восстановленной локали: %s\n", lc->decimal_point);
    printf("Восстановленный разделитель тысяч локали: %s\n", lc->thousands_sep);

    // Освободить новый объект локали
    freelocale(newloc);

    return 0;
}

Давайте скомпилируем и запустим приведённую выше программу, которая выдаст следующий результат:

Default locale decimal point: .
Default locale thousands separator: 
New locale decimal point: .
New locale thousands separator: ,
Restored locale decimal point: .
Restored locale thousands separator: 

Пояснение кода

  1. Создать новый объект локали:

    • Использованиеnewlocale(LC_ALL_MASK, "en_US.UTF-8", (locale_t)0)Создайте новый объект локали, установив локаль в "en_US.UTF-8".
  2. Выведите информацию о локали по умолчанию:

    • Использованиеlocaleconv()Получите и выведите текущую информацию о локали по умолчанию, например, символ десятичной точки и разделитель тысяч.
  3. Установить объект локали потока:

    • Использованиеuselocale(newloc)Установите объект локали текущего потока равным только что созданному объекту локали и сохраните предыдущий объект локали.
  4. Выведите информацию о новой локали:

    • Использованиеlocaleconv()Получите и выведите информацию о новой локали, чтобы проверить, успешно ли прошло переключение.
  5. Восстановите предыдущий объект локали:

    • Использованиеuselocale(oldloc)Восстановить предыдущий объект локали.
  6. Освободите объект локали:

    • Использованиеfreelocale(newloc)Освободите только что созданный объект локали, чтобы предотвратить утечки памяти.

Примечания

  • uselocale()Функция является частью стандарта POSIX.1-2008; убедитесь, что ваша платформа поддерживает эту функцию.
  • При использовании в многопоточной средеuselocale()Вы можете задать независимый объект локали для каждого потока, но помните о согласованности данных и состояниях гонки между потоками.
  • Использованиеfreelocale()Освобождайте объекты локали, которые больше не нужны, чтобы избежать утечек памяти.

Итог

uselocale()Функция позволяет задавать и получать объект локали текущего потока, тем самым обеспечивая поддержку локализации в многопоточных средах. Комбинируя использованиеnewlocale()、uselocale()иfreelocale()функции, программисты могут гибко управлять настройками локали программы и переключать их, обеспечивая независимую поддержку локали для разных потоков.

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

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