localeconv - Retrieve Information from the Environment

Syntax

#include <locale.h>
struct lconv *localeconv(void);

localeconv retrieves information about the environment for the current locale and places the information in a structure of type struct lconv. Subsequent calls to localeconv, or to setlocale with the argument LC_ALL, LC_MONETARY, or LC_NUMERIC, can overwrite the structure.

The structure contains the members listed below. Pointers to strings with a value of "" indicate that the value is not available in this locale or is of zero length. Character types with a value of CHAR_MAX indicate that the value is not available in this locale. кФФФФФФФФФФФФФФФФФФФФФФТФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФП
Г Element Г Purpose of Element Г
УФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г "char Г Decimal-point character for formatting Г
Г *decimal_point" Г nonmonetary quantities. Г
УФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г "char Г Character used to separate groups of Г
Г *thousands_sep" Г digits to the left of the decimal-point Г
Г Г character in formatted nonmonetary quan- Г
Г Г tities. Г
УФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г "char *grouping" Г Size of each group of digits in for- Г
Г Г matted nonmonetary quantities. The Г
Г Г value of each character in the string Г
Г Г determines the number of digits in a Г
Г Г group. "CHAR_MAX" indicates that there Г
Г Г are no further groupings. If the last Г
Г Г integer is not "CHAR_MAX", then the size Г
Г Г of the previous group will be used for Г
Г Г the remainder of the digits. Г
УФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г "char Г International currency symbol. The Г
Г *int_curr_symbol" Г first three characters contain the Г
Г Г alphabetic international currency Г
Г Г symbol. The fourth character (usually a Г
Г Г space) separates the international cur- Г
Г Г rency symbol from the monetary quantity. Г
УФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г "char Г Local currency symbol. Г
Г *currency_symbol" Г Г
УФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г "char Г Decimal-point character for formatting Г
Г *mon_decimal_point" Г monetary quantities. Г
УФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г "char Г Separator for digits in formatted mone- Г
Г *mon_thousands_sep" Г tary quantities. Г
УФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г "char *mon_grouping" Г Size of each group of digits in for- Г
Г Г matted monetary quantities. The value Г
Г Г of each character in the string deter- Г
Г Г mines the number of digits in a group. Г
Г Г "CHAR_MAX" indicates that there are no Г
Г Г further groupings. If the last integer Г
Г Г is not "CHAR_MAX", then the size of the Г
Г Г previous group will be used for the Г
Г Г remainder of the digits. Г
УФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г "char Г Positive sign used in monetary quanti- Г
Г *positive_sign" Г ties. Г
УФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г "char Г Negative sign used in monetary quanti- Г
Г *negative_sign" Г ties. Г
УФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г "char Г Mumber of displayed digits to the right Г
Г int_frac_digits" Г of the decimal place for internationally Г
Г Г formatted monetary quantities. Г
УФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г "char frac_digits" Г Number of digits to the right of the Г
Г Г decimal place in monetary quantities. Г
УФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г "char p_cs_precedes" Г 1 if the "currency_symbol" precedes the Г
Г Г value for a nonnegative formatted mone- Г
Г Г tary quantity; "0" if it does not. Г
УФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г "char Г 1 if the "currency_symbol" is separated Г
Г p_sep_by_space" Г by a space from the value of a nonnega- Г
Г Г tive formatted monetary quantity; "0" Г
Г Г if it is not. Г
УФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г "char n_cs_precedes" Г 1 if the "currency_symbol" precedes the Г
Г Г value for a negative formatted monetary Г
Г Г quantity; "0" if it does not. Г
УФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г "char Г 1 if the "currency_symbol" is separated Г
Г n_sep_by_space" Г by a space from the value of a negative Г
Г Г formatted monetary quantity; "0" if it Г
Г Г is not. Г
УФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г "char p_sign_posn" Г Position of the "positive_sign" for a Г
Г Г nonnegative formatted monetary quantity. Г
УФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г "char n_sign_posn" Г Position of the "negative_sign" for a Г
Г Г negative formatted monetary quantity. Г
РФФФФФФФФФФФФФФФФФФФФФФСФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФй
кФФФФФФФФФФФФФФФФФФФФФФТФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФП
Г "char Г Symbol to appear to the left of a Г
Г *left_parenthesis" Г negative-valued monetary symbol (such as Г
Г Г a loss or deficit). Г
УФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г "char Г Symbol to appear to the right of a Г
Г *right_parenthesis" Г negative-valued monetary symbol (such as Г
Г Г a loss or deficit). Г
УФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г "char *debit_sign" Г String to indicate a non-negative-valued Г
Г Г formatted monetary quantity. Г
УФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г "char *credit_sign" Г String to indicate a negative-valued Г
Г Г formatted monetary quantity. Г
РФФФФФФФФФФФФФФФФФФФФФФСФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФй

The grouping and mon_grouping members can have the following values:

Value

Meaning

No further grouping is to be performed.

The previous element is to be repeatedly used for the rest of the digits.

The number of digits that comprise the current group. The next element is examined to determine the size of the next group of digits before the current group.

The n_sign_posn and p_sign_posn elements can have the following values:

Value

Meaning

The quantity and currency_symbol are enclosed in parentheses.

The sign precedes the quantity and currency_symbol.

The sign follows the quantity and currency_symbol.

The sign precedes the currency_symbol.

The sign follows the currency_symbol.

localeconv returns a pointer to the lconv structure. Calls to setlocale with the categories LC_ALL, LC_MONETARY, or LC_NUMERIC may overwrite the contents of the structure.

This example prints out the default decimal point for your locale and then the decimal point for the Fr_FR.IBM-850 locale.

#include <stdio.h>#include <locale.h>

int main(void)
{
   struct lconv *mylocale;

   mylocale = localeconv();
   printf("Default decimal point is a %s\n", mylocale->decimal_point);

   if (NULL != setlocale(LC_ALL, Fr_FR.IBM-850)) {
      mylocale = localeconv();
      printf("France's decimal point is a %s\n", mylocale->decimal_point);
   } else {
      printf("setlocale(LC_ALL, Fr_FR.IBM-850) returned <NULL>\n");
    }
   return 0;

   /****************************************************************************
      The output should be similar to :

      Default decimal point is a .
      France's decimal point is a ,
   ****************************************************************************/
}

setlocale

[Back]

[Next]