_create_locale、_wcreate_locale

[アーティクル]
06/09/2015

ロケールオブジェクトを作成します。

_locale_t _create_locale(
   int category,
   const char *locale 
);
_locale_t _wcreate_locale(
   int category,
   const wchar_t *locale 
);

パラメーター

category
カテゴリ。
locale
ロケールの指定子。

戻り値

有効な locale と category が指定された場合、_locale_t オブジェクトとして指定のロケール設定を返します。プログラムの現在のロケール設定は変更されません。

解説

_create_locale 関数は、多くの CRT 関数のロケール固有のバージョン (_l のサフィックスを持つ関数) で使用するために、特定の地域固有の設定を表すオブジェクトを作成できます。動作は setlocale に似ていますが、指定したロケール設定を現在の環境に適用する代わりに、返される _locale_t 構造体に設定が保存される点が異なります。 _locale_t 構造体は、不要になったときに _free_locale を使用して解放する必要があります。

_wcreate_locale 関数は、_create_locale 関数のワイド文字バージョンです。_wcreate_locale 関数の引数 locale は、ワイド文字列です。それ以外では、_wcreate_locale と _create_locale の動作は同じです。

category 引数は、影響を受けるロケール固有の動作の一部を指定します。 category に使用するフラグ、および影響されるプログラムの一部を次の表に示します。

LC_ALL
次に示すように、すべてのカテゴリです。
LC_COLLATE
strcoll、_stricoll、wcscoll、_wcsicoll、strxfrm、_strncoll、_strnicoll、_wcsncoll、_wcsnicoll、および wcsxfrm の各関数。
LC_CTYPE
文字処理関数の (影響を受けない isdigit、isxdigit、mbstowcs、および mbtowc を除く)。
LC_MONETARY
localeconv 関数が返す通貨形式情報。
LC_NUMERIC
printf などの書式化出力ルーチン、データ変換ルーチン、および localeconv が返す通貨形式以外の形式情報で使用される小数点文字。小数点文字に加え、LC_NUMERIC は桁区切り記号、および localeconv によって返されるグループ化コントロールの文字列を設定します。
LC_TIME
strftime および wcsftime 関数。

この関数は、category、および locale パラメーターを検証します。カテゴリのパラメーターが前の表で指定された値ではない場合、または、locale が NULL の場合、関数は NULL を返します。

The locale 引数は、ロケールを指定する文字列へのポインターです。 locale 引数の書式の詳細については、「ロケール名、言語、および国/地域識別文字列」を参照してください。

locale 引数には、ロケール名、言語識別文字列、言語識別文字列と国/地域コード、コードページ、または言語識別文字列、国/地域コード、コードページを指定できます。使用できるロケール名、言語、国/地域コード、およびコードページのセットには、1 文字に 2 バイトを超えるデータを必要とする (UTF-7、UTF-8 など) コードページを除き、Windows の NLS API でサポートされるすべてが含まれています。 UTF-7、UTF-8 などのコードページを指定すると、_create_locale は失敗し、NULL を返します。 _create_locale でサポートされるロケール名のセットについては、「ロケール名、言語、および国/地域識別文字列」で説明します。 _create_locale でサポートされる言語識別文字列と国/地域識別文字列は、「言語識別文字列」と「国/地域識別文字列」に記載されています。

ロケール設定の詳細については、「setlocale、_wsetlocale」を参照してください。

この関数の以前の名前 __create_locale (先頭に 2 個のアンダースコア) は、使用されなくなりました。

必要条件

ルーチン	必須ヘッダー
_create_locale	<locale.h>
_wcreate_locale	<locale.h> または <wchar.h>

互換性の詳細については、「互換性」を参照してください。

使用例

// crt_create_locale.c
// Sets the current locale to "de-CH" using the
// setlocale function and demonstrates its effect on the strftime
// function.

#include <stdio.h>
#include <locale.h>
#include <time.h>

int main(void)
{
       time_t ltime;
       struct tm thetime;
       unsigned char str[100];
       _locale_t locale;

       // Create a locale object representing the German (Switzerland) locale
       locale = _create_locale(LC_ALL, "de-CH");
       time (&ltime);
       _gmtime64_s(&thetime, &ltime);

       // %#x is the long date representation, appropriate to
       // the current locale
       //
       if (!_strftime_l((char *)str, 100, "%#x", 
                     (const struct tm *)&thetime, locale))
               printf("_strftime_l failed!\n");
       else
               printf("In de-CH locale, _strftime_l returns '%s'\n", 
                      str);

       _free_locale(locale);

       // Create a locale object representing the default C locale
       locale = _create_locale(LC_ALL, "C");
       time (&ltime);
       _gmtime64_s(&thetime, &ltime);

       if (!_strftime_l((char *)str, 100, "%#x", 
                     (const struct tm *)&thetime, locale))
               printf("_strftime_l failed!\n");
       else
               printf("In 'C' locale, _strftime_l returns '%s'\n", 
                      str);

       _free_locale(locale);
}

出力例

In de-CH locale, _strftime_l returns 'Samstag, 9. Februar 2002'
In 'C' locale, _strftime_l returns 'Saturday, February 09, 2002'

同等の .NET Framework 関数

System::Globalization::CultureInfo Class

次の方法で共有

_create_locale、_wcreate_locale

パラメーター

戻り値

解説

必要条件

使用例

出力例

同等の .NET Framework 関数

参照

関連項目

その他のリソース