_configthreadlocale
スレッドごとのロケール オプションを設定します。
int _configthreadlocale(
int type
);
パラメーター
- type
設定する値。 次の一覧に示すオプションのいずれかを指定します。
戻り値
スレッドごとのロケールの以前のステータス (_DISABLE_PER_THREAD_LOCALE または _ENABLE_PER_THREAD_LOCALE) を返します。エラー発生時には -1 を返します。
解説
_configurethreadlocale 関数は、スレッド固有のロケールの使用を制御するために使用します。 次のオプションのいずれかを使用して、スレッドごとのロケールの状態を指定または確認します。
_ENABLE_PER_THREAD_LOCALE
現在のスレッドでスレッド固有のロケールを使用させます。 今後このスレッドで setlocale を呼び出すと、スレッド独自のロケールだけに影響します。_DISABLE_PER_THREAD_LOCALE
現在のスレッドでグローバルなロケールを使用させます。 今後このスレッドで setlocale を呼び出すと、グローバルなロケールを使用する他のスレッドに影響します。0
この特定のスレッドの現在の設定を取得します。
これらの関数は、setlocale、_tsetlocale、_wsetlocale、_beginthread、および _beginthreadex の動作に影響します。 別のメソッドを使用してスレッドを作成した場合、ロケールの設定はこれらのスレッドに影響しません。
スレッドごとのロケールが無効になると、その後で setlocale または _wsetlocale を呼び出すたびに、すべてのスレッドのロケールが変更されます。 スレッドごとのロケールが有効な場合、setlocale または _wsetlocale は現在のスレッドのロケールだけに影響します。
_configurethreadlocale を使用してスレッドごとのロケールを有効にした場合は、その後すぐに setlocale または _wsetlocale を呼び出して、そのスレッドで優先ロケールを設定することをお勧めします。
type が上記の一覧に示されている値のいずれでもない場合、「パラメーターの検証」に説明されているように、この関数は無効なパラメーター ハンドラーを呼び出します。 実行の継続が許可された場合、この関数は errno を EINVAL に設定し、-1 を返します。
必要条件
ルーチン |
必須ヘッダー |
---|---|
_configthreadlocale |
<locale.h> |
使用例
// crt_configthreadlocale.cpp
//
// This program demonstrates the use of _configthreadlocale when
// using is two independent threads.
//
#include <locale.h>
#include <process.h>
#include <windows.h>
#include <stdio.h>
#include <time.h>
#define BUFF_SIZE 100
// Retrieve the date and time in the current
// locale's format.
int get_time(unsigned char* str)
{
__time64_t ltime;
struct tm thetime;
// Retieve the time
_time64(<ime);
_gmtime64_s(&thetime, <ime);
// Format the current time structure into a string
// using %#x is the long date representation,
// appropriate to the current locale
if (!strftime((char *)str, BUFF_SIZE, "%#x",
(const struct tm*)&thetime))
{
printf("strftime failed!\n");
return -1;
}
return 0;
}
// This thread sets its locale to German
// and prints the time.
unsigned __stdcall SecondThreadFunc( void* pArguments )
{
unsigned char str[BUFF_SIZE];
// Set the thread code page
_setmbcp(_MB_CP_ANSI)
// Set the thread locale
printf("The thread locale is now set to %s.\n",
setlocale(LC_ALL, "German"));
// Retrieve the time string from the helper function
if (get_time(str) == 0)
{
printf("The time in German locale is: '%s'\n", str);
}
_endthreadex( 0 );
return 0;
}
// The main thread spawns a second thread (above) and then
// sets the locale to English and prints the time.
int main()
{
HANDLE hThread;
unsigned threadID;
unsigned char str[BUFF_SIZE];
// Configure per-thread locale to cause all subsequently created
// threads to have their own locale.
_configthreadlocale(_ENABLE_PER_THREAD_LOCALE);
// Retrieve the time string from the helper function
printf("The thread locale is now set to %s.\n",
setlocale(LC_ALL, "English"));
// Create the second thread.
hThread = (HANDLE)_beginthreadex( NULL, 0, &SecondThreadFunc,
NULL, 0, &threadID );
if (get_time(str) == 0)
{
// Retrieve the time string from the helper function
printf("The time in English locale is: '%s'\n\n", str);
}
// Wait for the created thread to finish.
WaitForSingleObject( hThread, INFINITE );
// Destroy the thread object.
CloseHandle( hThread );
}
同等の .NET Framework 関数
使用できません。ただし、「CurrentCulture プロパティの使用」を参照してください。