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.)

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 calandar 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 calandar 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     Codpage 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")