ULSQueryLocaleItem

Queries the value of the specified locale item.

Arguments

ULSQueryLocaleItem( item [, locale][, codepage][, subchar ])

Parameters

item

The name or number of the locale item to be queried. This must be one of the items listed below. (The name, if used, is not case-sensitive.)

NAME	NUMBER	DESCRIPTION
sDateTime	1	Date and time format string
sShortDate	2	Short date format
sTimeFormat	3	Time format string
s1159	4	AM string
s2359	5	PM string
sAbbrevDayName7	6	Abbreviation of day 7 (Sun)
sAbbrevDayName1	7	Abbreviation of day 1 (Mon)
sAbbrevDayName2	8	Abbreviation of day 2 (Tue)
sAbbrevDayName3	9	Abbreviation of day 3 (Wed)
sAbbrevDayName4	10	Abbreviation of day 4 (Thu)
sAbbrevDayName5	11	Abbreviation of day 5 (Fri)
sAbbrevDayName6	12	Abbreviation of day 6 (Sat)
sDayName7	13	Name of day of week 7 (Sun)
sDayName1	14	Name of day of week 1 (Mon)
sDayName2	15	Name of day of week 2 (Tue)
sDayName3	16	Name of day of week 3 (Wed)
sDayName4	17	Name of day of week 4 (Thu)
sDayName5	18	Name of day of week 5 (Fri)
sDayName6	19	Name of day of week 6 (Sat)
sAbbrevMonthName1	20	Abbreviation of month 1
sAbbrevMonthName2	21	Abbreviation of month 2
sAbbrevMonthName3	22	Abbreviation of month 3
sAbbrevMonthName4	23	Abbreviation of month 4
sAbbrevMonthName5	24	Abbreviation of month 5
sAbbrevMonthName6	25	Abbreviation of month 6
sAbbrevMonthName7	26	Abbreviation of month 7
sAbbrevMonthName8	27	Abbreviation of month 8
sAbbrevMonthName9	28	Abbreviation of month 9
sAbbrevMonthName10	29	Abbreviation of month 10
sAbbrevMonthName11	30	Abbreviation of month 11
sAbbrevMonthName12	31	Abbreviation of month 12
sMonthName1	32	Name of month 1
sMonthName2	33	Name of month 2
sMonthName3	34	Name of month 3
sMonthName4	35	Name of month 4
sMonthName5	36	Name of month 5
sMonthName6	37	Name of month 6
sMonthName7	38	Name of month 7
sMonthName8	39	Name of month 8
sMonthName9	40	Name of month 9
sMonthName10	41	Name of month 10
sMonthName11	42	Name of month 11
sMonthName12	43	Name of month 12
sDecimal	44	Decimal point
sThousand	45	Triad separator
sYesString	46	Yes string
sNoString	47	No string
sCurrency	48	Currency symbol
sCodeSet	49	Locale codeset
xLocaleToken	50	IBM Locale Token
xWinLocale	51	Win32 Locale ID
iLocaleResnum	52	Resource number for description
sNativeDigits	53	String of native digits
iMaxItem	54	Maximum item number
sTimeMark	55	Time mark (am/pm) format
sEra	56	Era definition
sAltShortDate	57	Alternate short date format string
sAltDateTime	58	Alternate date and time format
sAltTimeFormat	59	Alternate time format
sAltDigits	60	XPG4 alternate digits
sYesExpr	61	XPG4 Yes expression
sNoExpr	62	XPG4 No expression
sDate	63	Short date separator
sTime	64	Time separator
sList	65	List separator
sMonDecimalSep	66	Monetary currency separator
sMonThousandSep	67	Monetary triad separator
sGrouping	68	Grouping of digits
sMonGrouping	69	Monetary groupings
iMeasure	70	Measurement (Metric, British)
iPaper	71	Normal paper size
iDigits	72	Digits to right of decimal
iTime	73	Clock format
iDate	74	Format of short date
iCurrency	75	Format of currency
iCurrDigits	76	Digits to right for currency
iLzero	77	Leading zero used
iNegNumber	78	Format of negative number
iLDate	79	Format of long date
iCalendarType	80	Type of default calendar
iFirstDayOfWeek	81	First day of week (0=Mon)
iFirstWeekOfYear	82	First week of year
iNegCurr	83	Format of negative currency
iTLzero	84	Leading zero on time
iTimePrefix	85	AM/PM preceeds time
iOptionalCalendar	86	Alternate calendar type
sIntlSymbol	87	International currency symbol
sAbbrevLangName	88	Windows language abbreviation
sCollate	89	Collation table
iUpperType	90	Upper case algorithm
iUpperMissing	91	Action for missing upper case
sPositiveSign	92	Positive sign
sNegativeSign	93	Negative sign
sLeftNegative	94	Left paren for negative
sRightNegative	95	Right paren for negative
sLongDate	96	Long date formatting string
sAltLongDate	97	Alternate long date format string
sMonthName13	98	Name of month 13
sAbbrevMonthName13	99	Abbreviation of month 13
sName	100	OS/2 locale name
sLanguageID	101	Abbreviation for language (ISO)
sCountryID	102	Abbreviation for country (ISO)
sEngLanguage	103	English name of Language
sLanguage	104	Native name of language
sEngCountry	105	English name of country
sCountry	106	Localized country name
sNativeCtryName	107	Name of country in native language
iCountry	108	Country code
sISOCodepage	109	ISO codepage name
iAnsiCodepage	110	Windows codepage
iCodepage	111	OS/2 primary codepage
iAltCodepage	112	OS/2 alternate codepage
iMacCodepage	113	Mac codepage
iEbcdicCodepage	114	Ebcdic codepage
sOtherCodepages	115	Other ASCII codepages
sSetCodepage	116	Codepage to set on activation
sKeyboard	117	Primary keyboard name
sAltKeyboard	118	Alternate keyboard name
sSetKeyboard	119	Keyboard to set on activation
sDebit	120	Debit string
sCredit	121	Credit string
sLatin1Locale	122	Locale for Latin 1 names
wTimeFormat	123	Win32 Time format
wShortDate	124	Win32 Date format
wLongDate	125	Win32 Long date format
jISO3CountryName	126	Java abbrev for country (ISO-3)
jPercentPattern	127	Java percent pattern
jPercentSign	128	Java percent symbol
jExponent	129	Java exponential symbol
jFullTimeFormat	130	Java full time format
jLongTimeFormat	131	Java long time format
jShortTimeFormat	132	Java short time format
jFullDateFormat	133	Java full date format
jMediumDateFormat	134	Java medium date format
jDateTimePattern	135	Java date time format pattern
jEraStrings	136	Java era strings

