STD_ConvertStringUnicodeToSjis

C Specification

#include <nitro/std.h>

STDResult STD_ConvertStringUnicodeToSjis(char *dst, int *dst_len, const u16 *src, int *src_len, STDConvertSjisCallback callback);

Arguments

dst ShiftJIS character string buffer for storing the converted string
If NULL is specified, the storing process is ignored.
dst_len Passing the maximum byte size that can be stored in the destination buffer, this pointer accepts the byte size actually stored.
Ignored when NULL is specified.
src Unicode character string buffer for string to be converted
src_len Passing the maximum number of characters to be converted, this pointer accepts the number of characters actually converted.
Be sure to note that the number of characters does not give the byte size.
If a negative number is passed or if NULL is specified, it is treated as if the length up to src was specified.
callback This designates the callback that will be called if there are any characters that can't be converted.

Return Values

Returns an STDResult type value that gives the result of the conversion. If dst is other than NULL, the converted character string is stored in dst and the byte size after conversion is returned in src_len and dst_len.
If dst is NULL, only the byte size after conversion is returned without storing the converted string.
The NULL terminator '\0' is not given or included in the character count.

Description

Converts the Unicode character string to a ShiftJIS character string.
If a Unicode character that canot be converted by the API is found, a callback for that even is generated.
If NULL is used to specify the callback, processing will terminate when a character that cannot be converted appears.

If NULL is specified for dst, only the character length after conversion can be found.

See Also

STDResult
STD_ConvertStringSjisToUnicode, STD_ConvertCharSjisToUnicode, STD_ConvertCharUnicodeToSjis, STDConvertSjisCallback

Revision History

08/10/2006 Changed the interface.
07/24/2006 Changed the interface.
07/05/2006 Initial version.


CONFIDENTIAL