다중 스레딩 및 로캘Multithreading and Locales

C 런타임 라이브러리와 c + + 표준 라이브러리는 프로그램의 로캘 변경을 대 한 지원을 제공 합니다.Both the C Runtime Library and the C++ Standard Library provide support for changing the locale of your program. 이 항목에서는 다중 스레드 응용 프로그램에서 두 라이브러리의 로캘 기능을 사용 하는 경우 발생 하는 문제를 설명 합니다.This topic discusses issues that arise when using the locale functionality of both libraries in a multithreaded application.

설명Remarks

C 런타임 라이브러리를 사용 하 여 다중 스레드 응용 프로그램을 만들 수 있습니다 합니다 _beginthread_beginthreadex 함수입니다.With the C Runtime Library, you can create multithreaded applications using the _beginthread and _beginthreadex functions. 이 항목에서는 이러한 함수를 사용 하 여 생성 하는 다중 스레드 응용 프로그램에 대해서만 설명 합니다.This topic only covers multithreaded applications created using these functions. 자세한 내용은 _beginthread, _beginthreadex합니다.For more information, see _beginthread, _beginthreadex.

C 런타임 라이브러리를 사용 하 여 로캘을 변경 하려면 사용 합니다 setlocale 함수입니다.To change the locale using the C Runtime Library, use the setlocale function. 이전 버전의 Visual c + +에서는이 함수는 항상 전체 응용 프로그램에 걸쳐 로캘을 수정 합니다.In previous versions of Visual C++, this function would always modify the locale throughout the entire application. 스레드 단위의 로캘 설정을 지원 방법이 있습니다.There is now support for setting the locale on a per-thread basis. 이렇게 사용 하는 _configthreadlocale 함수입니다.This is done using the _configthreadlocale function. 지정 하는 setlocale 만 현재 스레드의 호출에서 로캘을 변경 해야 _configthreadlocale(_ENABLE_PER_THREAD_LOCALE) 스레드에서 합니다.To specify that setlocale should only change the locale in the current thread, call _configthreadlocale(_ENABLE_PER_THREAD_LOCALE) in that thread. 반대로, 호출 _configthreadlocale(_DISABLE_PER_THREAD_LOCALE) 전역 로캘 사용 하는 스레드 및 호출 하면 setlocale 는 스레드에 스레드별 로캘을 명시적으로 사용 하지 않는 모든 스레드의 로캘을 변경 됩니다.Conversely, calling _configthreadlocale(_DISABLE_PER_THREAD_LOCALE) will cause that thread to use the global locale, and any call to setlocale in that thread will change the locale in all threads that have not explicitly enabled per-thread locale.

C + + 런타임 라이브러리를 사용 하 여 로캘을 변경 하려면 사용 합니다 locale 클래스합니다.To change the locale using the C++ Runtime Library, use the locale Class. 호출 하 여 합니다 locale:: global 메서드의 스레드 단위 로캘을 명시적으로 사용 하지 않는 모든 스레드의 로캘을 변경 합니다.By calling the locale::global method, you change the locale in every thread that has not explicitly enabled per-thread locale. 단일 스레드 또는 응용 프로그램 부분에서 로캘을 변경 하려면 만들면 인스턴스의 locale 개체는 스레드 또는 코드의 일부입니다.To change the locale in a single thread or portion of an application, simply create an instance of a locale object in that thread or portion of code.

참고

호출 locale:: global c + + 표준 라이브러리 및 C 런타임 라이브러리에 대 한 로캘을 변경 합니다.Calling locale::global changes the locale for both the C++ Standard Library and the C Runtime Library. 그러나 호출 setlocale C 런타임 라이브러리, c + + 표준 라이브러리에는 영향을 받지 않습니다에 대 한 로캘을 변경 합니다.However, calling setlocale only changes the locale for the C Runtime Library; the C++ Standard Library is not affected.

