STD_ConvertStringSjisToUnicode

Syntax

#include <nitro/std.h>
STDResult STD_ConvertStringSjisToUnicode(u16 *dst, int *dst_len, const char *src, int *src_len, STDConvertUnicodeCallback callback);

Arguments

dst Unicode string buffer for storing the converted string.
If NULL, the storing process is ignored.
dst_len Passing the maximum number of characters that can be stored in the destination buffer, this pointer accepts the number of characters actually stored.
Note that this number of characters is different from the byte size.
Ignored when NULL is specified.
src Source Shift-JIS string buffer.
src_len Passing the maximum byte size that should be converted, this pointer accepts the byte size that was actually converted.
If a negative number is passed or if NULL is specified, it is treated as if the length up to src was specified.
callback Callback that will be called if there are any characters that cannot be converted.

Return Values

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

Description

Converts a Shift-JIS-format string to a Unicode-format string. If the function finds Shift-JIS-format characters that it cannot convert, it will generate a callback each time.
If NULL is used to specify the callback, processing will terminate when an unconvertible character appears.

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

See Also

STDResult
STD_ConvertCharSjisToUnicode
STD_ConvertStringUnicodeToSjis
STD_ConvertCharUnicodeToSjis
STDConvertUnicodeCallback

Revision History

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


CONFIDENTIAL