std::setlocale

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

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

Параметры

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

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

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

Примечания

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

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

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

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

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

Пример

#include <clocale>
#include <cstdio>
#include <ctime>
#include <cwchar>
#include <iterator>
#include <string>

int main()
{
    // Make a "deep copy" of current locale name.
    std::string prev_loc = std::setlocale(LC_ALL, nullptr);

    // The C locale will be UTF-8 enabled English,
    // decimal dot will be German,
    // date and time formatting will be Japanese.
    if (const char* loc = std::setlocale(LC_ALL, "en_US.UTF-8"))
        std::wprintf(L"New LC_ALL locale: %s\n", loc);
    if (const char* loc = std::setlocale(LC_NUMERIC, "de_DE.UTF-8"))
        std::wprintf(L"New LC_NUMERIC locale: %s\n", loc);
    if (const char* loc = std::setlocale(LC_TIME, "ja_JP.UTF-8"))
        std::wprintf(L"New LC_TIME locale: %s\n", loc);

    wchar_t buf[100];
    std::time_t t = std::time(nullptr);
    std::wcsftime(buf, std::size(buf), L"%A %c", std::localtime(&t));
    std::wprintf(L"Number: %.2f\nDate: %Ls\n", 3.14, buf);

    // Restore the previous locale.
    if (const char* loc = std::setlocale(LC_ALL, prev_loc.c_str()))
        std::wprintf(L"Restorred LC_ALL locale: %s\n", loc);
}

New LC_ALL locale: en_US.UTF-8
New LC_NUMERIC locale: de_DE.UTF-8
New LC_TIME locale: ja_JP.UTF-8
Number: 3,14
Date: 日曜日 2022年11月06日 20時40分59秒
Restorred LC_ALL locale: C

См. также

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