다음 예제에 사용 하는 방법을 보여 줍니다 합니다 setlocale 함수는 locale 클래스, 및 _configthreadlocale 함수 응용 프로그램의 로캘을 변경 하려면 여러 가지 시나리오입니다.The following examples show how to use the setlocale function, the locale Class, and the _configthreadlocale function to change the locale of an application in several different scenarios.

예제Example

이 예제에서는 main 메서드가 두 자식 스레드를 생성 합니다.In this example, the main thread spawns two child threads. 첫 번째 스레드의 스레드 A 호출 하 여 스레드별 로캘을 사용 하면 _configthreadlocale(_ENABLE_PER_THREAD_LOCALE)합니다.The first thread, Thread A, enables per-thread locale by calling _configthreadlocale(_ENABLE_PER_THREAD_LOCALE). 두 번째 스레드가, 스레드 B 뿐만 아니라 주 스레드에서 스레드별 로캘을 사용 하지 마십시오.The second thread, Thread B, as well as the main thread, do not enable per-thread locale. 스레드 A는 다음을 사용 하 여 로캘 변경 진행 합니다 setlocale C 런타임 라이브러리의 함수입니다.Thread A then proceeds to change the locale using the setlocale function of the C Runtime Library.

스레드 A에 스레드별 로캘을 사용 하 고, "프랑스어" 로캘을 사용 하는 스레드 시작에서 C 런타임 라이브러리 함수에만 합니다.Since Thread A has per-thread locale enabled, only the C Runtime Library functions in Thread A start using the "french" locale. 주 스레드 및 스레드 B에서 C 런타임 라이브러리 함수를 "C" 로캘에서 사용 하 여 계속 합니다.The C Runtime Library functions in Thread B and in the main thread continue to use the "C" locale. 또한 이후 setlocale 모든 c + + 표준 라이브러리 개체는 "C" 로캘에서 사용 하 여 계속 c + + 표준 라이브러리 로캘의 영향을 주지 않습니다.Also, since setlocale does not affect the C++ Standard Library locale, all C++ Standard Library objects continue to use the "C" locale.

// multithread_locale_1.cpp
// compile with: /EHsc /MD
#include <clocale>
#include <cstdio>
#include <locale>
#include <process.h>
#include <windows.h>

#define NUM_THREADS 2
using namespace std;

unsigned __stdcall RunThreadA(void *params);
unsigned __stdcall RunThreadB(void *params);

BOOL localeSet = FALSE;
HANDLE printMutex = CreateMutex(NULL, FALSE, NULL);

int main()
{
    HANDLE threads[NUM_THREADS];

    unsigned aID;
    threads[0] = (HANDLE)_beginthreadex(
        NULL, 0, RunThreadA, NULL, 0, &aID);

    unsigned bID;
    threads[1] = (HANDLE)_beginthreadex(
        NULL, 0, RunThreadB, NULL, 0, &bID);

    WaitForMultipleObjects(2, threads, TRUE, INFINITE);

    printf_s("[Thread main] Per-thread locale is NOT enabled.\n");
    printf_s("[Thread main] CRT locale is set to \"%s\"\n",
        setlocale(LC_ALL, NULL));
    printf_s("[Thread main] locale::global is set to \"%s\"\n",
        locale().name().c_str());

    CloseHandle(threads[0]);
    CloseHandle(threads[1]);
    CloseHandle(printMutex);

    return 0;
}

unsigned __stdcall RunThreadA(void *params)
{
    _configthreadlocale(_ENABLE_PER_THREAD_LOCALE);
    setlocale(LC_ALL, "french");
    localeSet = TRUE;

    WaitForSingleObject(printMutex, INFINITE);
    printf_s("[Thread A] Per-thread locale is enabled.\n");
    printf_s("[Thread A] CRT locale is set to \"%s\"\n",
        setlocale(LC_ALL, NULL));
    printf_s("[Thread A] locale::global is set to \"%s\"\n\n",
        locale().name().c_str());
    ReleaseMutex(printMutex);

    return 1;
}

