Compaq C Run-Time Library Utilities Reference Manual

Document revision date: 30 March 2001

Compaq C Run-Time Library Utilities Reference Manual

Contents

Index

The following is a sample LC_CTYPE category specified in a locale definition source file:

LC_CTYPE #"alpha" is by default "upper" and "lower" #"alnum" is by definition "alpha" and "digit" #"print" is by default "alnum", "punct" and the space character #"graph" is by default "alnum" and "punct" #"tolower" is by default the reverse mapping of "toupper" # upper <A>;;<C>;<D>;<E>;<F>;<G>;<H>;;<J>;<K>;<L>;<M>;\ <N>;<O>;;<Q>;<R>;<S>;<T>;;<V>;<W>;<X>;<Y>;<Z> # lower <a>;;<c>;<d>;<e>;<f>;<g>;<h>;;<j>;<k>;<l>;<m>;\ <n>;<o>;;<q>;<r>;<s>;<t>;;<v>;<w>;<X>;<y>;<z> # digit <zero>;<one>;<two>;<three>;<four>;<five>;<six>;\ <seven>;<eight>;<nine> # space <tab>;<newline>;<vertical-tab>;<form-feed>;\ <carriage-return>;<space> # cntrl <alert>;<backspace>;<tab>;<newline>;<vertical-tab>;\ <form-feed>;<carriage-return>;<NUL>;<SOH>;<STX>;\ <ETX>;<EOT>;<ENQ>;<ACK>;<SO>;<SI>;<DLE>;<DC1>;<DC2>;\ <DC3>;<DC4>;<NAK>;<SYN>;<ETB>;<CAN>;;;\ <ESC>;<IS4>;<IS3>;<IS2>;<IS1>;<DEL> # punct <exclamation-mark>;<quotation-mark>;<number-sign>;\ <dollar-sign>;<percent-sign>;<ampersand>;<asterisk>;\ <apostrophe>;<left-parenthesis>;<right-parenthesis>;\ <plus-sign>;<comma>;<hyphen>;<period>;<slash>;\ <colon>;<semicolon>;<less-than-sign>;<equals-sign>;\ <greater-than-sign>;<question-mark>;<commercial-at>;\ <left-square-bracket>;<backslash>;<circumflex>;\ <right-square-bracket>;<underline>;<grave-accent>;\ <left-curly-bracket>;<vertical-line>;<tilde>;\ <right-curly-bracket> # xdigit <zero>;<one>;<two>;<three>;<four>;<five>;<six>;\ <seven>;<eight>;<nine>;<A>;;<C>;<D>;<E>;<F>;\ <a>;;<c>;<d>;<e>;<f> # blank <space>;<tab> # toupper (<a>,<A>);(,);(<c>,<C>);(<d>,<D>);(<e>,<E>);\ (<f>,<F>);(<g>,<G>);(<h>,<H>);(,);(<j>,<J>);\ (<k>,<K>);(<l>,<L>);(<m>,<M>);(<n>,<N>);(<o>,<O>);\ (,);(<q>,<Q>);(<r>,<R>);(<s>,<S>);(<t>,<T>);\ (,);(<v>,<V>);(<w>,<W>);(<X>,<X>);(<y>,<Y>);\ (<z>,<Z>) # END LC_CTYPE

2.4 LC_MESSAGES Category

The LC_MESSAGES category defines the format for affirmative and negative system responses. This category begins with the LC_MESSAGES header and ends with the END LC_MESSAGES trailer.

