setlocale

char* setlocale( int category, const char* locale );

Функция setlocale устанавливает указанную системную локаль или её часть в качестве новой локали C. Изменения сохраняются и влияют на выполнение всех функций библиотеки C, зависящих от локали, до следующего вызова setlocale. Если locale — нулевой указатель, setlocale запрашивает текущую локаль C, не изменяя её.

Параметры

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

указатель на узкую строку с завершающим нулём, идентифицирующую локаль C после применения изменений, если они были, или нулевой указатель в случае ошибки.

Копию возвращённой строки вместе с категорией, использованной в этом вызове setlocale, можно позднее использовать в программе, чтобы восстановить локаль в состояние, в котором она находилась по завершении этого вызова.

Примечания

Во время запуска программы до выполнения пользовательского кода выполняется эквивалент setlocale(LC_ALL, "C");.

Хотя возвращаемый тип — char*, изменение символов, на которые указывает указатель, приводит к неопределённому поведению.

Поскольку setlocale изменяет глобальное состояние, влияющее на выполнение функций, зависящих от локали, вызов этой функции из одного потока во время выполнения другим потоком любой из следующих функций приводит к неопределённому поведению: fprintf, isprint, iswdigit, localeconv, tolower, fscanf, ispunct, iswgraph, mblen, toupper, isalnum, isspace, iswlower, mbstowcs, towlower, isalpha, isupper, iswprint, mbtowc, towupper, isblank, iswalnum, iswpunct, setlocale, wcscoll, iscntrl, iswalpha, iswspace, strcoll, wcstod, isdigit, iswblank, iswupper, strerror, wcstombs, isgraph, iswcntrl, iswxdigit, strtod, wcsxfrm, islower, iswctype, isxdigit.

POSIX также определяет локаль с именем "POSIX", которая всегда доступна и полностью эквивалентна минимальной локали "C", используемой по умолчанию.

POSIX также устанавливает, что последующие вызовы setlocale могут сделать недействительным возвращённый указатель, а не только содержимое строки, на которую он указывает.

Пример

#include <locale.h>
#include <stdio.h>
#include <time.h>
#include <wchar.h>
 
int main(void)
{
    // the C locale will be UTF-8 enabled English;
    // decimal dot will be German
    // date and time formatting will be Japanese
    setlocale(LC_ALL, "en_US.UTF-8");
    setlocale(LC_NUMERIC, "de_DE.utf8");
    setlocale(LC_TIME, "ja_JP.utf8");
 
    wchar_t str[100];
    time_t t = time(NULL);
    wcsftime(str, 100, L"%A %c", localtime(&t));
    wprintf(L"Number: %.2f\nDate: %ls\n", 3.14, str);
}

Number: 3,14
Date: 月曜日 2017年09月25日 13時00分15秒

Ссылки

• Стандарт C23 (ISO/IEC 9899:2024):
• 7.11.1.1 Функция setlocale (стр.: TBD)
• Стандарт C17 (ISO/IEC 9899:2018):
• 7.11.1.1 Функция setlocale (стр.: 163-164)
• Стандарт C11 (ISO/IEC 9899:2011):
• 7.11.1.1 Функция setlocale (стр.: 224-225)
• Стандарт C99 (ISO/IEC 9899:1999):
• 7.11.1.1 Функция setlocale (стр.: 205-206)
• Стандарт C89/C90 (ISO/IEC 9899:1990):
• 4.4.1.1 Функция setlocale

См. также

Внешние ссылки