Freigeben über

localeconv

  • Artikel

Ruft detaillierte Informationen über Gebietsschemaeinstellungen ab.

Syntax

struct lconv *localeconv( void );

Rückgabewert

localeconv gibt einen Zeiger auf ein gefülltes Objekt vom Typ struct lconvzurück. Die im Objekt enthaltenen Werte werden aus den Gebietsschemaeinstellungen im threadlokalen Speicher kopiert und können durch nachfolgende Aufrufe localeconvüberschrieben werden. Änderungen an den Werten in diesem Objekt ändern die Gebietsschemaeinstellungen nicht. setlocale Aufrufe mit category Werten von LC_ALL, LC_MONETARYoder LC_NUMERIC überschreiben den Inhalt der Struktur.

Hinweise

Die localeconv-Funktion ruft detaillierte Informationen zur numerischen Formatierung für das aktuelle Gebietsschema ab. Diese Informationen werden in einer Struktur des Typs lconvgespeichert. Die lconv struktur, die in LOCALE definiert ist. H, enthält die folgenden Elemente:

Feld Bedeutung
decimal_point,
_W_decimal_point		 Zeiger auf Dezimalkommazeichen für nichtmonetäre Mengen.
thousands_sep,
_W_thousands_sep		 Zeiger auf Zeichen, das Gruppen von Ziffern nach links vom Dezimalkomma für nichtmonetäre Mengen trennt.
grouping Zeiger auf eine charganzzahlige Größe, die die Größe jeder Gruppe von Ziffern in nichtmonetären Mengen enthält.
int_curr_symbol,
_W_int_curr_symbol		 Zeiger auf internationales Währungssymbol für das aktuelle Gebietsschema. Die ersten drei Zeichen geben das alphabetische internationale Währungssymbol an, wie im Standard ISO 4217 – Codes für die Darstellung der Währung und Fonds definiert. Das vierte Zeichen (unmittelbar vorausgehendes Zeichen NULL) trennt das internationale Währungssymbol von der monetären Menge.
currency_symbol,
_W_currency_symbol		 Zeiger auf das Lokale Währungssymbol für das aktuelle Gebietsschema.
mon_decimal_point,
_W_mon_decimal_point		 Zeiger auf Dezimalkommazeichen für monetäre Mengen.
mon_thousands_sep,
_W_mon_thousands_sep		 Zeiger zum Trennzeichen für Zifferngruppen links neben dezimaler Stelle in monetären Mengen.
mon_grouping Zeiger auf eine charganzzahlige Größe, die die Größe jeder Gruppe von Ziffern in monetären Mengen enthält.
positive_sign,
_W_positive_sign		 Die Zeichenfolge, die das Zeichen für nicht negative monetären Mengen angibt.
negative_sign,
_W_negative_sign		 Die Zeichenfolge, die das Zeichen für negative monetären Mengen angibt.
int_frac_digits Die Anzahl der Ziffern rechts vom Dezimaltrennzeichen in international formatierten monetären Mengen.
frac_digits Die Anzahl der Ziffern rechts vom Dezimaltrennzeichen in formatierten monetären Mengen.
p_cs_precedes Auf 1 festgelegt, wenn dem Währungssymbol ein Wert für eine nicht negative, formatierte monetäre Menge vorangeht. Auf 0 festgelegt, wenn das Symbol einem Wert folgt.
p_sep_by_space Auf 1 festgelegt, wenn das Währungssymbol durch Leerzeichen von einem Wert für eine nicht negative, formatierte monetäre Menge getrennt ist. Wird auf 0 festgelegt, wenn keine Leerraumtrennung vorhanden ist.
n_cs_precedes Auf 1 festgelegt, wenn dem Währungssymbol ein Wert für eine negative, formatierte monetäre Menge vorangeht. Auf 0 festgelegt, wenn das Symbol einem Wert nachfolgt.
n_sep_by_space Auf 1 festgelegt, wenn das Währungssymbol durch Leerzeichen von einem Wert für eine negative, formatierte monetäre Menge getrennt ist. Wird auf 0 festgelegt, wenn keine Leerraumtrennung vorhanden ist.
p_sign_posn In nichtegativen formatierten geldpolitischen Mengen, Position des positiven Zeichens.
n_sign_posn In negativen formatierten geldpolitischen Mengen, Position des positiven Zeichens.

