localeconv man page on HP-UX

Man page or keyword search:  
man Server   10987 pages
apropos Keyword Search (all sections)
Output format
HP-UX logo
[printable version]

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 (monetary
       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 mem‐
       bers 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  quanti‐
	      ties.
			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  format‐
			ted 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 format‐
			ted 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 preced‐
			ing the null character) is the character used to sepa‐
			rate  the international currency symbol from the mone‐
			tary 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 format‐
			ted 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  dis‐
			played	in an internationally formatted monetary quan‐
			tity.

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

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

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

	      Set to 1 or 0 if the
			precedes  or succeeds the value for a negative format‐
			ted 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 appli‐
       cations:

	      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 interna‐
			tionally formatted monetary quantity.

	      Set to a value indicating the separation of the
			the  sign string, and the value of a negative interna‐
			tionally 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 mem‐
       bers 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  pro‐
       gram.   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)
[top]

List of man pages available for HP-UX

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net