1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2<html>
3<head>
4<META http-equiv="Content-Type" content="text/html; charset=windows-1252">
5<META name="GENERATOR" content="IBM WebSphere Studio Homepage Builder Version 8.0.2.0 for Windows">
6<META http-equiv="Content-Style-Type" content="text/css">
7<title>STD_ConvertStringSjisToUnicode</title>
8<LINK rel="stylesheet" href="../../css/nitro.css" type="text/css">
9</head>
10<body>
11<h1 align="left">STD_ConvertStringSjisToUnicode<img src="../../image/NTR.gif"align="middle"><img src="../../image/TWL.gif" align="middle"></h1>
12<h2>Syntax</h2>
13<dl>
14  <dd><PRE><CODE>#include &lt;nitro/std.h&gt;
15<a href="STDResult.html">STDResult</a> STD_ConvertStringSjisToUnicode(u16 *dst, int *dst_len, const char *src, int *src_len, <A href="STDConvertUnicodeCallback.html">STDConvertUnicodeCallback</A> callback);</CODE></PRE></dd>
16</dl>
17<h2>Arguments</h2>
18<table border="1" width="100%">
19  <tbody>
20    <TR>
21      <TD width="20%"><CODE>dst</CODE></TD>
22      <TD width="80%">Unicode string buffer for storing the converted string. <br>If <CODE>NULL</CODE>, the storing process is ignored.</TD>
23    </TR>
24    <TR>
25      <TD width="20%"><CODE>dst_len</CODE></TD>
26      <TD width="80%">Passing the maximum number of characters that can be stored in the destination buffer, this pointer accepts the number of characters actually stored.<br>
27      Note that this number of characters is different from the byte size.<br>
28      Ignored when <CODE>NULL</CODE> is specified.</TD>
29    </TR>
30    <TR>
31      <TD width="20%"><CODE>src</CODE></TD>
32      <TD width="80%">Source Shift-JIS string buffer.</TD>
33    </TR>
34    <TR>
35      <TD width="20%"><CODE>src_len</CODE></TD>
36      <TD width="80%">Passing the maximum byte size that should be converted, this pointer accepts the byte size that was actually converted.<BR>
37      If a negative number is passed or if <CODE>NULL</CODE> is specified, it is treated as if the length up to <CODE>src</CODE> was specified.</TD>
38    </TR>
39    <TR>
40      <TD width="200"><CODE>callback</CODE></TD>
41      <TD width="800">Callback that will be called if there are any characters that cannot be converted.</TD>
42    </TR>
43  </tbody>
44</table>
45<h2>Return Values</h2>
46<p>
47Returns an <a href="STDResult.html"><CODE>STDResult</CODE></a> type value that gives the conversion result. If <CODE>dst</CODE> is other than <CODE>NULL</CODE>, the converted string is stored in <CODE>dst</CODE>, and the number of characters after conversion is returned in <CODE>src_len</CODE> and <CODE>dst_len</CODE>. <br>If <CODE>dst</CODE> is <CODE>NULL</CODE>, only the number of post-conversion characters is returned without storing the converted string. <br>The null terminator '<CODE>\0</CODE>' is not given or included in the character count.</p>
48<H2>Description</H2>
49<P>
50Converts 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.<BR> If <CODE>NULL</CODE> is used to specify the callback, processing will terminate when an unconvertible character appears.<BR><br> If <CODE>NULL</CODE> is specified for <CODE>dst</CODE>, only the post-conversion character length can be found.<br>
51</P>
52<h2>See Also</h2>
53<p><a href="STDResult.html"><CODE>STDResult</CODE></a><BR> <A href="STD_ConvertCharSjisToUnicode.html"><CODE>STD_ConvertCharSjisToUnicode</CODE></A><BR> <A href="STD_ConvertStringUnicodeToSjis.html"><CODE>STD_ConvertStringUnicodeToSjis</CODE></A><BR> <A href="STD_ConvertCharUnicodeToSjis.html"><CODE>STD_ConvertCharUnicodeToSjis</CODE></A><BR> <A href="STDConvertUnicodeCallback.html"><CODE>STDConvertUnicodeCallback</CODE></A></p>
54<H2>Revision History</H2>
55<P>
562006/08/10 Changed the interface.<br>2006/07/24 Changed the interface.<br>2006/07/05 Initial version.
57</P>
58<hr><p>CONFIDENTIAL</p></body>
59</html>