unsigned __stdcall RunThreadB(void *params)
{
    while (!localeSet)
        Sleep(100);

    WaitForSingleObject(printMutex, INFINITE);
    printf_s("[Thread B] Per-thread locale is NOT enabled.\n");
    printf_s("[Thread B] CRT locale is set to \"%s\"\n",
        setlocale(LC_ALL, NULL));
    printf_s("[Thread B] locale::global is set to \"%s\"\n\n",
        locale().name().c_str());
    ReleaseMutex(printMutex);

    return 1;
}
[Thread A] Per-thread locale is enabled.
[Thread A] CRT locale is set to "French_France.1252"
[Thread A] locale::global is set to "C"

[Thread B] Per-thread locale is NOT enabled.
[Thread B] CRT locale is set to "C"
[Thread B] locale::global is set to "C"

[Thread main] Per-thread locale is NOT enabled.
[Thread main] CRT locale is set to "C"
[Thread main] locale::global is set to "C"

예제Example

이 예제에서는 main 메서드가 두 자식 스레드를 생성 합니다.In this example, the main thread spawns two child threads. 첫 번째 스레드의 스레드 A 호출 하 여 스레드별 로캘을 사용 하면 _configthreadlocale(_ENABLE_PER_THREAD_LOCALE)합니다.The first thread, Thread A, enables per-thread locale by calling _configthreadlocale(_ENABLE_PER_THREAD_LOCALE). 두 번째 스레드가, 스레드 B 뿐만 아니라 주 스레드에서 스레드별 로캘을 사용 하지 마십시오.The second thread, Thread B, as well as the main thread, do not enable per-thread locale. 스레드 A는 다음을 사용 하 여 로캘 변경 진행 합니다 locale:: global c + + 표준 라이브러리의 메서드.Thread A then proceeds to change the locale using the locale::global method of the C++ Standard Library.

스레드 A에 스레드별 로캘을 사용 하 고, "프랑스어" 로캘을 사용 하는 스레드 시작에서 C 런타임 라이브러리 함수에만 합니다.Since Thread A has per-thread locale enabled, only the C Runtime Library functions in Thread A start using the "french" locale. 주 스레드 및 스레드 B에서 C 런타임 라이브러리 함수를 "C" 로캘에서 사용 하 여 계속 합니다.The C Runtime Library functions in Thread B and in the main thread continue to use the "C" locale. 그러나 합니다 locale:: global 메서드 로캘을 "전역" 변경, 모든 스레드에서 모든 c + + 표준 라이브러리 개체 "프랑스어" 로캘을 사용 하 여 시작 합니다.However, since the locale::global method changes the locale "globally", all C++ Standard Library objects in all threads start using the "french" locale.

// multithread_locale_2.cpp
// compile with: /EHsc /MD
#include <clocale>
#include <cstdio>
#include <locale>
#include <process.h>
#include <windows.h>

#define NUM_THREADS 2
using namespace std;

unsigned __stdcall RunThreadA(void *params);
unsigned __stdcall RunThreadB(void *params);

BOOL localeSet = FALSE;
HANDLE printMutex = CreateMutex(NULL, FALSE, NULL);

int main()
{
    HANDLE threads[NUM_THREADS];

    unsigned aID;
    threads[0] = (HANDLE)_beginthreadex(
        NULL, 0, RunThreadA, NULL, 0, &aID);

    unsigned bID;
    threads[1] = (HANDLE)_beginthreadex(
        NULL, 0, RunThreadB, NULL, 0, &bID);

    WaitForMultipleObjects(2, threads, TRUE, INFINITE);

    printf_s("[Thread main] Per-thread locale is NOT enabled.\n");
    printf_s("[Thread main] CRT locale is set to \"%s\"\n",
        setlocale(LC_ALL, NULL));
    printf_s("[Thread main] locale::global is set to \"%s\"\n",
        locale().name().c_str());

    CloseHandle(threads[0]);
    CloseHandle(threads[1]);
    CloseHandle(printMutex);

    return 0;
}

