# 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