locale

The name of the locale whose values are being queried. Locale names are usually of the form "xx_YY", where "xx" is a language and YY is a country (e.g. "en_US", "zh_TW", "it_IT", etc.) The default is to use the current locale as defined by the LANG and LC_* environment variables.

codepage

The codepage into which the returned value will be converted. (Locale item values are stored internally as Unicode UCS-2 text. To return the value in UCS-2, specify codepage 1200.)

subchar

The substitution character for the target codepage. This is a two-letter hexadecimal value between 00 and FF which represents the character in the target codepage which will be used to represent substituted (i.e. unsupported) characters. The default value depends on the codepage; for most single-byte codepages it is 0x7F (?).

NOTE: Not all codepages appear to honour this setting!

Returns

The value of the specified locale item, as converted into the requested codepage.

Example

Code

/* Query the name of the language for locale 'es_AR' (Argentina)
 * in both English and the localized language itself.
 */
englang = ULSQueryLocaleItem('sEngLanguage', 'es_AR', 850 )
IF ULSERR \= '0' THEN DO
    SAY ULSERR
    RETURN
END
natlang = ULSQueryLocaleItem('sLanguage', 'es_AR', 850 )
IF ULSERR \= '0' THEN DO
    SAY ULSERR
    RETURN
END

SAY 'The default language for locale es_AR is "'englang'" ("'natlang'")'

Output

The default language for locale es_AR is "Spanish" ("Español")