Jump to content

ULSQueryLocaleItem: Difference between revisions

From EDM2
Created page with "==Description== Queries the value of the specified locale item. ==Arguments== ULSQueryLocaleItem( item [, locale][, codepage][, subchar ] ) Parameters: item The..."
 
Ak120 (talk | contribs)
35,819 edits
 
(7 intermediate revisions by 2 users not shown)
Line 1: Line 1:
==Description==
Queries the value of the specified locale item.
Queries the value of the specified locale item.


==Arguments==
==Arguments==
ULSQueryLocaleItem( item [, locale][, codepage][, subchar ] )
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 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
===Parameters===
                two-letter hexadecimal value between 00 and FF which represents
;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.)
                the character in the target codepage which will be used to
:{|class="wikitable"
                represent substituted (i.e. unsupported) characters. The
!NAME||NUMBER||DESCRIPTION
                default value depends on the codepage; for most single-byte
|-
                codepages it is 0x7F ().
|sDateTime||1||Date and time format string
 
|-
                NOTE: Not all codepages appear to honour this setting!
|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==
==Returns==
Line 173: Line 290:


==Example==
==Example==
Code
<PRE>
/* 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


      Code
SAY 'The default language for locale es_AR is "'englang'" ("'natlang'")'
 
</PRE>
        /* Query the name of the language for locale 'es_AR' (Argentina)
Output
        * in both English and the localized language itself.
The default language for locale es_AR is "Spanish" ("Español")
        */
        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")
[[Category:RxULS]]

Latest revision as of 21:24, 12 December 2022

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")
Retrieved from "https://www.edm2.com/index.php?title=ULSQueryLocaleItem&oldid=79595"