UTF8StrToMBStr

Download PDF

int UTF8StrToMBStr (const char UTF8String[], char **multibyteString, int flags);

Purpose

Converts a UTF-8 encoded string to an ANSI encoded, dynamically allocated, multibyte string using the native character set.

The native character set corresponds to the selected language in the Control Panel for non-Unicode programs.

Input
Name	Type	Description
UTF8String	const char []	The UTF-8 Null-terminated string you want to convert.
flags	int	Flags indicating the conversion type. Setting flags to kErrInvalidChars makes the function fail if an invalid input character is encountered.
Output
Name	Type	Description
multibyteString	char *	Pointer to the null-terminated string encoded in ANSI multibyte. When the pointer is no longer needed, free the pointer by calling the free function.

Name Type Description

status

int

Result of the conversion.

Code	Description
0	Success.
-4	Insufficient memory to complete operation.
-5	Invalid parameter.
-11	Some characters could not be converted.

Library: Utility Library

Include file: utility.h

LabWindows/CVI compatibility: LabWindows/CVI 2020 and later

Refer to utility\StringConversions\StringConversions.cws for an example of using the UTF8StrToMBStr function.

Was this information helpful?