All operands for the LC_MESSAGES category are defined as strings or extended regular expressions bounded by double quotation marks ("). These operands are separated from the keyword they define by one or more blank characters (spaces or tabs). Two adjacent double quotation marks ("") indicate an undefined value.

Table 2-3 lists the statement keywords recognized in the LC_MESSAGES category.

Table 2-3 LC_MESSAGES Category Keywords
Keyword Description

copy Specifies the name of an existing locale to be used as the definition of this category.
If you specify a copy statement, you cannot specify any other keyword.

yesexpr Specifies an extended regular expression that describes the acceptable affirmative response to a question expecting an affirmative or negative response.

noexpr Specifies an extended regular expression that describes the acceptable negative response to a question expecting an affirmative or negative response.

yesstr Specifies the locale's equivalent of an acceptable affirmative response.
This string is accessible to applications through the nl_langinfo subroutine as nl_langinfo (YESSTR) . Note that yesstr is likely to be withdrawn from the XPG4 standard; yesexpr is the recommended alternative.

nostr Specifies the locale's equivalent of an acceptable negative response.
This string is accessible to applications through the nl_langinfo subroutine as nl_langinfo (NOSTR) . Note that nostr is likely to be withdrawn from the XPG4 standard; noexpr is the recommended alternative.

**Table 2-3 LC_MESSAGES Category Keywords**
Keyword	Description
`copy`	Specifies the name of an existing locale to be used as the definition of this category. If you specify a `copy` statement, you cannot specify any other keyword.
`yesexpr`	Specifies an extended regular expression that describes the acceptable affirmative response to a question expecting an affirmative or negative response.
`noexpr`	Specifies an extended regular expression that describes the acceptable negative response to a question expecting an affirmative or negative response.
`yesstr`	Specifies the locale's equivalent of an acceptable affirmative response. This string is accessible to applications through the `nl_langinfo` subroutine as `nl_langinfo (YESSTR)` . Note that `yesstr` is likely to be withdrawn from the XPG4 standard; `yesexpr` is the recommended alternative.
`nostr`	Specifies the locale's equivalent of an acceptable negative response. This string is accessible to applications through the `nl_langinfo` subroutine as `nl_langinfo (NOSTR)` . Note that `nostr` is likely to be withdrawn from the XPG4 standard; `noexpr` is the recommended alternative.

The following is a sample LC_MESSAGES category specified in a locale definition source file:

LC_MESSAGES # yesexpr "<circumflex><left-square-bracket><y><Y>\ <right-square-bracket>" noexpr "<circumflex><left-square-bracket><n><N>\ <right-square-bracket>" yesstr "<y><e><s>" nostr "<n><o>" # END LC_MESSAGES

2.5 LC_MONETARY Category

The LC_MONETARY category defines rules and symbols for formatting monetary numeric information. This category begins with the LC_MONETARY header and ends with the END LC_MONETARY trailer.

2.5.1 LC_MONETARY Keywords

All operands for the LC_MONETARY category keywords are defined as string or integer values. String values are bounded by double quotation marks ("). All values are separated from the keyword they define by one or more blank characters (spaces or tabs). Two adjacent double quotation marks ("") indicate an undefined string value. A negative one (-1) indicates an undefined integer value.

Table 2-4 lists the statement keywords recognized in the LC_MONETARY category.

Table 2-4 LC_MONETARY Category Keywords
Keyword Description

copy Specifies the name of an existing locale to be used as the definition of this category.
If you specify a copy statement, you cannot specify any other keyword.

int_curr_symbol Specifies the string used for the international currency symbol.
The operand for this keyword is a 4-character string+. The first three characters contain the alphabetic international currency symbol. The fourth character defines a character separator for insertion between the international currency symbol and a monetary quantity.

currency_symbol Specifies the string used for the local currency symbol.

mon_decimal_point Specifies the decimal delimiter string used for formatting monetary quantities.

mon_thousands_sep Specifies the character separator used for grouping digits to the left of the decimal delimiter in formatted monetary quantities.

mon_grouping Specifies a string that defines the size of each group of digits in formatted monetary quantities.
The operand for this keyword consists of a sequence of integers separated by semicolons. Each integer specifies the number of digits in a group. The first integer defines the size of the group immediately to the left of the decimal delimiter. Subsequent integers define succeeding groups to the left of the previous group. If the last integer is not -1, it is used to group any remaining digits. If the last integer is -1, no further grouping is performed.
A sample interpretation of the mon_grouping statement follows. Assuming a value of 123456789 to be formatted and a mon_thousands_sep operand of ' (single quotation mark), the following results occur:

mon_grouping Formatted Value

3;-1 123456'789

3 123'456'789

3;2;-1 1234'56'789

3;2 12'34'56'789

positive_sign Specifies the string used to indicate a nonnegative-formatted monetary quantity.

negative_sign Specifies the string used to indicate a negative-formatted monetary quantity.

int_frac_digits Specifies an integer value representing the number of fractional digits (those after the decimal delimiter) to be displayed in a formatted monetary quantity using the int_curr_symbol value.

frac_digits Specifies an integer value representing the number of fractional digits (those after the decimal delimiter) to be displayed in a formatted monetary quantity using the currency_symbol value.

p_cs_precedes Specifies an integer value indicating whether the int_curr_symbol or currency_symbol string precedes or follows the value for a nonnegative-formatted monetary quantity.
The following integer values are recognized:

0 The currency symbol follows the monetary quantity.

1 The currency symbol precedes the monetary quantity.

p_sep_by_space Specifies an integer value indicating whether the int_curr_symbol or currency_symbol string is separated by a space from a nonnegative-formatted monetary quantity.
The following integer values are recognized:

0 No space separates the currency symbol from the monetary quantity.

1 A space separates the currency symbol from the monetary quantity.

2 A space separates the currency symbol and the positive_sign string, if adjacent.

n_cs_precedes Specifies an integer value indicating whether the int_curr_symbol or currency_symbol string precedes or follows the value for a negative-formatted monetary quantity.
The following integer values are recognized:

0 The currency symbol follows the monetary quantity.

1 The currency symbol precedes the monetary quantity.

n_sep_by_space Specifies an integer value indicating whether the int_curr_symbol or currency_symbol string is separated by a space from a negative-formatted monetary quantity.
The following integer values are recognized:

0 No space separates the currency symbol from the monetary quantity.

1 A space separates the currency symbol from the monetary quantity.

2 A space separates the currency symbol and the negative_sign string, if adjacent.

p_sign_posn Specifies an integer value indicating the positioning of the positive_sign string for a nonnegative-formatted monetary quantity.
The following integer values are recognized:

0 A left parenthesis and right parenthesis symbol enclose both the monetary quantity and the int_curr_symbol or currency_symbol string.

1 The positive_sign string precedes the quantity and the int_curr_symbol or currency_symbol string.

2 The positive_sign string follows the quantity and the int_curr_symbol or currency_symbol string.

3 The positive_sign string immediately precedes the int_curr_symbol or currency_symbol string.

4 The positive_sign string immediately follows the int_curr_symbol or currency_symbol string.

n_sign_posn Specifies an integer value indicating the positioning of the negative_sign string for a negative-formatted monetary quantity.
The following integer values are recognized:

0 A left parenthesis and right parenthesis symbol enclose both the monetary quantity and the int_curr_symbol or currency_symbol string.

1 The negative_sign string precedes the quantity and the int_curr_symbol or currency_symbol string.

2 The negative_sign string follows the quantity and the int_curr_symbol or currency_symbol string.

3 The negative_sign string immediately precedes the int_curr_symbol or currency_symbol string.

4 The negative_sign string immediately follows the int_curr_symbol or currency_symbol string.

+The current implementation of the Compaq C Run-Time Library allows more than four characters to be specified. However, the user should not rely on this fact and use it exactly as specified. The 4-character limit will be implemented in a future version of the Compaq C Run-Time Library.

2.5.2 Monetary Format Variations

You can produce a unique customized monetary format by changing the value of a single statement. Table 2-5 shows the results of using all combinations of defined values for the p_cs_precedes , p_sep_by_space , and p_sign_posn statements.

Table 2-5 Monetary Format Variations
p_sep_by_space = 2 1 0

p_cs_precedes = 1 p_sign_posn = 0 ($1.25) ($ 1.25) ($1.25)

p_sign_posn = 1 + $1.25 +$ 1.25 +$1.25

p_sign_posn = 2 $1.25 + $ 1.25+ $1.25+

p_sign_posn = 3 + $1.25 +$ 1.25 +$1.25

p_sign_posn = 4 $ +1.25 $+ 1.25 $+1.25

p_cs_precedes = 0 p_sign_posn = 0 (1.25 $) (1.25 $) (1.25$)

p_sign_posn = 1 +1.25 $ +1.25 $ +1.25$

p_sign_posn = 2 1.25$ + 1.25 $+ 1.25$+

p_sign_posn = 3 1.25+ $ 1.25 +$ 1.25+$

p_sign_posn = 4 1.25$ + 1.25 $+ 1.25$+

**Table 2-5 Monetary Format Variations**
	`p_sep_by_space` =	2	1	0
`p_cs_precedes` = 1	`p_sign_posn = 0`	($1.25)	($ 1.25)	($1.25)
	`p_sign_posn` = 1	+ $1.25	+$ 1.25	+$1.25
	`p_sign_posn` = 2	$1.25 +	$ 1.25+	$1.25+
	`p_sign_posn` = 3	+ $1.25	+$ 1.25	+$1.25
	`p_sign_posn` = 4	$ +1.25	$+ 1.25	$+1.25

`p_cs_precedes` = 0	`p_sign_posn` = 0	(1.25 $)	(1.25 $)	(1.25$)
	`p_sign_posn` = 1	+1.25 $	+1.25 $	+1.25$
	`p_sign_posn` = 2	1.25$ +	1.25 $+	1.25$+
	`p_sign_posn` = 3	1.25+ $	1.25 +$	1.25+$
	`p_sign_posn` = 4	1.25$ +	1.25 $+	1.25$+

The following is a sample LC_MONETARY category specified in a locale definition source file:

LC_MONETARY # int_curr_symbol "<S><D><space>" currency_symbol "<dollar-sign>" mon_decimal_point "<period>" mon_thousands_sep "<comma>" mon_grouping 3 positive_sign "<plus-sign>" negative_sign "<hyphen>" int_frac_digits 2 frac_digits 2 p_cs_precedes 1 p_sep_by_space 2 n_cs_precedes 1 n_sep_by_space 2 p_sign_posn 3 n_sign_posn 3 # END LC_MONETARY

Contents

Index

privacy and legal statement

6494PRO_002.HTML