langinfo(5) langinfo(5)
NAME [Toc] [Back]
langinfo - language information constants
SYNOPSIS [Toc] [Back]
#include <langinfo.h>
DESCRIPTION [Toc] [Back]
This header file contains the constants used to identify items of
langinfo data (see nl_langinfo(3C)). The mode of items is given in
<nl_types.h>. The following constants are defined. (Category
indicates in which setlocale(3C) category each item is defined).
Constant Category Description
_______________________________________________________________
CODESET LC_CTYPE Codeset name, such as iso88591 and
eucJP.
D_T_FMT LC_TIME String for formatting the %c (date
and time) directive of date(1),
getdate(3C), and strftime(3C).
D_FMT LC_TIME String for formatting the %x (date)
directive of date(1), getdate(3C),
and strftime(3C).
T_FMT LC_TIME String for formatting the %X (time)
directive of date(1), getdate(3C),
and strftime(3C).
T_FMT_AMPM LC_TIME Time representation in the 12 hour
clock format with AM_STR and
PM_STR.
AM_STR LC_TIME Ante meridiem string used with 12
hour time formats (AM in English).
PM_STR LC_TIME Post meridiem string used with 12
hour time formats (PM in English).
DAY_1 LC_TIME Name of the first day of the week
(Sunday in English).
... ... ...
DAY_7 LC_TIME Name of the seventh day of the
week.
ABDAY_1 LC_TIME Abbreviated name of the first day
of the week (Sun in English).
... ... ...
ABDAY_7 LC_TIME Abbreviated name of the seventh day
of the week.
Hewlett-Packard Company - 1 - HP-UX 11i Version 2: August 2003
langinfo(5) langinfo(5)
MON_1 LC_TIME Name of the first month in the
Gregorian year.
... ... ...
MON_12 LC_TIME Name of the twelfth month.
ABMON_1 LC_TIME Abbreviated name of the first
month.
... ... ...
ABMON_12 LC_TIME Abbreviated name of the twelfth
month.
ERA LC_TIME The era description segments, which
describe how years are counted and
displayed for each era in a locale.
Each era description segment has
the format:
direction:offset:start_date:
end_date:era_name:era_format
according to the descriptions
below. There will be as many era
description segments as are
necessary to describe the different
eras. Era description segments are
separated by semicolons.
Note that the start of an era might
not be the earliest point in the
era; it might be the latest. For
example, the Christian era BC
starts on the day before January 1,
AD 1, and increases with earlier
time.
direction: Either a + or a -
character. The + character
indicates that years closer to the
start_date have lower numbers than
those closer to the end_date.
offset: The number of the year
closest to the start_date in the
era.
Hewlett-Packard Company - 2 - HP-UX 11i Version 2: August 2003
langinfo(5) langinfo(5)
start_date: A date in the format
yyyy/mm/dd, where yyyy, mm, dd are
the year, month, and day numbers
respectively of the start of the
era. Years prior to AD 1 are
represented as negative numbers.
end_date: The ending date of the
era, in the same format as the
start_date or one of the two
special values -* or +*. The value
-* indicates that the ending date
is the beginning of time. The
value +* indicates that the ending
date is the end of time.
era_name: The era, corresponding to
the %EC conversion specification.
era_format: The format of the year
in the era, corresponding to the
%EY conversion specification.
ERA_D_FMT LC_TIME Format string for formatting the %E
(Emperor/Era name and year)
directive of date(1) and
strftime(3C) if an individual era
format is not specified for an era
(see localedef(1M)).
ERA_D_T_FMT LC_TIME The locale's appropriate
alternative date and time format,
corresponding to the %Ec field
descriptor.
ERA_T_FMT LC_TIME The locale's appropriate
alternative date and time format,
corresponding to the %EX field
descriptor.
ALT_DIGITS LC_NUMERIC The alternative symbols for digits,
corresponding to the %O conversion
specification modifier. The value
consists of semicolon separated
strings. The first string is the
alternative symbol corresponding
with zero, the second string
corresponding with one, etc. Up to
100 alternate symbol strings may be
specified.
Hewlett-Packard Company - 3 - HP-UX 11i Version 2: August 2003
langinfo(5) langinfo(5)
RADIXCHAR LC_NUMERIC Radix character ("decimal point" in
English). The string returned is
the same as the decimal_point
element in the structure returned
by localeconv(3C).
THOUSEP LC_NUMERIC Separator for thousands. The
string returned is the same as the
thousands_sep element in the
structure returned by
localeconv(3C).
YESEXPR LC_MESSAGES Affirmative response extended
regular expression.
NOEXPR LC_MESSAGES Negative response extended regular
expression.
YESSTR LC_MESSAGES Affirmative response for yes/no
questions. (Obsolete: use YESEXPR.)
NOSTR LC_MESSAGES Negative response for yes/no
questions. (Obsolete: use NOEXPR.)
CRNCYSTR LC_MONETARY Symbol for currency preceded by -
if it precedes the number, + if it
follows the number, and . if it
replaces the radix. For example,
-DM would be used for
de_DE.iso88591 (DM1234,56), + Kr
for da_DK.iso88591 (1234,56 Kr),
and .$ for pt_PT.iso88591
(1234$56). See localeconv(3C) for
alternative currency formatting
information.
DIRECTION LC_CTYPE Value to indicate text direction.
Values currently defined include
null, 0, and 1. Values of null or
0 indicate that characters are
arranged from left to right within
a line and lines are arranged from
top to bottom. A value of 1
indicates that characters are
arranged from right to left within
a line and lines are arranged from
top to bottom. (This constant is
an HP proprietary item, subject to
change, and may not be portable to
other platforms.)
Hewlett-Packard Company - 4 - HP-UX 11i Version 2: August 2003
langinfo(5) langinfo(5)
CONTEXT LC_CTYPE String indicating character context
analysis. String null or 0
indicates no context analysis is
required. String 1 indicates
Arabic context analysis required.
ALT_DIGIT LC_NUMERIC A string of the characters that are
mapped into the ASCII equivalent
string 0123456789b+-.,eE (where b
is a blank). This is also the
reverse mapping for output. It is
not assumed that the character code
values of digits are contiguous or
that they are one byte values. A
null value for the string indicates
that the language has no
alternative digits. (This constant
is an HP proprietary item, subject
to change, and may not be portable
to other platforms.)
ALT_PUNCT LC_CTYPE A string of the characters that are
mapped into the ASCII equivalent
string
b!"#$%&'()*+,-./:;<=>?@[\]^_`{|}~
(where b is a blank) in American
usage. This is also the reverse
mapping for output. It is not
assumed that the character code
values of punctuation characters
are contiguous or that they are one
byte values. If any punctuation
characters do not have equivalent
alternatives, ASCII codes are used
in the alternative punctuation
string. A null value for the
string indicates that the language
has no alternative punctuation
characters. (This constant is an
HP proprietary item, subject to
change, and may not be portable to
other platforms.)
YEAR_UNIT LC_TIME Symbol for year. This is usually
required to specify date for Asian
languages. (This constant is an HP
proprietary item, subject to
change, and may not be portable to
other platforms.)
Hewlett-Packard Company - 5 - HP-UX 11i Version 2: August 2003
langinfo(5) langinfo(5)
MON_UNIT LC_TIME Symbol for month. (This constant
is an HP proprietary item, subject
to change, and may not be portable
to other platforms.)
DAY_UNIT LC_TIME Symbol for day. (This constant is
an HP proprietary item, subject to
change, and may not be portable to
other platforms.)
HOUR_UNIT LC_TIME Symbol for hour. This is usually
required to specify time for Asian
languages. (This constant is an HP
proprietary item, subject to
change, and may not be portable to
other platforms.)
MIN_UNIT LC_TIME Symbol for minute. (This constant
is an HP proprietary item, subject
to change, and may not be portable
to other platforms.)
SEC_UNIT LC_TIME Symbol for second. (This constant
is an HP proprietary item, subject
to change, and may not be portable
to other platforms.)
CHARMAP LC_COLLATE The name of the charmap used to
LC_CTYPE compile this locale. (This
constant is an HP proprietary item,
subject to change, and may not be
portable to other platforms.)
WARNINGS [Toc] [Back]
It is recommended that you use strftime() to access date and time
information defined in category (see strftime(3C)), LC_TIME and
localeconv(3C) to access information corresponding to RADIXCHAR,
THOUSEP, and CRNCYSTR (see localeconv(3C)).
AUTHOR [Toc] [Back]
langinfo was developed by HP.
SEE ALSO [Toc] [Back]
date(1), localedef(1M), getdate(3C), localeconv(3C), nl_langinfo(3C),
setlocale(3C), strftime(3C), lang(5).
Hewlett-Packard Company - 6 - HP-UX 11i Version 2: August 2003 [ Back ] |
