Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / C

setlocale — sélectionner ou interroger les paramètres régionaux

setlocale sélectionne ou interroge les paramètres régionaux de la bibliothèque C, qui influent notamment sur le formatage des nombres.

Version : C23; repository compiler flag, production runtime not attested

Syntaxe

#include <locale.h>
char *setlocale(int category, const char *locale);

setlocale, déclaré dans <locale.h>, modifie les paramètres régionaux du programme. category en sélectionne une partie ; LC_ALL les englobe tous. LC_NUMERIC contrôle notamment le caractère du séparateur décimal.

"C" sélectionne l’environnement C minimal, et "" l’environnement natif ; les autres noms dépendent de l’implémentation. Les programmes démarrent avec "C". Passer NULL permet d’interroger les paramètres sans les modifier. Une modification qui échoue renvoie NULL et laisse les paramètres inchangés.

Ne modifiez pas la chaîne renvoyée. Si vous en avez besoin, copiez-la avant l’appel suivant : utiliser ensuite la valeur renvoyée entraîne un comportement indéfini, y compris après la fin du thread appelant. Les appels peuvent provoquer des courses de données avec des opérations dépendant des paramètres régionaux.

Exemples

#include <locale.h>
#include <stdio.h>

int main(void)
{
    if (setlocale(LC_NUMERIC, "C") == NULL) {
        return 1;
    }

    printf("%.2f\n", 1234.5);
    return 0;
}

Résultat

1234.50

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources