名前

tpconvmb()−入力バッファ内にある文字の符号化をターゲットの名前付きの符号化に変換

形式

#include <atmi.h>
extern int tperrno;
int
tpconvmb (char **bufp, int *len, char *target_encoding, long flags) 

機能説明

この関数は、入力バッファを目的のコードセットの符号化に変換する場合に使用します。

この関数は、ユーザの利便性を考慮して追加されたものであり、通常の自動によるコードセットのデータ変換では必須ではありません。

引数 bufp は、MBSTRING 型付きバッファのメッセージを指す有効なポインタです。バッファのサイズが変換済みバッファの出力データの処理に不十分な場合、このポインタは内部的に再割り当てされます。

入力での引数 len には、変換に必要なバイト数が入ります。変換が正常に終了すると、bufp で使用されたバイト数が入ります。

引数 target_encoding は、bufp メッセージで提供される型付きバッファの変換に使用するターゲットのコードセットの符号化名です。

引数 flags は、Tuxedo 変換コードでは使用されず、ユーザ定義の変換関数用のバッファ・タイプ・スイッチ関数に渡されます。

戻り値

tpconvmb() は、正常終了時には 0 を返し、エラー発生時には -1 を返し、次のように tperrno を設定します。この関数は、次の原因により異常終了する可能性があります。

関連項目