Utf16ToBuffer - cCharTranslate

Creates an OEM, ANSI or UTF8 string in a memory buffer from a UTF-16 memory buffer

Type: Function
Return Data Type: Pointer

Parameters

Parameter	Type	Description
pWideBuf	Pointer	The address of the UTF-16 string
eCharType	Integer	The type of string encoding, which may be OEM (CP_OEMCP), ANSI (CP_ACP) or UTF-8 (CP_UTF8)
iLen	Integer	The wide character length of the UTF-16 string

Syntax

Function Utf16ToBuffer Pointer pWideBuf Integer eCharType Integer iLen Returns Pointer

Call Example

Get Utf16ToBuffer pWideBuf eCharType iLen to PointerVariable

Description

Utf16ToBuffer creates a OEM, ANSI or UTF8 string in a memory buffer from a UTF-16 memory buffer.

You are responsible for eventually disposing of the newly created memory buffer. This may be accomplished by using the Free function.

Use Windows.pkg
Use cCharTranslate.pkg

Object oCharTranslate is a cCharTranslate
End_Object

// test Utf16FromBuffer and Utf16ToBuffer
Procedure TestUTF16Buffer 
    Address aVar aUTF16Buffer aVar2
    Integer iLen iVoid
    String sVar sVar2

    Move "Test String-Ññóí" to sVar
    Move (AddressOf(sVar)) to aVar

    // Move OEM to UTF16 buffer
    Get Utf16FromBuffer of oCharTranslate aVar CP_OEMCP (&iLen) to aUTF16Buffer

    // Move UTF16 Buffer to OEM String
    Get Utf16ToBuffer of oCharTranslate aUTF16Buffer CP_OEMCP iLen to aVar2
    // Note length of OEM buffer is CStringLength(aVar2)
    Move aVar2 to sVar2
    If (sVar<>sVar2) Begin
        Send Info_Box "Test Failed"
    End

    Move (Free(aUTF16Buffer)) to iVoid
    Move (Free(aVar2)) to iVoid
End_Procedure

Send TestUTF16Buffer

Return Value

The buffer address.