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

構文

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

パラメータ

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

戻り値

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

解説

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

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

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

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

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

　変換が失敗したときはNULLを返し、error_codeが指す変数に次のエラーコードを返します。
エラーコード説明
CONV_INVALID_PARAMETER_ERRORパラメーターエラー
CONV_MEMORY_ALLOCATION_ERRORメモリーアロケーションエラー
CONV_INVALID_UTF8_FORMAT_ERRORUTF-8の規格に合致しないバイト列を検出した。

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

必要条件

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

最終更新日：2021/08/02

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