Fonction de la bibliothèque C -newlocale()
Bibliothèque standard C - <locale.h>
Description
newlocale()est une fonction de la bibliothèque standard C utilisée pour créer un nouvel objet de localisation. Cette fonction permet au programme de créer un paramètre régional spécifique, et peut être modifiée ou étendue en fonction d’une localisation existante.
Déclaration
Ci-dessous se trouve la déclaration de la fonction newlocale().
#include <locale.h> locale_t newlocale(int category_mask, const char *locale, locale_t base);
Paramètre
-
category_mask: Un masque d'une ou plusieurs catégories de localisation à définir. Il peut être une combinaison des macros suivantes (via l'opérateur OR bit à bit|Combinaison) :LC_COLLATE_MASK: Informations de localisation liées à la comparaison de chaînes.LC_CTYPE_MASKInformations de localisation liées à la classification et à la conversion des caractères.LC_MONETARY_MASK: Informations de localisation liées au format monétaire.LC_NUMERIC_MASK: Informations de localisation liées au format numérique.LC_TIME_MASK: Informations de localisation liées au format de l'heure.LC_MESSAGES_MASK: Informations de localisation relatives à l'affichage des messages.LC_ALL_MASKToutes les catégories de localisation.
-
locale: Une chaîne spécifiant le nom de la locale à définir (par exemple, "en_US.UTF-8"). Si elle estNULLAlors la locale par défaut est utilisée. -
base: unlocale_tobjet existant, utilisé comme base pour créer un nouvel objet locale. S'il estNULLAlors un nouvel objet est créé à partir de zéro.
Valeur de retour
- En cas de succès, renvoie l'objet locale nouvellement créé (type
locale_t)。 - En cas d'échec, renvoie
NULL。
Exemple
Voici un exemple de code pour créer et utiliser un nouvel objet locale avec 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;
}
// Définir l'objet de locale du thread courant sur le nouvel objet de locale
locale_t oldloc = uselocale(newloc);
// Obtenir et afficher les informations sur la locale actuelle
struct lconv *lc = localeconv();
printf("Caractère de point décimal dans la nouvelle locale : %s\n", lc->decimal_point);
printf("Séparateur de milliers dans la nouvelle locale : %s\n", lc->thousands_sep);
// Restaurer l'objet de locale précédent
uselocale(oldloc);
// 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 :
Decimal point character in new locale: . Thousands separator in new locale: ,
Explication du code
Créer un nouvel objet de locale
newlocale(LC_ALL_MASK, "en_US.UTF-8", NULL): Créer un nouvel objet de locale, en utilisant la locale "en_US.UTF-8", basé sur l'objet de locale par défaut.newlocale(LC_NUMERIC_MASK | LC_TIME_MASK, "fr_FR.UTF-8", NULL): Créer un nouvel objet de locale, en définissant les formats numériques et temporels sur "fr_FR.UTF-8" (français - France), les autres catégories utilisant les paramètres par défaut.
Définir l'objet de locale du thread
- Utilisation
uselocale(newloc)Définir l'objet de locale du thread actuel sur l'objet de locale nouvellement créé. - Utilisation
uselocale(oldloc)Restaurer l'objet de locale précédent.
Libère l'objet de localisation
- Utilisation
freelocale(newloc)Libérer le nouvel objet de locale créé afin d'éviter les fuites de mémoire.
Notes
newlocale()fait partie de la norme POSIX.1-2008 et n'est pas pris en charge sur toutes les plateformes. Si vous utilisez la bibliothèque C GNU, veillez à inclure<xlocale.h>Fichier d'en-tête.newlocale()renvoyélocale_tL'objet peut être passé àuselocale()fonction, afin d'utiliser temporairement une locale différente dans un thread.
Résumé
newlocale()La fonction permet de créer et d'utiliser de nouveaux objets de paramètres régionaux, afin que les programmes puissent gérer différents paramètres régionaux et besoins de localisation. En combinantnewlocale()、uselocale()etfreelocale()Avec cette fonction, les programmeurs peuvent gérer et changer de manière plus flexible les informations de localisation du programme, soutenant ainsi le développement d'applications internationalisées.