localeconv

Pobiera szczegółowe informacje na temat ustawień regionalnych.

Składnia

struct lconv *localeconv( void );

Wartość zwracana

localeconv Zwraca wskaźnik do wypełnionego obiektu typu struct lconv. Wartości zawarte w obiekcie są kopiowane z ustawień regionalnych w magazynie lokalnym wątku i mogą zostać zastąpione przez kolejne wywołania metody localeconv. Zmiany wprowadzone w wartościach w tym obiekcie nie modyfikują ustawień regionalnych. Wywołania metody setlocale z wartościami categoryLC_ALL, LC_MONETARYlub LC_NUMERIC zastępują zawartość struktury.

Uwagi

Funkcja localeconv pobiera szczegółowe informacje o formatowaniu liczbowym dla bieżących ustawień regionalnych. Te informacje są przechowywane w strukturze typu lconv. Struktura zdefiniowana lconv w ustawieniach REGIONALNYCH. H, zawiera następujące elementy członkowskie:

Pole	Znaczenie
decimal_point, _W_decimal_point	Wskaźnik do znaku dziesiętnego dla ilości niemonetowych.
thousands_sep, _W_thousands_sep	Wskaźnik do znaku, który oddziela grupy cyfr po lewej stronie separatora dziesiętnego dla ilości niemonetary.
grouping	Wskaźnik do liczby całkowitej charo rozmiarze, który zawiera rozmiar każdej grupy cyfr w ilościach niemonetarnych.
int_curr_symbol, _W_int_curr_symbol	Wskaźnik do symbolu waluty międzynarodowej dla bieżących ustawień regionalnych. Pierwsze trzy znaki określają alfabetyczny symbol waluty międzynarodowej zgodnie z definicją w kodach ISO 4217 dla standardu Reprezentacja waluty i funduszy . Czwarty znak (bezpośrednio poprzedzający znak null) oddziela symbol waluty międzynarodowej od ilości pieniężnej.
currency_symbol, _W_currency_symbol	Wskaźnik do symbolu waluty lokalnej dla bieżących ustawień regionalnych.
mon_decimal_point, _W_mon_decimal_point	Wskaźnik do znaku dziesiętnego dla ilości pieniężnych.
mon_thousands_sep, _W_mon_thousands_sep	Wskaźnik do separatora dla grup cyfr po lewej stronie miejsca dziesiętnego w ilościach pieniężnych.
mon_grouping	Wskaźnik do liczby całkowitej charo rozmiarze, który zawiera rozmiar każdej grupy cyfr w ilościach pieniężnych.
positive_sign, _W_positive_sign	Ciąg oznaczający znak dla nienegacyjnych ilości pieniężnych.
negative_sign, _W_negative_sign	Ciąg oznaczający znak ujemnych ilości pieniężnych.
int_frac_digits	Liczba cyfr z prawej strony przecinka dziesiętnego w ilościach pieniężnych sformatowanych na arenie międzynarodowej.
frac_digits	Liczba cyfr z prawej strony przecinka dziesiętnego w sformatowanych ilościach pieniężnych.
p_cs_precedes	Ustaw wartość 1, jeśli symbol waluty poprzedza wartość dla nienegacyjnego sformatowanej ilości pieniężnej. Ustaw wartość 0, jeśli symbol jest zgodny z wartością.
p_sep_by_space	Ustaw wartość 1, jeśli symbol waluty jest oddzielony spacją od wartości dla nienegatywnej sformatowanej ilości pieniężnej. Ustaw wartość 0, jeśli nie ma separacji przestrzeni.
n_cs_precedes	Ustaw wartość 1, jeśli symbol waluty poprzedza wartość ujemnej sformatowanej ilości pieniężnej. Ustaw wartość 0, jeśli wartość symbolu powiedzie się.
n_sep_by_space	Ustaw wartość 1, jeśli symbol waluty jest oddzielony spacją od wartości dla ujemnej sformatowanej ilości pieniężnej. Ustaw wartość 0, jeśli nie ma separacji przestrzeni.
p_sign_posn	W nienegacyjnych sformatowanych ilościach pieniężnych pozycja znaku dodatniego.
n_sign_posn	W ujemnych sformatowanych ilościach pieniężnych pozycja znaku dodatniego.

Z wyjątkiem określonych elementów lconv członkowskich struktury, które mają char * i wchar_t * wersje są wskaźniki do ciągów. Każdy element członkowski "" równy (lub L"" dla wchar_t *) ma dowolną długość zerową lub nie jest obsługiwany w bieżących ustawieniach regionalnych. Obie decimal_point i _W_decimal_point są zawsze obsługiwane i mają długość niezerową.

Składowe char struktury są małymi liczbami nie ujemnymi, a nie znakami. Każdy element członkowski, który jest CHAR_MAX równy, nie jest obsługiwany w bieżących ustawieniach regionalnych.

Wartości grouping i mon_grouping są interpretowane zgodnie z następującymi regułami:

• CHAR_MAX - Nie wykonuj dalszych grupowania.

• 0 — użyj poprzedniego elementu dla każdej z pozostałych cyfr.

• n - Liczba cyfr tworzących bieżącą grupę. Następny element jest badany w celu określenia rozmiaru następnej grupy cyfr przed bieżącą grupą.

Wartości parametru int_curr_symbol są interpretowane zgodnie z następującymi regułami:

• Pierwsze trzy znaki określają alfabetyczny symbol waluty międzynarodowej zgodnie z definicją w kodach ISO 4217 dla standardu Reprezentacja waluty i funduszy .

• Czwarty znak (bezpośrednio poprzedzający znak null) oddziela symbol waluty międzynarodowej od ilości pieniężnej.

Wartości i p_cs_precedesn_cs_precedes są interpretowane zgodnie z następującymi regułami (reguła n_cs_precedes jest w nawiasach):

• 0 — symbol waluty jest zgodny z wartością nienegacyjną (ujemną) sformatowaną wartością pieniężną.

• 1 — Symbol waluty poprzedza wartość dla wartości nienegatywnej (ujemnej) sformatowanej wartości pieniężnej.

Wartości i p_sep_by_spacen_sep_by_space są interpretowane zgodnie z następującymi regułami (reguła n_sep_by_space jest w nawiasach):

• 0 — symbol waluty jest oddzielony od wartości spacją dla wartości nienegacyjnej (ujemnej) sformatowanej wartości pieniężnej.

• 1 — nie ma odstępu między symbolem waluty a wartością nienegacyjną (ujemną) sformatowaną wartością pieniężną.

Wartości i p_sign_posnn_sign_posn są interpretowane zgodnie z następującymi regułami:

• 0 — Nawiasy otaczają ilość i symbol waluty.

• 1 — Ciąg znaku poprzedza symbol ilości i waluty.

• 2 — Ciąg znaku jest zgodny z symbolem ilości i waluty.

• 3 — Ciąg znaku bezpośrednio poprzedza symbol waluty.

• 4 — Ciąg znaku natychmiast następuje po symbolu waluty.

Domyślnie stan globalny tej funkcji jest zakresem aplikacji. Aby zmienić to zachowanie, zobacz Stan globalny w CRT.

Wymagania

Procedura	Wymagany nagłówek
localeconv	<locale.h>

Aby uzyskać więcej informacji o zgodności, zobacz Zgodność.

Biblioteki

Wszystkie wersje bibliotek czasu wykonywania języka C.

Zobacz też

ustawienia regionalne
setlocale
strcoll, funkcje
strftime, wcsftime, _strftime_l, _wcsftime_l
strxfrm, wcsxfrm, _strxfrm_l, _wcsxfrm_l