Esta documentación está archivada y no tiene mantenimiento.

Subprocesamiento múltiple y configuraciones regionales

La Biblioteca en tiempo de ejecución de C y el Biblioteca estándar de C++ proporcionan compatibilidad para cambiar la configuración regional del programa. Este tema aborda problemas que surgen al utilizar la funcionalidad de la configuración regional de ambas bibliotecas en una aplicación multiproceso.

Con la Biblioteca en tiempo de ejecución de C puede crear aplicaciones multiproceso mediante las funciones _beginthread y _beginthreadex. Este tema sólo cubre las aplicaciones multiproceso creadas mediante estas funciones. Para obtener más información, vea _beginthread, _beginthreadex.

Para cambiar la configuración regional mediante la Biblioteca en tiempo de ejecución de C, utilice la función setlocale. En versiones anteriores de Visual C++, esta función siempre modificaba la configuración regional en toda la aplicación. Ahora existe compatibilidad para establecer la configuración regional de cada subproceso. Esto se realiza mediante la función _configthreadlocale. Para especificar que setlocale sólo debería cambiar la configuración regional en el subproceso actual, llame a _configthreadlocale(_ENABLE_PER_THREAD_LOCALE) en ese subproceso. Al contrario, si se llama a _configthreadlocale(_DISABLE_PER_THREAD_LOCALE) el subproceso usará la configuración regional global, y cualquier llamada a setlocale en dicho subproceso cambiará la configuración regional de todos los subprocesos que no tengan activada explícitamente la configuración regional para cada subproceso.

Para cambiar la configuración regional mediante la Biblioteca en tiempo de ejecución de C++, utilice la función locale Class. Si se llama al método locale::global, cambiará la configuración regional de cada subproceso que no haya habilitado explícitamente la configuración regional para cada subproceso. Para cambiar la configuración regional de un único subproceso o parte de una aplicación, simplemente cree una instancia de un objeto locale en dicho subproceso o parte de código.

NoteNota

Llamar a locale::global, cambia la configuración regional de la Biblioteca estándar de C++ y la Biblioteca en tiempo de ejecución de C. Sin embargo, llamar a setlocale, sólo cambia la configuración regional de la Biblioteca en tiempo de ejecución de C; no afecta a la Biblioteca estándar de C++.

Los siguientes ejemplos muestran cómo usar las funciones setlocale, locale Class y _configthreadlocale para cambiar la configuración regional de una aplicación en varios escenarios diferentes.

En este ejemplo, el subproceso principal genera dos subprocesos secundarios. El primer subproceso, el subproceso A, habilita la configuración regional para cada subproceso llamando a _configthreadlocale(_ENABLE_PER_THREAD_LOCALE). El segundo subproceso, el subproceso B, así como el subproceso principal, no habilitan la configuración regional para cada subproceso. A continuación, el subproceso A procede a cambiar la configuración regional mediante la función setlocale de la Biblioteca en tiempo de ejecución de C.

Como el subproceso A tiene habilitada la configuración regional para cada subproceso, sólo las funciones de la Biblioteca en tiempo de ejecución de C del subproceso A empezarán a utilizar la configuración regional "francesa". Las funciones de la Biblioteca en tiempo de ejecución de C del subproceso B y del subproceso principal continuarán utilizando la configuración regional de "C." A su vez, como setlocale no afecta a la configuración regional de la Biblioteca estándar de C++, todos los objetos de ésta seguirán utilizando la configuración regional de "C".

// 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;
}

Resultados

[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"

En este ejemplo, el subproceso principal genera dos subprocesos secundarios. El primer subproceso, el subproceso A, habilita la configuración regional para cada subproceso llamando a _configthreadlocale(_ENABLE_PER_THREAD_LOCALE). El segundo subproceso, el subproceso B, así como el subproceso principal, no habilitan la configuración regional para cada subproceso. A continuación, el subproceso A procede a cambiar la configuración regional mediante el método locale::global de la Biblioteca estándar de C++.

Como el subproceso A tiene habilitada la configuración regional para cada subproceso, sólo las funciones de la Biblioteca en tiempo de ejecución de C del subproceso A empezarán a utilizar la configuración regional "francesa". Las funciones de la Biblioteca en tiempo de ejecución de C del subproceso B y del subproceso principal continuarán utilizando la configuración regional de "C." Sin embargo, debido a que el método locale::global cambia "globalmente" la configuración regional, todos los objetos de la Biblioteca estándar de C++ en todos los subprocesos empezarán a utilizar la configuración regional "francesa".

// 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;
}

Resultados

[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"

En este ejemplo, el subproceso principal genera dos subprocesos secundarios. El primer subproceso, el subproceso A, habilita la configuración regional para cada subproceso llamando a _configthreadlocale(_ENABLE_PER_THREAD_LOCALE). El segundo subproceso, el subproceso B, así como el subproceso principal, no habilitan la configuración regional para cada subproceso. A continuación, el subproceso B procede a cambiar la configuración regional mediante la función setlocale de la Biblioteca en tiempo de ejecución de C.

Como el subproceso B no tiene habilitada la configuración regional para cada subproceso, las funciones de la Biblioteca en tiempo de ejecución de C del subproceso B y del subproceso principal empezarán a utilizar la configuración regional "francesa". Las funciones de la Biblioteca en tiempo de ejecución de C del subproceso A continuarán utilizando la configuración regional de "C" porque el subproceso A tiene habilitada la configuración regional para cada subproceso. A su vez, como setlocale no afecta a la configuración regional de la Biblioteca estándar de C++, todos los objetos de ésta seguirán utilizando la configuración regional de "C".

// 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;
}

Resultados

[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"

En este ejemplo, el subproceso principal genera dos subprocesos secundarios. El primer subproceso, el subproceso A, habilita la configuración regional para cada subproceso llamando a _configthreadlocale(_ENABLE_PER_THREAD_LOCALE). El segundo subproceso, el subproceso B, así como el subproceso principal, no habilitan la configuración regional para cada subproceso. A continuación, el subproceso B procede a cambiar la configuración regional mediante el método locale::global de la Biblioteca estándar de C++.

Como el subproceso B no tiene habilitada la configuración regional para cada subproceso, las funciones de la Biblioteca en tiempo de ejecución de C del subproceso B y del subproceso principal empezarán a utilizar la configuración regional "francesa". Las funciones de la Biblioteca en tiempo de ejecución de C del subproceso A continuarán utilizando la configuración regional de "C" porque el subproceso A tiene habilitada la configuración regional para cada subproceso. Sin embargo, debido a que el método locale::global cambia "globalmente" la configuración regional, todos los objetos de la Biblioteca estándar de C++ en todos los subprocesos empezarán a utilizar la configuración regional "francesa".

// 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;
}

Resultados

[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"
Mostrar: