UniFreeUconvObject: Difference between revisions
mNo edit summary |
|||
| (2 intermediate revisions by one other user not shown) | |||
| Line 1: | Line 1: | ||
== | Free the conversion object from memory. | ||
=== Syntax === | |||
UniFreeUconvObject(uconvObj) | |||
=== Parameters === | === Parameters === | ||
| Line 10: | Line 12: | ||
=== Returns === | === Returns === | ||
An integer with values of: | An integer with values of: | ||
* [[ | * [[Unicode Errors#ULS_BADOBJECT|ULS_BADOBJECT]] | ||
* [[ | * [[Unicode Errors#ULS_SUCCESS|ULS_SUCCESS]] | ||
=== Calling Convention === | === Calling Convention === | ||
Latest revision as of 18:07, 4 December 2019
Free the conversion object from memory.
Syntax
UniFreeUconvObject(uconvObj)
Parameters
- uconvObj - UconvObject - input
- The conversion object created from UniCreateUconvObject.
Constants
None
Returns
An integer with values of:
Calling Convention
Example Code
character in = "C:\SOMEPATH\FILE.TXT";
size_t unicodeBuffLen = 12;
ULONG codePage;
ULONG cpLen; // length set by DosQueryCp
UniChar unicodeBuff, // length of unicodeBuffLen
tempPath; // length of CCHMAXPATH
UconvObject uconvObj;
character out; // allocate to CCHMAXPATH
integer rc;
rc = DosQueryCp(size of ULONG, codePage, cpLen);
/* determine string for the conversion of codePage */ rc = UniMapCpToUcsCp(codePage, unicodeBuff, unicodeBuffLen); rc = UniCreateUconvObject(unicodeBuff, uconvObj); rc = UniStrToUcs(uconvObj, tempPath, in, CCHMAXPATH); rc = UniFreeUconvObject(uconvObj);
/* conversion for current codepage that can be used for paths */ rc = UniCreateUconvObject((UniChar pointer)L"@path=yes", uconvObj); rc = UniStrFromUcs(uconvObj, out, tempPath, CCHMAXPATH); rc = UniFreeUconvObject(uconvObj);
/* use out - don't forget to de-allocate out when finished with it. */ /* error checking left out for brevity */
Related Functions
OS Version Introduced
OS/2 Warp