Außer wie angegeben, sind Elemente der Struktur, die lconv über char * und wchar_t * Versionen verfügen, Zeiger auf Zeichenfolgen. Jedes Element, das gleich "" (oder L"" für wchar_t *) ist, ist eine der Länge null oder wird im aktuellen Gebietsschema nicht unterstützt. Beide decimal_point und _W_decimal_point werden immer unterstützt und weisen eine Nichtzerolänge auf.

Die char Elemente der Struktur sind kleine, nicht negative Zahlen und keine Zeichen. Jedes Element, das gleich ist CHAR_MAX , wird im aktuellen Gebietsschema nicht unterstützt.

Die Werte und grouping mon_grouping werden gemäß den folgenden Regeln interpretiert:

  • CHAR_MAX - Führen Sie keine weitere Gruppierung durch.

  • 0 – Verwenden Sie das vorherige Element für jede der verbleibenden Ziffern.

  • n - Anzahl der Stellen, aus denen sich die aktuelle Gruppe klammert. Das nächste Element wird untersucht, um die Größe der nächsten Gruppe von Zeichen vor der aktuellen Gruppe zu bestimmen.

Die Werte für int_curr_symbol diese Werte werden gemäß den folgenden Regeln interpretiert:

  • Die ersten drei Zeichen geben das alphabetische internationale Währungssymbol an, wie im Standard ISO 4217 – Codes für die Darstellung der Währung und Fonds definiert.

  • Das vierte Zeichen (unmittelbar vorausgehendes Zeichen NULL) trennt das internationale Währungssymbol von der monetären Menge.

Die Werte für p_cs_precedes und n_cs_precedes werden gemäß den folgenden Regeln interpretiert (die n_cs_precedes Regel ist in Klammern):

  • 0 - Währungssymbol folgt dem Wert für einen nichtegativen (negativen) Währungswert.

  • 1 – Währungssymbol steht vor dem Wert für nicht-negative (negative) Währungswerte.

Die Werte für p_sep_by_space und n_sep_by_space werden gemäß den folgenden Regeln interpretiert (die n_sep_by_space Regel ist in Klammern):

  • 0 – Währungssymbol wird durch Leerzeichen für nicht negative (negative) Währungswerte getrennt.

  • 1 – Es gibt keine Abstandstrennung zwischen Währungssymbol und Wert für nicht-negative (negative) Währungswerte.

Die Werte für p_sign_posn und n_sign_posn werden gemäß den folgenden Regeln interpretiert:

  • 0 – Klammern umgeben Menge und Währungssymbol.

  • 1 - Vorzeichenzeichenfolge steht vor Menge und Währungssymbol.

  • 2 - Zeichenzeichenfolge folgt Menge und Währungssymbol.

  • 3 – Vor dem Währungssymbol steht die Zeichenfolge unmittelbar vor dem Zeichenzeichen.

  • 4 – Zeichenzeichenfolge folgt sofort dem Währungssymbol.

Standardmäßig gilt der globale Zustand dieser Funktion für die Anwendung. Wie Sie dieses Verhalten ändern, erfahren Sie unter Globaler Status in der CRT.

Anforderungen

Routine Erforderlicher Header
localeconv <locale.h>

Weitere Informationen zur Kompatibilität finden Sie unter Kompatibilität.

Libraries

Alle Versionen der C-Laufzeitbibliotheken.

Siehe auch

Gebietsschema
setlocale
strcoll -Funktionen
strftime, , wcsftime_strftime_l_wcsftime_l
strxfrm, , wcsxfrm_strxfrm_l_wcsxfrm_l