localeconv(3C)															    localeconv(3C)

NAME

       localeconv() - query the numeric formatting conventions of the current locale

SYNOPSIS

DESCRIPTION

       The  function  sets the components of an object of type (defined in with values appropriate for the formatting of numeric quantities (mone-
       tary and otherwise) according to the rules of the program's current locale (see setlocale(3C)).

       The members of the structure with type are strings, any of which (except can point to "" (the empty string) to indicate that the  value	is
       not  available in the current locale or is of zero length.  The members with type are non-negative numbers, any of which can be (defined in
       to indicate that the value is not available in the current locale.  The members include the following:

	      The decimal point character used to format nonmonetary quantities.
			This is the same value as that returned by a call to with as its argument (see nl_langinfo(3C)).

	      The character used to separate groups of digits
			to the left of the decimal point character in formatted nonmonetary quantities.  This is the same value as  that  returned
			by a call to with as its argument (see nl_langinfo(3C)).

	      A string where the numeric value of each byte
			indicates the size of each group of digits in formatted nonmonetary quantities.

	      The international currency symbol applicable to the current locale.
			The  first three characters contain the alphabetic international currency symbol in accordance with those specified in The
			fourth character (immediately preceding the null character) is the character used to separate the  international  currency
			symbol from the monetary quantity.

	      The local currency symbol applicable to the current locale.
			This value along with positioning information is returned by a call to with as its argument (see nl_langinfo(3C)).

	      The decimal point used to format monetary quantities.

	      The separator for groups of digits to the left of the decimal point
			in formatted monetary quantities.

	      A string where the numeric value of each byte
			indicates the size of each group of digits in formatted monetary quantities.

	      The string used to indicate a positive valued
			formatted monetary quantity.

	      The string used to indicate a negative valued
			formatted monetary quantity.

	      The number of fractional digits
			(those to the right of the decimal point) to be displayed in an internationally formatted monetary quantity.

	      The number of fractional digits
			(those to the right of the decimal point) to be displayed in a locally formatted monetary quantity.

	      Set to 1 or 0 if the
			precedes or succeeds the value for a non-negative formatted monetary quantity.

	      Set to a value indicating the separation of the
			the sign string, and the value of a non-negative formatted monetary quantity.

	      Set to 1 or 0 if the
			precedes or succeeds the value for a negative formatted monetary quantity.

	      Set to a value indicating the separation of the
			the sign string, and the value of a negative formatted monetary quantity.

	      Set to a value indicating the positioning of the
			for a non-negative formatted monetary quantity.

	      Set to a value indicating the positioning of the
			for a negative formatted monetary quantity.

       The following members are also available to UNIX 2003 conforming applications:

	      Set to 1 or 0 if the
			precedes or succeeds the value for a non-negative internationally formatted monetary quantity.

	      Set to a value indicating the separation of the
			the sign string, and the value of a non-negative internationally formatted monetary quantity.

	      Set to 1 or 0 if the
			precedes or succeeds the value for a negative internationally formatted monetary quantity.

	      Set to a value indicating the separation of the
			the sign string, and the value of a negative internationally formatted monetary quantity.

	      Set to a value indicating the positioning of the
			for a non-negative internationally formatted monetary quantity.

	      Set to a value indicating the positioning of the
			for a negative internationally formatted monetary quantity.

       The numeric value of each byte of and is interpreted according to the following:

	      No further grouping is to be performed.

	      The previous byte is to be repeatedly used
			for the remainder of the digits.

	      other	The value is the number of digits that comprise the current group.  The next byte is examined to determine the size of the
			next group of digits to the left of the current group.

       The values of and are interpreted according to the following:

	      No space separates the currency symbol and value.

	      If the currency symbol and sign string are adjacent, a space separates
			them from the value; otherwise, a space separates the currency symbol from the value.

	      If the currency symbol and sign string are adjacent, a space separates
			them; otherwise, a space separates the sign string from the value.

       For and the fourth character of is used instead of a space for UNIX 2003 conforming applications.

       The values of and are interpreted according to the following:

	      Parentheses surround the quantity and
			or

	      The sign string precedes the quantity and
			or

	      The sign string succeeds the quantity and
			or

	      The sign string immediately precedes the
			or

	      The sign string immediately succeeds the
			or

       behaves as if no library function calls

EXTERNAL INFLUENCES

   Locale
       The category influences the and members of the structure referenced by the pointer returned from a call to

       The category influences all of the other members of this structure.

   International Code Set Support
       Single and multibyte character codesets are supported.

RETURN VALUE

       returns a pointer to the filled-in

EXAMPLES

       The following table illustrates the formatting used in five languages for monetary quantities.

				       +---------------+-----------------+-----------------+----------------------+
				       |   Country     | Positive format | Negative format | International format |
				       +---------------+-----------------+-----------------+----------------------+
				       |en_US.iso88591 |   $1,234.56	 |   -$1,234.56    |	 USD 1,234.56	  |
				       +---------------+-----------------+-----------------+----------------------+
				       |it_IT.iso88591 |   L.1.234	 |   -L.1.234	   |	 ITL.1.234	  |
				       +---------------+-----------------+-----------------+----------------------+
				       |nl_NL.iso88591 |   F 1.234,56	 |   F -1.234,56   |	 NLG 1.234,56	  |
				       +---------------+-----------------+-----------------+----------------------+
				       |no_NO.iso88591 |   kr1.234,56	 |   kr1.234,56-   |	 NOK 1.234,56	  |
				       +---------------+-----------------+-----------------+----------------------+
				       |pt_PT.iso88591 |   1,234$56	 |   -1,234$56	   |	 PTE 1,234$56	  |
				       +---------------+-----------------+-----------------+----------------------+
       For these five languages, the respective values for the monetary members of the structure returned by are:

					+------------------+----------+-----------+----------+----------+--------+
					|		   |  en_US.  |  it_IT.   |  nl_NL.  |	no_NO.	| pt_PT. |
					|	 iso88591  | iso88591 | .iso88591 | iso88591 | iso88591 |	 |
					+------------------+----------+-----------+----------+----------+--------+
					|int_curr_symbol   |   USD    |   ITL.	  |   NLG    |	 NOK	|  PTE	 |
					+------------------+----------+-----------+----------+----------+--------+
					|currency_symbol   |	$     |    L.	  |    F     |	  kr	|   $	 |
					+------------------+----------+-----------+----------+----------+--------+
					|mon_decimal_point |	.     |    ""	  |    ,     |	  ,	|   $	 |
					+------------------+----------+-----------+----------+----------+--------+
					|mon_thousands_sep |	,     |     .	  |    .     |	  .	|   ,	 |
					+------------------+----------+-----------+----------+----------+--------+
					|mon_grouping	   |	3    |    3	  |    3    |	  3	|   3	 |
					+------------------+----------+-----------+----------+----------+--------+
					|positive_sign	   |	""    |    ""	  |    ""    |	  ""	|   ""	 |
					+------------------+----------+-----------+----------+----------+--------+
					|negative_sign	   |	-     |     -	  |    -     |	  -	|   -	 |
					+------------------+----------+-----------+----------+----------+--------+
					|int_frac_digits   |	2     |     0	  |    2     |	  2	|   2	 |
					+------------------+----------+-----------+----------+----------+--------+
					|frac_digits	   |	2     |     0	  |    2     |	  2	|   2	 |
					+------------------+----------+-----------+----------+----------+--------+
					|p_cs_precedes	   |	1     |     1	  |    1     |	  1	|   0	 |
					+------------------+----------+-----------+----------+----------+--------+
					|p_sep_by_space    |	0     |     0	  |    1     |	  0	|   0	 |
					+------------------+----------+-----------+----------+----------+--------+
					|n_cs_precedes	   |	1     |     1	  |    1     |	  1	|   0	 |
					+------------------+----------+-----------+----------+----------+--------+
					|n_sep_by_space    |	0     |     0	  |    1     |	  0	|   0	 |
					+------------------+----------+-----------+----------+----------+--------+
					|p_sign_posn	   |	1     |     1	  |    1     |	  1	|   1	 |
					+------------------+----------+-----------+----------+----------+--------+
					|n_sign_posn	   |	4     |     1	  |    4     |	  2	|   1	 |
					+------------------+----------+-----------+----------+----------+--------+
WARNINGS

       The structure returned by should not be modified by the calling program.  Calls to with categories or can overwrite  the  contents  of  the
       structure that points to when it returns (see setlocale(3C)).

AUTHOR

       was developed by OSF and HP.

SEE ALSO

       nl_langinfo(3C), setlocale(3C), localedef(4), langinfo(5), thread_safety(5).

STANDARDS CONFORMANCE

																    localeconv(3C)