localeconv man page on DigitalUNIX

Man page or keyword search:  
man Server   12896 pages
apropos Keyword Search (all sections)
Output format
DigitalUNIX logo
[printable version]

localeconv(3)							 localeconv(3)

NAME
       localeconv - Retrieve locale-dependent formatting parameters

SYNOPSIS
       #include <locale.h>

       struct lconv *localeconv(
	       void );

LIBRARY
       Standard C Library (libc)

STANDARDS
       Interfaces  documented on this reference page conform to industry stan‐
       dards as follows:

       localeconv(): XSH5.0

       Refer to the standards(5) reference page	 for  more  information	 about
       industry standards and associated tags.

DESCRIPTION
       The  localeconv() function provides access to the object that specifies
       the current locale's conventions for the format of numeric quantities.

       The lconv structure contains values appropriate for formatting  numeric
       quantities  (monetary and otherwise) according to the rules of the cur‐
       rent locale. The members of the structure with  the  type  char	*  are
       pointers to strings, any of which (except decimal_point) can point to a
       null string, to indicate that the value is not available in the current
       locale or is of zero length. The members with type char are nonnegative
       numbers, any of which can be CHAR_MAX 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.  The
       separator for groups of digits to the left of the decimal point in for‐
       matted nonmonetary quantities.  A string whose  elements	 indicate  the
       size  of each group of digits in formatted nonmonetary quantities.  The
       international currency symbol applicable to  the	 current  locale.  The
       first  three  characters	 of this value contain the alphabetic interna‐
       tional currency symbol  in  accordance  with  those  specified  in  ISO
       4217:1987,  Codes  for  the  Representation  of Currency and Funds. The
       fourth character (immediately preceding the  null  terminator)  is  the
       character  used	to separate the international currency symbol from the
       monetary quantity.  The local currency symbol applicable to the current
       locale.	 The  decimal  point  used to format monetary quantities.  The
       separator for groups of digits to the left of the decimal point in for‐
       matted  monetary quantities.  A string whose elements indicate the size
       of each group of digits in formatted monetary quantities.   The	string
       used  to	 indicate  a  nonnegative,  formatted  monetary quantity.  The
       string used to indicate a negative, 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 formatted monetary quantity.  Set to 1 if the cur‐
       rency_symbol  or	 int_curr_symbol precedes the value for a nonnegative,
       formatted monetary quantity. Set to 0 (zero) if the symbol succeeds the
       value.  Set to 1 if the currency_symbol or int_curr_symbol is separated
       by a space from the value for a nonnegative  formatted  monetary	 quan‐
       tity.  Set  to  0 (zero) if the symbol is not separated by a space from
       the value. Set to 2 if a	 space	separates  the	symbol	and  the  sign
       string, if adjacent.  Set to 1 if he currency_symbol or int_curr_symbol
       precedes the value for a negative, formatted monetary quantity. Set  to
       0  (zero)  if  the  symbol  succeeds  the  value.  Set to 1 if the cur‐
       rency_symbol or int_curr_symbol is separated by a space from the	 value
       for  a  negative,  formatted  monetary quantity. Set to 0 (zero) if the
       symbol is not separated by a space from the value. Set to 2 if a	 space
       separates  the symbol and the sign string, if adjacent.	Set to a value
       that indicates the positioning of the positive_sign for a  nonnegative,
       formatted  monetary  quantity.  Set to a value that indicates the posi‐
       tioning of the negative_sign for a negative, formatted  monetary	 quan‐
       tity.   [Tru64 UNIX]  The left bracket used to display a negative, for‐
       matted monetary quantity. This is the locale's equivalent  to  the  "("
       (left parenthesis) used in the C locale and is used in conjunction with
       the right_parenthesis.  [Tru64 UNIX]  The right bracket used to display
       a  negative,  formatted monetary quantity. This is the locale's equiva‐
       lent to the ")" (right parenthesis) used in the C locale and is used in
       conjunction with the left_parenthesis.

       The  elements of grouping and mon_grouping are interpreted according to
       the following: No further grouping is to be  performed.	 The  previous
       element	is to be repeatedly used for the remainder of the digits.  The
       integer value is the number of digits that comprise the current	group.
       The next element is examined to determine the size of the next group of
       digits to the left of the current group.

       The values of p_sign_posn and n_sign_posn are interpreted according  to
       the following: Parentheses surround the quantity and currency_symbol or
       int_curr_symbol.	 The  sign  string  precedes  the  quantity  and  cur‐
       rency_symbol or int_curr_symbol.	 The sign string succeeds the quantity
       and currency_symbol or int_curr_symbol.	The  sign  string  immediately
       precedes the currency_symbol or int_curr_symbol.	 The sign string imme‐
       diately succeeds the currency_symbol or int_curr_symbol.

RETURN VALUES
       The localeconv() function returns a pointer to  the  filled-in  object.
       The  structure  pointed	to by the return value must not be modified by
       the program, but can be overwritten by a subsequent call to the locale‐
       conv()  function.  In  addition, calls to the setlocale() function with
       categories LC_ALL, LC_MONETARY or LC_NUMERIC may overwrite the contents
       of the structure. No errors are defined for this function.

SEE ALSO
       Functions: nl_langinfo(3), setlocale(3), strfmon(3)

       Others: i18n_intro(5), l10n_intro(5), standards(5)

       Writing Software for the International Market

								 localeconv(3)
[top]

List of man pages available for DigitalUNIX

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