_create_locale, _wcreate_locale

Crea un objeto de la configuración regional.

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

Parámetros

  • category
    Categoría.

  • locale
    Especificador de la configuración regional.

Valor devuelto

Si se proporciona locale válido y category, devuelve las configuraciones regionales especificadas como objeto de _locale_t.La configuración regional actual del programa no se cambian.

Comentarios

La función de _create_locale permite crear un objeto que representa ciertos valores específicos de la región, para el uso en versiones configuración regional- específicas de muchas funciones CRT (funciones con el sufijo de _l ).El comportamiento es similar a setlocale, salvo que en lugar de aplicar las configuraciones regionales especificadas al entorno actual, se guardan en una estructura de _locale_t se devuelve que.La estructura de _locale_t se debe liberar mediante _free_locale cuando ya no se necesita.

_wcreate_locale es una versión con caracteres anchos de _create_locale; el argumento de locale a _wcreate_locale es una cadena de caracteres._wcreate_locale y _create_locale se comportan exactamente igual de otra manera.

El argumento de category especifica las partes del comportamiento configuración regional- concreto afectadas.Los marcadores utilizados para category y las partes del programa que afectan se tal y como se muestra en la tabla siguiente.

  • LC_ALL
    Todas las categorías, como se indica a continuación.

  • LC_COLLATE
    strcoll, _stricoll, wcscoll, _wcsicoll, strxfrm, _strncoll, _strnicoll, _wcsncoll, _wcsnicoll, y funciones de wcsxfrm.

  • LC_CTYPE
    Las funciones carácter- que administran (excepto isdigit, isxdigit, mbstowcs, y mbtowc, que no son afectado).

  • LC_MONETARY
    Información de Monetario- formato devuelta por la función de localeconv.

  • LC_NUMERIC
    Carácter de separador decimal para las rutinas con formato de salida (como printf), para las rutinas de conversión de datos, e información no monetaria de formato devuelta por localeconv.Además del carácter del separador decimal, LC_NUMERIC establece el separador de miles y la cadena del control de agrupación devueltos por localeconv.

  • LC_TIME
    Las funciones de strftime y de wcsftime.

Esta función valida los parámetros de category y de locale.Si el parámetro category no es uno de los valores especificados en la tabla anterior o si locale es NULL, la función devuelve NULL.

El argumento de locale es un puntero a una cadena que especifica la configuración regional.Para obtener información sobre el formato del argumento de locale, vea Nombres de configuración regional, idiomas y cadenas de país/región.

El argumento de locale puede tomar un nombre de la configuración regional, una cadena de idioma, una cadena de idioma y un país o código de región, una página de códigos, o una cadena de idioma, un país o un código de región, y una página de códigos.El conjunto de nombres disponibles, de lenguajes, de país o códigos de región, y páginas de códigos de la configuración regional incluye todo el los admitidos por Windows NLS API excepto las páginas de códigos que requieren más de dos bytes por carácter, como UTF-7 y UTF-8.Si proporciona una página de códigos como UTF-7 o UTF-8, _create_locale producirá un error, devuelve NULL.Describe el conjunto de nombres de la configuración regional admitidos por _create_locale en Nombres de configuración regional, idiomas y cadenas de país/región.Muestran el conjunto de cadenas de idioma de país o región admitidas por _create_locale en Cadenas de idioma y Cadenas de país o región.

Para obtener más información sobre las configuraciones regionales, vea setlocale, _wsetlocale.

El nombre anterior de esta función, __create_locale (con dos subrayado principales), está desusado.

Requisitos

Rutina

Encabezado necesario

_create_locale

<locale.h>

_wcreate_locale

<locale.h> o <wchar.h>

Para obtener información adicional de compatibilidad, vea Compatibilidad.

Ejemplo

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

Resultados del ejemplo

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

Equivalente en .NET Framework

Clase de System::Globalization::CultureInfo

Vea también

Referencia

Nombres de configuración regional, idiomas y cadenas de país/región

Cadenas de idioma

Cadenas de país o región

_free_locale

_configthreadlocale

setlocale

Configuración regional

localeconv

_mbclen, mblen, _mblen_l

strlen, strlen_l, wcslen, wcslen_l, _mbslen, _mbslen_l, _mbstrlen, _mbstrlen_l

mbstowcs, _mbstowcs_l

mbtowc, _mbtowc_l

_setmbcp

setlocale, _wsetlocale

funciones de strcoll

strftime, wcsftime, _strftime_l, _wcsftime_l

strxfrm, wcsxfrm, _strxfrm_l, _wcsxfrm_l

wcstombs, _wcstombs_l

wctomb, _wctomb_l