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éé (typelocale_t)。
  • En cas d'échec, renvoieNULL。

Exemple

Voici un exemple de code pour créer et utiliser un nouvel objet locale avec 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;
    }

    // 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

  • Utilisationuselocale(newloc)Définir l'objet de locale du thread actuel sur l'objet de locale nouvellement créé.
  • Utilisationuselocale(oldloc)Restaurer l'objet de locale précédent.

Libère l'objet de localisation

  • Utilisationfreelocale(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.

Bibliothèque standard C - <locale.h>

autres extensions