Jump to content

UniLocaleTokenToStr: Difference between revisions

From EDM2
No edit summary
Ak120 (talk | contribs)
mNo edit summary
Line 3: Line 3:


=== Parameters ===
=== Parameters ===
; localeToken - [[OS2 API:DataType:LocaleToken|LocaleToken]] - input : A locale token.
; localeToken - [[LocaleToken]] - input : A locale token.
; localeStrType - integer - input : Requested string locale format.
; localeStrType - integer - input : Requested string locale format.
; result - [[OS2 API:DataType:PVOID|PVOID]] - output : The result of the locale conversion.
; result - [[PVOID]] - output : The result of the locale conversion.


=== Constants ===
=== Constants ===
These constants are for localeStrType.
These constants are for localeStrType.
* [[OS2 API:Constants:UNI#UNI_MBS_STRING_POINTER|UNI_MBS_STRING_POINTER]]
*[[UNI#UNI_MBS_STRING_POINTER|UNI_MBS_STRING_POINTER]]
* [[OS2 API:Constants:UNI#UNI_UCS_STRING_POINTER|UNI_UCS_STRING_POINTER]]
*[[UNI#UNI_UCS_STRING_POINTER|UNI_UCS_STRING_POINTER]]


=== Returns ===
=== Returns ===
Line 17: Line 17:
* [[OS2 API:Unicode:error#ULS_NOMEMORY|ULS_NOMEMORY]]
* [[OS2 API:Unicode:error#ULS_NOMEMORY|ULS_NOMEMORY]]
* [[OS2 API:Unicode:error#ULS_SUCCESS|ULS_SUCCESS]]
* [[OS2 API:Unicode:error#ULS_SUCCESS|ULS_SUCCESS]]
=== Module ===
=== Define (C/C++) ===
=== Export name/Ordinal ===


=== Calling conversion ===
=== Calling conversion ===
Line 28: Line 22:


=== Example Code ===
=== Example Code ===
  [[OS2 API:DataType:LocaleToken|LocaleToken]] localeToken;
  LocaleToken localeToken;
  integer    localeStrType;
  integer    localeStrType;
  [[OS2 API:DataType:PVOID|PVOID]]       result;
  PVOID      result;
  integer    rc;
  integer    rc;
  ...
  ...
Line 37: Line 31:


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


=== Notes ===
=== Notes ===
[[OS2 API:UniLocaleTokenToStr|UniLocaleTokenToStr]] allocates the memory for the result of the locale string conversion. It is the responsibility to call [[OS2 API:UniFreeMem|UniFreeMem]] when it is no longer needed. If no local string can be generated for the given token, the value returned is undefined.
'''UniLocaleTokenToStr''' allocates the memory for the result of the locale string conversion. It is the responsibility to call [[UniFreeMem]] when it is no longer needed. If no local string can be generated for the given token, the value returned is undefined.


=== OS Version Introduced ===
=== OS Version Introduced ===
OS/2 Warp
OS/2 Warp


 
[[Category:Uni]]
[[OS2_API | Back to OS/2 API]]
 
 
[[Category:The OS/2 API Project]]

Revision as of 04:25, 5 December 2016

UniLocaleTokenToStr

UniLocaleTokenToStr(localeToken, localeStrType, result)
Convert a locale token to a locale specific string.

Parameters

localeToken - LocaleToken - input
A locale token.
localeStrType - integer - input
Requested string locale format.
result - PVOID - output
The result of the locale conversion.

Constants

These constants are for localeStrType.

Returns

An integer with values of:

Calling conversion

Cdecl32

Example Code

LocaleToken localeToken;
integer     localeStrType;
PVOID       result;
integer     rc;
...
rc = UniLocaleTokenToStr(localeToken, localeStrType, result);
...

Related Functions

Notes

UniLocaleTokenToStr allocates the memory for the result of the locale string conversion. It is the responsibility to call UniFreeMem when it is no longer needed. If no local string can be generated for the given token, the value returned is undefined.

OS Version Introduced

OS/2 Warp