setlocale

 

C

コンパイラサポート

言語

ヘッダー

型サポート

プログラムユーティリティ

可変長引数関数のサポート

エラーハンドリング

動的メモリ管理

文字列ライブラリ

アルゴリズム

数値

日付と時刻のユーティリティ

入出力サポート

ローカライゼーションサポート

並行処理サポート (C11)

技術仕様

シンボルインデックス

 

ローカライゼーションサポート

setlocale

localeconv

lconv

ロケールカテゴリ

LC_ALLLC_COLLATELC_CTYPELC_MONETARYLC_NUMERICLC_TIME

 

ヘッダ <locale.h> で定義
char* setlocale( int category, const char* locale );

setlocale 関数は、指定されたシステムロケールまたはその一部を新しいCロケールとしてインストールします。この変更は、次に setlocale が呼び出されるまで有効であり、ロケールに依存するすべてのCライブラリ関数の実行に影響を与えます。locale がヌルポインタの場合、setlocale はそれを変更せずに現在のCロケールを照会します。

パラメータ

category	-	ロケールカテゴリ識別子。LC_xxx マクロのいずれかです。ヌルでもかまいません。
locale	-	システム固有のロケール識別子。ユーザーが優先するロケールには ""、最小ロケールには "C" を使用できます。

戻り値

変更が適用された後のCロケールを識別する、ヌル終端の文字列へのポインタ。失敗した場合はヌルポインタを返します。

返された文字列のコピーと、この setlocale の呼び出しで使用されたカテゴリは、プログラムの後半でロケールをこの呼び出しの終了時の状態に戻すために使用できます。

注記

プログラムの起動時、ユーザーコードが実行される前に、setlocale(LC_ALL, "C"); と同等の処理が実行されます。

戻り値の型は char* ですが、指し示す文字を変更することは未定義の動作です。

setlocale はグローバル状態を変更し、ロケール依存の関数の実行に影響を与えるため、あるスレッドで 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 The setlocale function (p: TBD)

• C17標準 (ISO/IEC 9899:2018)

• 7.11.1.1 The setlocale function (p: 163-164)

• C11標準 (ISO/IEC 9899:2011)

• 7.11.1.1 The setlocale function (p: 224-225)

• C99標準 (ISO/IEC 9899:1999)

• 7.11.1.1 The setlocale function (p: 205-206)

• C89/C90標準 (ISO/IEC 9899:1990)

• 4.4.1.1 The setlocale function

関連項目

LC_ALLLC_COLLATELC_CTYPELC_MONETARYLC_NUMERICLC_TIME	setlocale のロケールカテゴリ (マクロ定数)
C++ ドキュメント (setlocale)

外部リンク

1.	Windows のロケール名一覧.
2.	Linux のロケール名一覧.