Nous recommandons d’utiliser Visual Studio 2017

_create_locale, _wcreate_locale

 

Pour obtenir la dernière documentation sur Visual Studio 2017, consultez Documentation Visual Studio 2017.

Crée un objet de paramètres régionaux.

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

Paramètres

category
Catégorie.

locale
Spécificateur de paramètres régionaux.

Si valide locale et category sont fournies, retourne les paramètres régionaux spécifié comme un _locale_t objet. Les paramètres régionaux actuels du programme ne sont pas modifiés.

Le _create_locale fonction vous permet de créer un objet qui représente certains paramètres régionaux, pour une utilisation dans des versions spécifiques de nombreuses fonctions CRT (fonctions avec le _l suffixe). Le comportement est semblable à setlocale, sauf qu’au lieu d’appliquer les paramètres régionaux spécifiés dans l’environnement actuel, les paramètres sont enregistrés dans un _locale_t structure qui est retournée. Le _locale_t structure doit être libérée à l’aide de _free_locale lorsqu’il n’est plus nécessaire.

_wcreate_locale est une version à caractères larges de _create_locale ; l'argument locale de _wcreate_locale est une chaîne à caractères larges. Sinon, _wcreate_locale et _create_locale se comportent de la même façon.

Le category argument spécifie les parties du comportement spécifiques qui sont affectées. Les indicateurs utilisés pour category et les parties du programme qu’ils affectent comme indiqué dans le tableau suivant.

LC_ALL
Toutes les catégories, comme indiqué ci-dessous.

LC_COLLATE
Les fonctions strcoll, _stricoll, wcscoll, _wcsicoll, strxfrm, _strncoll, _strnicoll, _wcsncoll, _wcsnicoll et wcsxfrm.

LC_CTYPE
Les fonctions de gestion de caractères (sauf isdigit, isxdigit, mbstowcs, et mbtowc, qui ne sont pas affectés).

LC_MONETARY
Les informations de mise en forme monétaire retournées par la fonction localeconv.

LC_NUMERIC
Le caractère de virgule décimale pour les routines de sortie mise en forme (comme printf), pour les routines de conversion de données, et pour les informations de mise en forme non monétaire retournées par localeconv. Outre le caractère de virgule décimale, LC_NUMERIC séparateur des milliers de jeux et le contrôle de regroupement chaîne renvoyée par localeconv.

LC_TIME
Les fonctions strftime et wcsftime.

Cette fonction valide la category et locale paramètres. Si le paramètre de catégorie n’est pas une des valeurs indiquées dans le tableau précédent ou si locale est NULL, la fonction renvoie NULL.

L'argument locale est un pointeur vers une chaîne qui spécifie les paramètres régionaux. Pour plus d’informations sur le format de la locale argument, consultez la page les noms de paramètres régionaux, les langues et les chaînes de pays/région.

L'argument locale peut accepter un nom de paramètres régionaux, une chaîne de langue, une chaîne de langue et un pays/région, une page de codes, ou une chaîne de langue, un pays/région, et une page de codes. Le jeu de noms de paramètres régionaux disponibles, les langages, les codes de pays/région et les pages de codes inclut tout ce qui sont pris en charge par l’API Windows NLS, sauf les pages de codes qui requièrent plus de deux octets par caractère, par exemple, UTF-7 et UTF-8. Si vous fournissez une page de codes comme UTF-7 ou UTF-8, _create_locale échouent et renvoient la valeur NULL. L’ensemble des noms de paramètres régionaux pris en charge par _create_locale sont décrites dans les noms de paramètres régionaux, les langues et les chaînes de pays/région. L’ensemble de chaînes de langue et de pays/région pris en charge par _create_locale sont répertoriés dans chaînes de langue et chaînes pays/région.

Pour plus d’informations sur les paramètres régionaux, consultez setlocale, _wsetlocale.

Le nom précédent de cette fonction, __create_locale (avec deux traits de soulignement gauche), a été déconseillée.

RoutineEn-tête requis
_create_locale<locale.h>
_wcreate_locale<locale.h> ou <wchar.h>

Pour plus d'informations sur la compatibilité, voir Compatibilité.

  
      // 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'  

System::Globalization :: CultureInfo Class

Noms de paramètres régionaux, les langues et les chaînes de pays/région
Chaînes de langue
Chaînes pays/région
_free_locale
_configthreadlocale
setlocale
Paramètres régionaux
localeconv
_mbclen, mblen, _mblen_l
strlen, wcslen, _mbslen, _mbslen_l, _mbstrlen, _mbstrlen_l
mbstowcs, _mbstowcs_l
mbtowc, _mbtowc_l
_setmbcp
SetLocale, _wsetlocale
strcoll (fonctions)
strftime, wcsftime, _strftime_l, _wcsftime_l
strxfrm, wcsxfrm, _strxfrm_l, _wcsxfrm_l
wcstombs, _wcstombs_l
wctomb, _wctomb_l

Afficher: