Jump to content

UniQueryLocaleInfo: Difference between revisions

From EDM2
Ak120 (talk | contribs)
Ak120 (talk | contribs)
 
(3 intermediate revisions by 2 users not shown)
Line 1: Line 1:
== UniQueryLocaleInfo ==
Get information about the locale conventions.
; UniQueryLocaleInfo(localeObj, result) : Get information about the locale conventions.
 
=== Syntax ===
UniQueryLocaleInfo(localeObj, result)


=== Parameters ===
=== Parameters ===
; localeObj - [[OS2 API:DataType:LocaleObject|LocaleObject]] - input : The locale object created from [[OS2_API:UniCreateLocaleObject|UniCreateLocaleObject]].
;localeObj - [[LocaleObject]] - input : The locale object created from [[UniCreateLocaleObject]].
; result - [[OS2 API:DataType:UniLconv|UniLconv]] - output : The item to hold the locale conventions information.
;result - [[UniLconv]] - output : The item to hold the locale conventions information.


=== Constants ===
=== Constants ===
Line 11: Line 13:
=== Returns ===
=== Returns ===
An integer with values of:
An integer with values of:
* [[OS2 API:Unicode:error#ULS_BADOBJ|ULS_BADOBJ]]
* [[Unicode Errors#ULS_BADOBJ|ULS_BADOBJ]]
* [[OS2 API:Unicode:error#ULS_SUCCESS|ULS_SUCCESS]]
* [[Unicode Errors#ULS_SUCCESS|ULS_SUCCESS]]


=== Module ===
=== Module ===
Line 20: Line 22:
=== Export name/Ordinal ===
=== Export name/Ordinal ===


=== Calling conversion ===
=== Calling Convention ===
[[Cdecl32]]
[[Cdecl32]]


=== Example Code ===
=== Example Code ===
  [[OS2 API:DataType:LocaleObject|LocaleObject]] localeObj;
  LocaleObject localeObj;
  [[OS2 API:DataType:UniLconv|UniLconv]]     result;
  UniLconv    result;
  integer      rc;
  integer      rc;
  ...
  ...
Line 32: Line 34:


=== Related Functions ===
=== Related Functions ===
[[OS2 API:UniFreeLocaleInfo|UniFreeLocaleInfo]]
*[[UniFreeLocaleInfo]]


=== Notes ===
=== Notes ===
[[OS2 API:UniQueryLocaleInfo|UniQueryLocaleInfo]] returns information from the localeObj and places information in the [[OS2 API:DataType:UniLconv|UniLconv]] structure. [[OS2 API:UniQueryLocaleInfo|UniQueryLocaleInfo]] allocates the memory to hold the [[OS2 API:DataType:UniLconv|UniLconv]] structure. The application '''must''' free the memory using [[OS2 API:UniFreeLocaleInfo|UniFreeLocaleInfo]] when the structure is no longer needed. The [[OS2 API:DataType:UniLconv|UniLconv]] structure is filled using the locale provided by localeObj.
''UniQueryLocaleInfo'' returns information from the localeObj and places information in the [[UniLconv]] structure. ''UniQueryLocaleInfo'' allocates the memory to hold the ''UniLconv'' structure. The application '''must''' free the memory using ''UniFreeLocaleInfo'' when the structure is no longer needed. The ''UniLconv'' structure is filled using the locale provided by localeObj.


=== OS Version Introduced ===
=== OS Version Introduced ===

Latest revision as of 18:11, 13 February 2020

Get information about the locale conventions.

Syntax

UniQueryLocaleInfo(localeObj, result)

Parameters

localeObj - LocaleObject - input
The locale object created from UniCreateLocaleObject.
result - UniLconv - output
The item to hold the locale conventions information.

Constants

None

Returns

An integer with values of:

Module

Define (C/C++)

Export name/Ordinal

Calling Convention

Cdecl32

Example Code

LocaleObject localeObj;
UniLconv     result;
integer      rc;
...
rc = UniQueryLocaleInfo(localeObj, result);
...

Related Functions

Notes

UniQueryLocaleInfo returns information from the localeObj and places information in the UniLconv structure. UniQueryLocaleInfo allocates the memory to hold the UniLconv structure. The application must free the memory using UniFreeLocaleInfo when the structure is no longer needed. The UniLconv structure is filled using the locale provided by localeObj.

OS Version Introduced

  • OS/2 Warp