Character Set Conversion

Defines the character conversion functions among the character sets of ASCII, USC-2, UTF-8, UTF-16BE.

This is character set conversion module. Most commonly used conversion is the conversion of the character sets between UCS-2 and ASCII encoding, which can be achieved by vm_chset_ucs2_to_ascii() and vm_chset_ucs2_to_ascii() functions. The vm_chset_convert() can do the conversion among the other encoding of ASCII, USC-2, UTF-8, UTF-16BE.

Limitation

The caller should ensure that the size of the destination buffer is large enough to contain the resulting string of the conversion. If not, the conversion will only convert a portion of the source string up to the size of the destination buffer. In other words, the resulting string is a truncated string up to the size of the destination buffer, when the size destination buffer cannot accommodate the full resulting string of the conversion.

Group

Standard

Functions

Function	Description
vm_chset_ascii_to_ucs2	Converts the ASCII string to a UCS-2 string. The caller should ensure that the size of the destination buffer is large enough to contain the resulting string. If not, the conversion will only convert a part of the source string up to the size of the destination buffer. In other words, the resulting string is a truncated string up to the size of the destination buffer.
vm_chset_convert	Converts a string between 2 character sets, and add the corresponding terminate character to the destination string. The caller should ensure that the size of the destination buffer is large enough to contain the resulting string. If not, the conversion will only convert a part of the source string up to the size of the destination buffer. In other words, the resulting string is a truncated string up to the size of the destination buffer.
vm_chset_ucs2_to_ascii	Converts the UCS-2 string to an ASCII string. The caller should ensure that the size of the destination buffer is large enough to contain the resulting string. If not, the conversion will only convert a part of the source string up to the size of the destination buffer. In other words, the resulting string is a truncated string up to the size of the destination buffer.

Macros

Macro	Description
VM_CHSET_CONVERT_MAX_LENGTH	The maximum length of character conversion.

Structs, Records, Enums

Struct, Record, Enum	Description
VM_CHSET_CONVERT_RESULT	The return value of vm_chset_convert
VM_CHSET_ENCODING	Character sets

Links

Topics, Functions, Macros, Structs, Records, Enums

Created with a commercial version of

Doc-O-Matic. In order to make this message disappear you need to register this software. If you have problems registering this software please contact us at

support@toolsfactory.com.