unsigned __stdcall RunThreadA(void *params)
{
    _configthreadlocale(_ENABLE_PER_THREAD_LOCALE);
    locale::global(locale("french"));
    localeSet = TRUE;

    WaitForSingleObject(printMutex, INFINITE);
    printf_s("[Thread A] Per-thread locale is enabled.\n");
    printf_s("[Thread A] CRT locale is set to \"%s\"\n",
        setlocale(LC_ALL, NULL));
    printf_s("[Thread A] locale::global is set to \"%s\"\n\n",
        locale().name().c_str());
    ReleaseMutex(printMutex);

    return 1;
}

unsigned __stdcall RunThreadB(void *params)
{
    while (!localeSet)
        Sleep(100);

    WaitForSingleObject(printMutex, INFINITE);
    printf_s("[Thread B] Per-thread locale is NOT enabled.\n");
    printf_s("[Thread B] CRT locale is set to \"%s\"\n",
        setlocale(LC_ALL, NULL));
    printf_s("[Thread B] locale::global is set to \"%s\"\n\n",
        locale().name().c_str());
    ReleaseMutex(printMutex);

    return 1;
}
[Thread A] Per-thread locale is enabled.
[Thread A] CRT locale is set to "French_France.1252"
[Thread A] locale::global is set to "French_France.1252"

[Thread B] Per-thread locale is NOT enabled.
[Thread B] CRT locale is set to "C"
[Thread B] locale::global is set to "French_France.1252"

[Thread main] Per-thread locale is NOT enabled.
[Thread main] CRT locale is set to "C"
[Thread main] locale::global is set to "French_France.1252"

예제Example

이 예제에서는 main 메서드가 두 자식 스레드를 생성 합니다.In this example, the main thread spawns two child threads. 첫 번째 스레드의 스레드 A 호출 하 여 스레드별 로캘을 사용 하면 _configthreadlocale(_ENABLE_PER_THREAD_LOCALE)합니다.The first thread, Thread A, enables per-thread locale by calling _configthreadlocale(_ENABLE_PER_THREAD_LOCALE). 두 번째 스레드가, 스레드 B 뿐만 아니라 주 스레드에서 스레드별 로캘을 사용 하지 마십시오.The second thread, Thread B, as well as the main thread, do not enable per-thread locale. 스레드 B를 사용 하 여 로캘을 변경 합니다 setlocale C 런타임 라이브러리의 함수입니다.Thread B then proceeds to change the locale using the setlocale function of the C Runtime Library.

스레드 B는 스레드별 로캘을 사용할 수 없으므로 "프랑스어" 로캘을 사용 하 여 주 스레드 및 스레드 B에서 C 런타임 라이브러리 함수를 시작 합니다.Since Thread B does not have per-thread locale enabled, the C Runtime Library functions in Thread B and in the main thread start using the "french" locale. 스레드는 스레드 단위 로캘을 사용 하기 때문에 "C" 로캘에서 사용 하는 스레드가 계속의 C 런타임 라이브러리 함수입니다.The C Runtime Library functions in Thread A continue to use the "C" locale because Thread A has per-thread locale enabled. 또한 이후 setlocale 모든 c + + 표준 라이브러리 개체는 "C" 로캘에서 사용 하 여 계속 c + + 표준 라이브러리 로캘의 영향을 주지 않습니다.Also, since setlocale does not affect the C++ Standard Library locale, all C++ Standard Library objects continue to use the "C" locale.

// multithread_locale_3.cpp
// compile with: /EHsc /MD
#include <clocale>
#include <cstdio>
#include <locale>
#include <process.h>
#include <windows.h>

#define NUM_THREADS 2
using namespace std;

unsigned __stdcall RunThreadA(void *params);
unsigned __stdcall RunThreadB(void *params);

BOOL localeSet = FALSE;
BOOL configThreadLocaleCalled = FALSE;
HANDLE printMutex = CreateMutex(NULL, FALSE, NULL);

