Fonctions de la bibliothèque C -uselocale()

Bibliothèque standard C - <locale.h>

Description

uselocale()Il s'agit d'une fonction de la bibliothèque standard C, utilisée pour définir ou obtenir l'objet de paramètres régionaux actuel d'un thread. Cette fonction permet aux programmes d'utiliser différents paramètres régionaux dans différents threads, prenant ainsi en charge la localisation dans un environnement multithread.

Déclaration

Voici la déclaration de la fonction uselocale().

#include <locale.h>

locale_t uselocale(locale_t newloc);

Paramètre

  • newloc: à définir comme objet de paramètres régionaux du thread actuel.locale_tObjet.
    • S'il estLC_GLOBAL_LOCALE, alors utilisez les paramètres régionaux globaux.
    • S'il estNULL, alors l'objet de paramètres régionaux actuel n'est pas modifié, et seul l'objet de paramètres régionaux actuel est renvoyé.
    • Autre validelocale_tL'objet sera défini comme objet de paramètres régionaux du thread actuel.

Valeur de retour

  • En cas de succès, renvoyer le précédentlocale_tL'objet (l'objet locale du thread actuel).
  • En cas d'échec, renvoieLC_GLOBAL_LOCALEet définir le code d'erreur approprié.

Exemple

L'exemple suivant montre comment utiliser freelocale() pour libérer un objet locale créé par newlocale().

Exemple

#include <stdio.h>
#include <locale.h>
#include <xlocale.h> // Requis lors de l'utilisation des extensions GNU

int main() {
    // Créer un nouvel objet de locale, en utilisant le paramètre de locale "en_US.UTF-8"
    locale_t newloc = newlocale(LC_ALL_MASK, "en_US.UTF-8", (locale_t)0);
    if (newloc == (locale_t)0) {
        perror("newlocale");
        return 1;
    }

    // Obtenir et afficher les informations sur la locale actuelle
    struct lconv *lc = localeconv();
    printf("Point décimal de la locale par défaut : %s\n", lc->decimal_point);
    printf("Séparateur de milliers de la locale par défaut : %s\n", lc->thousands_sep);

    // Définir l'objet de locale du thread courant sur le nouvel objet de locale
    locale_t oldloc = uselocale(newloc);

    // Récupérer et afficher les nouvelles informations de localisation
    lc = localeconv();
    printf("Point décimal de la nouvelle locale : %s\n", lc->decimal_point);
    printf("Séparateur de milliers de la nouvelle locale : %s\n", lc->thousands_sep);

    // Restaurer l'objet de locale précédent
    uselocale(oldloc);

    // Récupérer et afficher les informations de localisation restaurées
    lc = localeconv();
    printf("Point décimal de la locale restaurée : %s\n", lc->decimal_point);
    printf("Séparateur de milliers de la locale restauré : %s\n", lc->thousands_sep);

    // Libérer le nouvel objet de locale
    freelocale(newloc);

    return 0;
}

Compilons et exécutons le programme ci-dessus, ce qui produira le résultat suivant :

Default locale decimal point: .
Default locale thousands separator: 
New locale decimal point: .
New locale thousands separator: ,
Restored locale decimal point: .
Restored locale thousands separator: 

Explication du code

  1. Créer un nouvel objet de locale:

    • Utilisationnewlocale(LC_ALL_MASK, "en_US.UTF-8", (locale_t)0)Créez un nouvel objet locale, en définissant la locale sur "en_US.UTF-8".
  2. Affichez les informations sur la locale par défaut:

    • Utilisationlocaleconv()Récupérez et affichez les informations actuelles sur la locale par défaut, telles que le caractère de séparation décimale et le séparateur de milliers.
  3. Définir l'objet de locale du thread:

    • Utilisationuselocale(newloc)Définissez l'objet locale du thread actuel sur l'objet locale nouvellement créé, et enregistrez l'objet locale précédent.
  4. Affichez les informations sur la nouvelle locale:

    • Utilisationlocaleconv()Récupérez et affichez les informations sur la nouvelle locale pour vérifier si le changement a réussi.
  5. Restaurez l'objet locale précédent:

    • Utilisationuselocale(oldloc)Restaurer l'objet de locale précédent.
  6. Libérez l'objet locale:

    • Utilisationfreelocale(newloc)Libérez l'objet locale nouvellement créé pour éviter les fuites de mémoire.

Notes

  • uselocale()La fonction fait partie de la norme POSIX.1-2008 ; assurez-vous que votre plateforme prend en charge cette fonction.
  • Lorsqu'elle est utilisée dans un environnement multi-threaduselocale()Vous pouvez définir un objet locale indépendant pour chaque thread, mais faites attention à la cohérence des données et aux conditions de concurrence entre les threads.
  • Utilisationfreelocale()Libérez les objets de paramètres régionaux qui ne sont plus nécessaires pour éviter les fuites de mémoire.

Résumé

uselocale()La fonction permet de définir et d'obtenir l'objet de paramètres régionaux du thread actuel, ce qui active la prise en charge de la localisation dans les environnements multithreadés. En combinant l'utilisation denewlocale()、uselocale()etfreelocale()fonction, les programmeurs peuvent gérer et basculer flexiblement les paramètres régionaux du programme, offrant une prise en charge locale indépendante pour différents threads.

Bibliothèque standard C - <locale.h>

autres extensions