`localeconv`

Article
10/12/2023

Obtient des informations détaillées sur les paramètres régionaux.

Syntaxe

struct lconv *localeconv( void );

Valeur retournée

localeconv retourne un pointeur vers un objet rempli de type struct lconv. Les valeurs contenues dans l’objet sont copiées à partir des paramètres régionaux dans le stockage local thread et peuvent être remplacées par les appels suivants à localeconv. Les modifications apportées aux valeurs de cet objet ne modifient pas les paramètres régionaux. Appels vers des setlocale category valeurs de LC_ALL, LC_MONETARYou LC_NUMERIC remplacent le contenu de la structure.

Notes

La fonction localeconv obtient des informations détaillées sur la mise en forme numérique pour les paramètres régionaux actuels. Ces informations sont stockées dans une structure de type lconv. Structure lconv définie dans les paramètres régionaux. H contient les membres suivants :

Champ	Signification
`decimal_point`, `_W_decimal_point`	Pointeur vers un caractère décimal pour les quantités nonmonetaires.
`thousands_sep`, `_W_thousands_sep`	Pointeur vers un caractère qui sépare les groupes de chiffres à gauche de la virgule décimale pour les quantités nonmonetaires.
`grouping`	Pointeur vers un `char`entier de taille qui contient la taille de chaque groupe de chiffres en quantités nonmonetaires.
`int_curr_symbol`, `_W_int_curr_symbol`	Pointeur vers le symbole monétaire international pour les paramètres régionaux actuels. Les trois premiers caractères spécifient le symbole monétaire international alphabétique tel que le définit la norme ISO 4217 sur les codes de représentation des monnaies et des fonds. Le quatrième caractère (situé juste avant le caractère Null) sépare le symbole monétaire international de la quantité monétaire.
`currency_symbol`, `_W_currency_symbol`	Pointeur vers le symbole monétaire local pour les paramètres régionaux actuels.
`mon_decimal_point`, `_W_mon_decimal_point`	Pointeur vers un caractère décimal pour les quantités monétaires.
`mon_thousands_sep`, `_W_mon_thousands_sep`	Pointeur vers le séparateur pour les groupes de chiffres à gauche de la décimale en quantités monétaires.
`mon_grouping`	Pointeur vers un `char`entier de taille qui contient la taille de chaque groupe de chiffres en quantités monétaires.
`positive_sign`, `_W_positive_sign`	Chaîne indiquant le signe des quantités monétaires non négatives.
`negative_sign`, `_W_negative_sign`	Chaîne indiquant le signe des quantités monétaires négatives.
`int_frac_digits`	Nombre de chiffres à droite du séparateur décimal dans les quantités monétaires à la mise en forme internationale.
`frac_digits`	Nombre de chiffres à droite du séparateur décimal dans les quantités monétaires mises en forme.
`p_cs_precedes`	Défini sur 1 si le symbole monétaire précède la valeur pour une quantité monétaire mise en forme non négative. Défini sur 0 si le symbole suit la valeur.
`p_sep_by_space`	Défini sur 1 si le symbole monétaire est séparé par un espace de la valeur dans le cas d’une quantité monétaire mise en forme non négative. Défini sur 0 s’il n’y a pas de séparation d’espace.
`n_cs_precedes`	Défini sur 1 si le symbole monétaire précède la valeur dans le cas d’une quantité monétaire mise en forme négative. Défini sur 0 si le symbole suit la valeur.
`n_sep_by_space`	Défini sur 1 si le symbole monétaire est séparé par un espace de la valeur dans le cas d’une quantité monétaire mise en forme négative. Défini sur 0 s’il n’y a pas de séparation d’espace.
`p_sign_posn`	En quantités monétaires non mises en forme non gatives, position du signe positif.
`n_sign_posn`	En quantités monétaires mises en forme négatives, position du signe positif.

À l’exception de ce qui est spécifié, les membres de la lconv structure qui ont char * et wchar_t * les versions sont des pointeurs vers des chaînes. Tout membre qui est égal "" à (ou L"" pour wchar_t *) est égal à zéro ou non pris en charge dans les paramètres régionaux actuels. Les deux decimal_point sont _W_decimal_point toujours pris en charge et ont une longueur différente de zéro.

Les char membres de la structure sont de petits nombres non négatifs, pas de caractères. Tout membre égal CHAR_MAX n’est pas pris en charge dans les paramètres régionaux actuels.

Les valeurs des grouping valeurs et mon_grouping sont interprétées en fonction des règles suivantes :

CHAR_MAX - N’effectuez aucun regroupement supplémentaire.
0 - Utilisez l’élément précédent pour chacun des chiffres restants.
n - Nombre de chiffres qui composent le groupe actuel. L’élément suivant est examiné pour déterminer la taille du groupe de chiffres suivant situé avant le groupe actuel.

Les valeurs pour int_curr_symbol elles sont interprétées en fonction des règles suivantes :

Les trois premiers caractères spécifient le symbole monétaire international alphabétique tel que le définit la norme ISO 4217 sur les codes de représentation des monnaies et des fonds.
Le quatrième caractère (situé juste avant le caractère Null) sépare le symbole monétaire international de la quantité monétaire.

Les valeurs pour p_cs_precedes et n_cs_precedes sont interprétées conformément aux règles suivantes (la n_cs_precedes règle est entre parenthèses) :

0 - Le symbole monétaire suit la valeur pour la valeur monétaire non négative (négative).
1 - Le symbole monétaire précède la valeur pour la valeur monétaire non négative (négative).

Les valeurs pour p_sep_by_space et n_sep_by_space sont interprétées conformément aux règles suivantes (la n_sep_by_space règle est entre parenthèses) :

0 - Le symbole monétaire est séparé de la valeur par espace pour la valeur monétaire non négative (négative).
1 - Il n’y a pas de séparation d’espace entre le symbole monétaire et la valeur pour la valeur monétaire non négative (négative) mise en forme.

Les valeurs pour p_sign_posn et n_sign_posn sont interprétées en fonction des règles suivantes :

0 - Parenthèses entourent la quantité et le symbole monétaire.
1 - La chaîne de signe précède la quantité et le symbole monétaire.
2 - La chaîne de signe suit la quantité et le symbole monétaire.
3 - La chaîne de signe précède immédiatement le symbole monétaire.
4 - La chaîne de signe suit immédiatement le symbole monétaire.

Par défaut, l’état global de cette fonction est limité à l’application. Pour modifier ce comportement, consultez État global dans le CRT.

Spécifications

Routine	En-tête requis
`localeconv`	<locale.h>

Pour plus d’informations sur la compatibilité, consultez Compatibility.

Bibliothèques

Toutes les versions des bibliothèques Runtime C.

Voir aussi

Paramètres régionaux
setlocale
strcoll, fonctions
strftime, , wcsftime_strftime_l, ,_wcsftime_l
strxfrm, , wcsxfrm_strxfrm_l, ,_wcsxfrm_l

Partager via