setlocale

La fonction setlocale installe la locale système spécifiée ou une partie de celle-ci comme nouvelle locale C. Les modifications restent en vigueur et influencent l'exécution de toutes les fonctions de la bibliothèque C sensibles à la locale jusqu'au prochain appel à setlocale . Si locale est un pointeur nul, setlocale interroge la locale C actuelle sans la modifier.

Paramètres

Valeur de retour

pointeur vers une chaîne de caractères étroite terminée par un caractère nul identifiant les paramètres régionaux C après application des modifications, le cas échéant, ou pointeur nul en cas d'échec.

Une copie de la chaîne retournée ainsi que la catégorie utilisée dans cet appel à setlocale peut être utilisée ultérieurement dans le programme pour restaurer les paramètres régionaux à l'état qu'ils avaient à la fin de cet appel.

Notes

Pendant le démarrage du programme, l'équivalent de setlocale ( LC_ALL , "C" ) ; est exécuté avant l'exécution de tout code utilisateur.

Bien que le type de retour soit char * , modifier les caractères pointés est un comportement indéfini.

Étant donné que setlocale modifie l'état global qui affecte l'exécution des fonctions dépendantes de la locale, il s'agit d'un comportement indéfini de l'appeler depuis un thread, tandis qu'un autre thread exécute l'une des fonctions suivantes : fprintf , isprint , iswdigit , localeconv , tolower , fscanf , ispunct , iswgraph , mblen , toupper , isalnum , isspace , iswlower , mbstowcs , towlower , isalpha , isupper , iswprint , mbtowc , towupper , isblank , iswalnum , iswpunct , setlocale , wcscoll , iscntrl , iswalpha , iswspace , strcoll , wcstod , isdigit , iswblank , iswupper , strerror , wcstombs , isgraph , iswcntrl , iswxdigit , strtod , wcsxfrm , islower , iswctype , isxdigit .

POSIX définit également un paramètre régional nommé "POSIX", qui est toujours accessible et est exactement équivalent au paramètre régional minimal par défaut "C".

POSIX spécifie également que le pointeur retourné, et pas seulement le contenu de la chaîne pointée, peut être invalidé par des appels ultérieurs à setlocale .

Exemple

#include <locale.h>
#include <stdio.h>
#include <time.h>
#include <wchar.h>
int main(void)
{
    // le paramètre régional C sera l'anglais avec support UTF-8 ;
    // le séparateur décimal sera allemand
    // le formatage de la date et de l'heure sera japonais
    setlocale(LC_ALL, "en_US.UTF-8");
    setlocale(LC_NUMERIC, "de_DE.utf8");
    setlocale(LC_TIME, "ja_JP.utf8");
    wchar_t str[100];
    time_t t = time(NULL);
    wcsftime(str, 100, L"%A %c", localtime(&t));
    wprintf(L"Number: %.2f\nDate: %ls\n", 3.14, str);
}

Number: 3,14
Date: 月曜日 2017年09月25日 13時00分15秒

Références

Voir aussi

Liens externes