localedef.4 (2010 09)

ManualsBrandsHP ManualsSoftwareHP-UX Manpages

localedef(4) localedef(4)

NAME

localedef - format and semantics of locale deﬁnition ﬁle

DESCRIPTION

This is a description of the syntax and meaning of the locale deﬁnition that is provided as input to the

localedef command to create a locale (see localedef (1M)).

The following is a list of category tags, keywords and subsequent expressions which are recognized by

localedef. The order of keywords within a category is irrelevant with the exception of the

copy key-

word and other exceptions noted under the

LC_COLLATE

description. (Note that, as a convention, the

category tags are composed of uppercase characters, while the keywords are composed of lowercase char-

acters).

Category Tags and Keywords

The following keywords do not belong to any category and should appear in the beginning of the locale

deﬁnition ﬁle:

comment_char

Single character indicating the character to be interpreted as starting a comment line within

the locale deﬁnition ﬁle. This character should be in the ﬁrst column of a comment line. The

default comment_char is #. All lines with a comment_char in the ﬁrst column are ignored.

escape_char

A single character indicating the character to be interpreted as an escape character within the

script. The default escape_char is \. escape_char is used to escape localedef metacharacters

to remove special meaning and in the character constant decimal, octal, and hexadecimal for-

mats. It is also used to continue a line onto the next, if escape_char is the last character on the

line (before the new-line character).

The following keywords can be used in any category:

copy

A string naming another valid locale available on the system. This causes the category in the

locale being created to be a copy of the same category in the named locale. Since the

copy

keyword deﬁnes the entire category, if used, it must be the only keyword in the category.

The following six categories are recognized:

LC_CTYPE:

This category deﬁnes character classiﬁcation, case conversion and other character attributes. The

following predeﬁned character classiﬁcations are recognized:

upper Character codes classiﬁed as uppercase letters. Characters speciﬁed in the

cntrl, digit, punct or space classiﬁcations cannot be speciﬁed in this

category.

lower Character codes classiﬁed as lowercase letters. Same restrictions applicable to

the upper category apply to this classiﬁcation.

digit Character codes classiﬁed as numeric. Only ten characters in contiguous

ascending sequence by numerical value can be speciﬁed. Alternative digits

cannot be speciﬁed here.

space Character codes classiﬁed as white-space. No character speciﬁed for the

upper, lower, alpha, digit, graph or xdigit categories can be

included in this classiﬁcation.

punct Character codes classiﬁed as punctuation characters. No character included

in the upper, lower, alpha, digit, cntrl, xdigit or space categories

can be speciﬁed.

cntrl Character codes classiﬁed as control characters. No character included in the

upper, lower, alpha, digit, punct, graph, print or xdigit can be

included here.

blank Character codes classiﬁed as blank characters. The <space> and <tab> charac-

ters are automatically included.

xdigit Character codes classiﬁed as hexadecimal digits. Only the characters deﬁned

for the digit class can be speciﬁed, followed by one or more sets of six

HP-UX 11i Version 3: September 2010 − 1 − Hewlett-Packard Company 1

Summary of content (10 pages)

PAGE 1
localedef(4) localedef(4) NAME localedef - format and semantics of locale definition file DESCRIPTION This is a description of the syntax and meaning of the locale definition that is provided as input to the localedef command to create a locale (see localedef (1M)). The following is a list of category tags, keywords and subsequent expressions which are recognized by localedef.
PAGE 2
localedef(4) localedef(4) characters, with each set in ascending order. alpha Character codes classified as letters. Characters classified as cntrl, digit, punct or space cannot be specified. Characters specified as upper and lower classes are automatically included in this class. print Character codes classified as printable characters. Characters specified for upper, lower, alpha, digit, xdigit, and punct classes and the character are automatically included.
PAGE 3
localedef(4) localedef(4) forward Specifies that comparison operations proceed from start of string towards the end of it. backward Specifies that comparison operations proceed from end of string towards the beginning of it. order_end Marks the end of the list of collating element entries. LC_MONETARY: The LC_MONETARY category defines the rules and symbols used to format monetary numeric information.
PAGE 4
localedef(4) localedef(4) from the value. 2 If the currency symbol and sign string are adjacent, a space separates them; otherwise, a space separates the sign string from the value. n_cs_precedes The operand is an integer which if set to 1 indicates the currency_symbol precedes a negative monetary quantity, and if set to 0 the symbol succeeds the negative value.
PAGE 5
localedef(4) localedef(4) LC_NUMERIC and END LC_NUMERIC: decimal_point The operand is a string containing the symbol used as the decimal delimiter (radix character) in numeric, non-monetary formatted quantities. This keyword cannot be omitted and cannot be set to the empty string. thousands_sep The operand is a string containing the symbol used as a separator for groups of digits to the left of the decimal delimiter. grouping The operand is a semicolon-separated list of integers.
PAGE 6
localedef(4) localedef(4) start_date A date in the form yyyy /mm /dd where yyyy , mm, and dd are the year, month and day numbers, respectively, of the start of the era. Years prior to the year 0 A.D. are represented as negative numbers. For example, an era beginning March 5th in the year 100 B.C. would be represented as 3-100/3/5. Years in the range [SHRT_MIN+1,SHRT_MAX-1] are supported.
PAGE 7
localedef(4) localedef(4) names separated by semicolons, or a character-code range consisting of a constant or symbolic name followed by an ellipsis followed by another constant or symbolic name. The constant preceding the ellipsis must have a smaller code value than the constant following the ellipsis. A range represents a set of consecutive character codes. If the list is longer than a single line, the escape character must be used at the end of each line as a continuation character.
PAGE 8
localedef(4) localedef(4) integer lists Integer list operands consists of one or more decimal digits separated by semicolons. shift Shift operands follow keywords toupper and tolower, and must consist of two character-code constants enclosed by left and right parentheses and separated by a comma. Each such character pair is separated from the next by a semicolon. For tolower, the first constant represents an uppercase character and the second the corresponding lowercase character.
PAGE 9
localedef(4) localedef(4) ’X’ "AE";’X’ A don’t-care character is defined by the special symbol IGNORE. For example, the dash character, ’-’ may be a don’t care on the first collation pass. The collating element entry is: ’-’ IGNORE;’-’ Symbols defined by the collating-symbol keyword can be used to indicate that a given character collates higher or lower than some position in the sequence.
PAGE 10
(Notes) A (Notes) lA 10 Hewlett-Packard Company −1− HP-UX 11i Version 3: September 2010