int main()
{
    HANDLE threads[NUM_THREADS];

    unsigned aID;
    threads[0] = (HANDLE)_beginthreadex(
        NULL, 0, RunThreadA, NULL, 0, &aID);

    unsigned bID;
    threads[1] = (HANDLE)_beginthreadex(
        NULL, 0, RunThreadB, NULL, 0, &bID);

    WaitForMultipleObjects(2, threads, TRUE, INFINITE);

    printf_s("[Thread main] Per-thread locale is NOT enabled.\n");
    printf_s("[Thread main] CRT locale is set to \"%s\"\n",
        setlocale(LC_ALL, NULL));
    printf_s("[Thread main] locale::global is set to \"%s\"\n",
        locale().name().c_str());

    CloseHandle(threads[0]);
    CloseHandle(threads[1]);
    CloseHandle(printMutex);

    return 0;
}

unsigned __stdcall RunThreadA(void *params)
{
    _configthreadlocale(_ENABLE_PER_THREAD_LOCALE);
    configThreadLocaleCalled = TRUE;
    while (!localeSet)
        Sleep(100);

    WaitForSingleObject(printMutex, INFINITE);
    printf_s("[Thread A] Per-thread locale is enabled.\n");
    printf_s("[Thread A] CRT locale is set to \"%s\"\n",
        setlocale(LC_ALL, NULL));
    printf_s("[Thread A] locale::global is set to \"%s\"\n\n",
        locale().name().c_str());
    ReleaseMutex(printMutex);

    return 1;
}

unsigned __stdcall RunThreadB(void *params)
{
    while (!configThreadLocaleCalled)
        Sleep(100);
    setlocale(LC_ALL, "french");
    localeSet = TRUE;

    WaitForSingleObject(printMutex, INFINITE);
    printf_s("[Thread B] Per-thread locale is NOT enabled.\n");
    printf_s("[Thread B] CRT locale is set to \"%s\"\n",
        setlocale(LC_ALL, NULL));
    printf_s("[Thread B] locale::global is set to \"%s\"\n\n",
        locale().name().c_str());
    ReleaseMutex(printMutex);

    return 1;
}
[Thread B] Per-thread locale is NOT enabled.
[Thread B] CRT locale is set to "French_France.1252"
[Thread B] locale::global is set to "C"

[Thread A] Per-thread locale is enabled.
[Thread A] CRT locale is set to "C"
[Thread A] locale::global is set to "C"

[Thread main] Per-thread locale is NOT enabled.
[Thread main] CRT locale is set to "French_France.1252"
[Thread main] locale::global is set to "C"

예제Example

이 예제에서는 main 메서드가 두 자식 스레드를 생성 합니다.In this example, the main thread spawns two child threads. 첫 번째 스레드의 스레드 A 호출 하 여 스레드별 로캘을 사용 하면 _configthreadlocale(_ENABLE_PER_THREAD_LOCALE)합니다.The first thread, Thread A, enables per-thread locale by calling _configthreadlocale(_ENABLE_PER_THREAD_LOCALE). 두 번째 스레드가, 스레드 B 뿐만 아니라 주 스레드에서 스레드별 로캘을 사용 하지 마십시오.The second thread, Thread B, as well as the main thread, do not enable per-thread locale. 스레드 B를 사용 하 여 로캘을 변경 합니다 locale:: global c + + 표준 라이브러리의 메서드.Thread B then proceeds to change the locale using the locale::global method of the C++ Standard Library.

스레드 B는 스레드별 로캘을 사용할 수 없으므로 "프랑스어" 로캘을 사용 하 여 주 스레드 및 스레드 B에서 C 런타임 라이브러리 함수를 시작 합니다.Since Thread B does not have per-thread locale enabled, the C Runtime Library functions in Thread B and in the main thread start using the "french" locale. 스레드는 스레드 단위 로캘을 사용 하기 때문에 "C" 로캘에서 사용 하는 스레드가 계속의 C 런타임 라이브러리 함수입니다.The C Runtime Library functions in Thread A continue to use the "C" locale because Thread A has per-thread locale enabled. 그러나 합니다 locale:: global 메서드 로캘을 "전역" 변경, 모든 스레드에서 모든 c + + 표준 라이브러리 개체 "프랑스어" 로캘을 사용 하 여 시작 합니다.However, since the locale::global method changes the locale "globally", all C++ Standard Library objects in all threads start using the "french" locale.

