localeconv

Získá podrobné informace o nastavení národního prostředí.

Syntaxe

struct lconv *localeconv( void );

Vrácená hodnota

localeconv vrátí ukazatel na vyplněný objekt typu struct lconv. Hodnoty obsažené v objektu se zkopírují z nastavení národního prostředí v místním úložišti vlákna a lze je přepsat následnými voláními .localeconv Změny hodnot v tomto objektu nemění nastavení národního prostředí. setlocale Volání s category hodnotami LC_ALL, LC_MONETARYnebo LC_NUMERIC přepsat obsah struktury.

Poznámky

Funkce localeconv získá podrobné informace o číselném formátování pro aktuální národní prostředí. Tyto informace jsou uloženy ve struktuře typu lconv. Struktura definovaná lconv v prostředí LOCALE. H, obsahuje následující členy:

Pole	Význam
decimal_point, _W_decimal_point	Ukazatel na znak desetinné čárky pro nemonetární množství
thousands_sep, _W_thousands_sep	Ukazatel na znak, který odděluje skupiny číslic vlevo od desetinné čárky pro nemonetární množství.
grouping	Ukazatel na charcelé číslo velikosti, které obsahuje velikost každé skupiny číslic v nemonetárních množstvích.
int_curr_symbol, _W_int_curr_symbol	Ukazatel na symbol mezinárodní měny pro aktuální národní prostředí. První tři znaky určují abecední mezinárodní symbol měny definovaný v kódech ISO 4217 pro reprezentaci měny a fondů standard. Čtvrtý znak (bezprostředně před znakem null) odděluje symbol mezinárodní měny od peněžního množství.
currency_symbol, _W_currency_symbol	Ukazatel na symbol místní měny pro aktuální národní prostředí
mon_decimal_point, _W_mon_decimal_point	Ukazatel na znak desetinné čárky pro peněžní množství
mon_thousands_sep, _W_mon_thousands_sep	Ukazatel na oddělovač pro skupiny číslic vlevo od desetinného místa v peněžních množstvích
mon_grouping	Ukazatel na charcelé číslo velikosti, které obsahuje velikost každé skupiny číslic v peněžních množstvích.
positive_sign, _W_positive_sign	Řetězec označující znaménko pro nenegativní peněžní množství
negative_sign, _W_negative_sign	Řetězec označující znaménko záporných peněžních množství
int_frac_digits	Počet číslic napravo od desetinné čárky v mezinárodně formátovaných peněžních množstvích
frac_digits	Počet číslic napravo od desetinné čárky ve formátovaných peněžních množstvích
p_cs_precedes	Nastavte na hodnotu 1, pokud symbol měny předchází hodnotě nenegativního formátovaného peněžního množství. Nastavte na hodnotu 0, pokud se symbol řídí hodnotou.
p_sep_by_space	Pokud je symbol měny oddělený mezerou od hodnoty nenegativního peněžního množství, nastavte na hodnotu 1. Nastavte hodnotu 0, pokud není žádné oddělení mezery.
n_cs_precedes	Nastavte na hodnotu 1, pokud symbol měny předchází hodnotě záporného formátovaného peněžního množství. Pokud je hodnota symbolu úspěšná, nastavte na hodnotu 0.
n_sep_by_space	Pokud je symbol měny oddělený mezerou od hodnoty záporného formátovaného peněžního množství, nastavte na hodnotu 1. Nastavte hodnotu 0, pokud není žádné oddělení mezery.
p_sign_posn	V nenegativních peněžních množstvích je pozice kladného znaménka.
n_sign_posn	V záporných formátovaných peněžních množstvích pozice kladného znaménka.

S výjimkou zadané struktury lconv , které mají char * a wchar_t * verze jsou ukazatele na řetězce. Libovolný člen, který se "" rovná (nebo L"" pro wchar_t *) má nulovou délku nebo není podporován v aktuálním národním prostředí. Obě decimal_point a _W_decimal_point jsou vždy podporovány a mají nenulovou délku.

Členy char struktury jsou malá nezáporná čísla, ne znaky. Jakýkoli člen, který se rovná, CHAR_MAX není v aktuálním národním prostředí podporován.

Hodnoty grouping a mon_grouping jsou interpretovány podle následujících pravidel:

• CHAR_MAX - Neprovádějte žádné další seskupení.

• 0 – Pro každou zbývající číslici použijte předchozí prvek.

• n - Počet číslic, které tvoří aktuální skupinu. Další prvek je zkoumán, aby určil velikost další skupiny číslic před aktuální skupinou.

Hodnoty pro int_curr_symbol jsou interpretovány podle následujících pravidel:

• První tři znaky určují abecední mezinárodní symbol měny definovaný v kódech ISO 4217 pro reprezentaci měny a fondů standard.

• Čtvrtý znak (bezprostředně před znakem null) odděluje mezinárodní symbol měny od peněžního množství.

Hodnoty pro p_cs_precedes a n_cs_precedes jsou interpretovány podle následujících pravidel ( n_cs_precedes pravidlo je v závorkách):

• 0 – Symbol měny se řídí hodnotou pro nenegativní (zápornou) peněžní hodnotu.

• 1 – Symbol měny předchází hodnotě nenegativní (záporné) peněžní hodnoty.

Hodnoty pro p_sep_by_space a n_sep_by_space jsou interpretovány podle následujících pravidel ( n_sep_by_space pravidlo je v závorkách):

• 0 – Symbol měny je oddělen od hodnoty mezerou pro nenegativní (zápornou) peněžní hodnotu.

• 1 – Mezi symbolem měny a hodnotou není žádné oddělení mezery pro nenegativní (zápornou) peněžní hodnotu.

Hodnoty pro p_sign_posn a n_sign_posn jsou interpretovány podle následujících pravidel:

• 0 – závorky obklopují množství a symbol měny.

• 1 – Znakový řetězec předchází množství a symbol měny.

• 2 – Řetězec podpisu se řídí množstvím a symbolem měny.

• 3 – Řetězec podpisu bezprostředně předchází symbolu měny.

• 4 – Řetězec podpisu bezprostředně následuje za symbolem měny.

Ve výchozím nastavení je globální stav této funkce vymezen na aplikaci. Chcete-li toto chování změnit, přečtěte si téma Globální stav v CRT.

Požadavky

Rutina	Požadovaný hlavičkový soubor
localeconv	<národní prostředí.h>

Další informace o kompatibilitě najdete v tématu Kompatibilita.

Knihovny

Všechny verze knihoven runtime jazyka C.

Viz také

Národní prostředí
setlocale
strcoll – funkce
strftime, wcsftime, _strftime_l, _wcsftime_l
strxfrm, wcsxfrm, _strxfrm_l, _wcsxfrm_l