SJISの文字列をUTF-8の文字列に変換します。

構文

char *CONV_SjisToUtf8String(
  char *src,
  int length,
  int *error_code,
  size_t *output_length
);

パラメータ

src
[in] SJISの文字列を指すポインタ。
length
[in] 変換するバイト数を指定します。負の値を指定すると、srcが指す文字列がNULで終端するまでの範囲を変換します。
error_code
[out] エラーコードを返す変数を指すポインタ。エラーコードが不要のときはNULLを指定します。
output_length
[out] 変換結果の終端のNULを除いたバイト数を返す変数を指すポインタ。バイト数が不要のときはNULLを指定します。

戻り値

　変換が成功したら変換結果を格納したバッファを指すポインタを、それ以外はNULLを返します。

解説

　srcが指すSJISの文字列の先頭からlengthで指定した長さの文字列をUTF-8の文字列に変換し、変換結果を格納したバッファを指すポインタを返します。

　lengthに負の値を指定すると、srcが指す文字列がNULで終端するまでの範囲を変換します。

　srcが指す文字列がlengthで指定した長さに到達する前にNULが検出されたときは、NULまでの文字列を変換します。

　srcが指す文字列にUnicodeに変換できない文字コードが含まれていたら、その文字を'?'に置き換えて変換を継続します。この場合は、error_codeが指す変数に次のエラーコードを返します。
エラーコード説明
CONV_UNSUPPORTED_CODE_WARNING変換できない文字コードが含まれていた。

　変換が成功したら、変換結果の文字列の最後をNULで終端し、変換結果のNULを除いたバイト数をoutput_lengthが指す変数に返します。

　変換が失敗したときはNULLを返し、error_codeが指す変数に次のエラーコードを返します。
エラーコード説明
CONV_INVALID_PARAMETER_ERRORパラメーターエラー
CONV_MEMORY_ALLOCATION_ERRORメモリーアロケーションエラー

　本関数がNULL以外の値を返したときは、free関数でバッファを解放する必要があります。
　

必要条件

ヘッダファイル:
CodeConversion.h
ライブラリファイル:
libCodeConversion.a
libSTARTUPOPH5000.a

最終更新日：2021/08/02

Copyright © 2020 OPTOELECTRONICS CO.,LTD. All rights reserved.