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 est
LC_GLOBAL_LOCALE, alors utilisez les paramètres régionaux globaux. - S'il est
NULL, 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 valide
locale_tL'objet sera défini comme objet de paramètres régionaux du thread actuel.
- S'il est
Valeur de retour
- En cas de succès, renvoyer le précédent
locale_tL'objet (l'objet locale du thread actuel). - En cas d'échec, renvoie
LC_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 <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
-
Créer un nouvel objet de locale:
- Utilisation
newlocale(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".
- Utilisation
-
Affichez les informations sur la locale par défaut:
- Utilisation
localeconv()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.
- Utilisation
-
Définir l'objet de locale du thread:
- Utilisation
uselocale(newloc)Définissez l'objet locale du thread actuel sur l'objet locale nouvellement créé, et enregistrez l'objet locale précédent.
- Utilisation
-
Affichez les informations sur la nouvelle locale:
- Utilisation
localeconv()Récupérez et affichez les informations sur la nouvelle locale pour vérifier si le changement a réussi.
- Utilisation
-
Restaurez l'objet locale précédent:
- Utilisation
uselocale(oldloc)Restaurer l'objet de locale précédent.
- Utilisation
-
Libérez l'objet locale:
- Utilisation
freelocale(newloc)Libérez l'objet locale nouvellement créé pour éviter les fuites de mémoire.
- Utilisation
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-thread
uselocale()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. - Utilisation
freelocale()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.