// multithread_locale_4.cpp
// compile with: /EHsc /MD
#include <clocale>
#include <cstdio>
#include <locale>
#include <process.h>
#include <windows.h>

#define NUM_THREADS 2
using namespace std;

unsigned __stdcall RunThreadA(void *params);
unsigned __stdcall RunThreadB(void *params);

BOOL localeSet = FALSE;
BOOL configThreadLocaleCalled = FALSE;
HANDLE printMutex = CreateMutex(NULL, FALSE, NULL);

int main()
{
    HANDLE threads[NUM_THREADS];

    unsigned aID;
    threads[0] = (HANDLE)_beginthreadex(
        NULL, 0, RunThreadA, NULL, 0, &aID);

    unsigned bID;
    threads[1] = (HANDLE)_beginthreadex(
        NULL, 0, RunThreadB, NULL, 0, &bID);

    WaitForMultipleObjects(2, threads, TRUE, INFINITE);

    printf_s("[Thread main] Per-thread locale is NOT enabled.\n");
    printf_s("[Thread main] CRT locale is set to \"%s\"\n",
        setlocale(LC_ALL, NULL));
    printf_s("[Thread main] locale::global is set to \"%s\"\n",
        locale().name().c_str());

    CloseHandle(threads[0]);
    CloseHandle(threads[1]);
    CloseHandle(printMutex);

    return 0;
}

unsigned __stdcall RunThreadA(void *params)
{
    _configthreadlocale(_ENABLE_PER_THREAD_LOCALE);
    configThreadLocaleCalled = TRUE;
    while (!localeSet)
        Sleep(100);

    WaitForSingleObject(printMutex, INFINITE);
    printf_s("[Thread A] Per-thread locale is enabled.\n");
    printf_s("[Thread A] CRT locale is set to \"%s\"\n",
        setlocale(LC_ALL, NULL));
    printf_s("[Thread A] locale::global is set to \"%s\"\n\n",
        locale().name().c_str());
    ReleaseMutex(printMutex);

    return 1;
}

unsigned __stdcall RunThreadB(void *params)
{
    while (!configThreadLocaleCalled)
        Sleep(100);
    locale::global(locale("french"));
    localeSet = TRUE;

    WaitForSingleObject(printMutex, INFINITE);
    printf_s("[Thread B] Per-thread locale is NOT enabled.\n");
    printf_s("[Thread B] CRT locale is set to \"%s\"\n",
        setlocale(LC_ALL, NULL));
    printf_s("[Thread B] locale::global is set to \"%s\"\n\n",
        locale().name().c_str());
    ReleaseMutex(printMutex);

    return 1;
}
[Thread B] Per-thread locale is NOT enabled.
[Thread B] CRT locale is set to "French_France.1252"
[Thread B] locale::global is set to "French_France.1252"

[Thread A] Per-thread locale is enabled.
[Thread A] CRT locale is set to "C"
[Thread A] locale::global is set to "French_France.1252"

[Thread main] Per-thread locale is NOT enabled.
[Thread main] CRT locale is set to "French_France.1252"
[Thread main] locale::global is set to "French_France.1252"

참고 항목See Also

이전 코드를 위한 다중 스레드 지원(Visual C++)Multithreading Support for Older Code (Visual C++)
_beginthread, _beginthreadex_beginthread, _beginthreadex
_configthreadlocale_configthreadlocale
setlocalesetlocale
국제화Internationalization
로캘Locale
<clocale ><clocale>
<locale><locale>
locale 클래스locale Class