Функции библиотеки 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 <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:
Пояснение кода
-
Создать новый объект локали:
- Использование
newlocale(LC_ALL_MASK, "en_US.UTF-8", (locale_t)0)Создайте новый объект локали, установив локаль в "en_US.UTF-8".
- Использование
-
Выведите информацию о локали по умолчанию:
- Использование
localeconv()Получите и выведите текущую информацию о локали по умолчанию, например, символ десятичной точки и разделитель тысяч.
- Использование
-
Установить объект локали потока:
- Использование
uselocale(newloc)Установите объект локали текущего потока равным только что созданному объекту локали и сохраните предыдущий объект локали.
- Использование
-
Выведите информацию о новой локали:
- Использование
localeconv()Получите и выведите информацию о новой локали, чтобы проверить, успешно ли прошло переключение.
- Использование
-
Восстановите предыдущий объект локали:
- Использование
uselocale(oldloc)Восстановить предыдущий объект локали.
- Использование
-
Освободите объект локали:
- Использование
freelocale(newloc)Освободите только что созданный объект локали, чтобы предотвратить утечки памяти.
- Использование
Примечания
uselocale()Функция является частью стандарта POSIX.1-2008; убедитесь, что ваша платформа поддерживает эту функцию.- При использовании в многопоточной среде
uselocale()Вы можете задать независимый объект локали для каждого потока, но помните о согласованности данных и состояниях гонки между потоками. - Использование
freelocale()Освобождайте объекты локали, которые больше не нужны, чтобы избежать утечек памяти.
Итог
uselocale()Функция позволяет задавать и получать объект локали текущего потока, тем самым обеспечивая поддержку локализации в многопоточных средах. Комбинируя использованиеnewlocale()、uselocale()иfreelocale()функции, программисты могут гибко управлять настройками локали программы и переключать их, обеспечивая независимую поддержку локали для разных потоков.