setlocale

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

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

Параметры

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

указатель на строку с узким нуль-терминированным идентификатором локали C после применения изменений, если таковые имели место, или null-указатель при ошибке.

Копия возвращённой строки вместе с категорией, используемой в этом вызове 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 <stdio.h>
#include <locale.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秒

Ссылки

• Стандарт 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

См. также