名称

ftra_dec_jef − DECコードの文字列をJEFコードの文字列に変換します

形式

#include <fna/ftra_def.h>

ftra_dec_jef (src_buf,src_len,dst_buf,dst_len,ret_len,context,itemlist)

引数

char ∗src_buf (Input) 変換対象バッファの先頭アドレス
変換すべきDECコード文字列を含んだバッファ

int src_len (Input) src_bufのバイト長

char ∗dst_str (Output) 変換結果出力バッファの先頭アドレス
変換後のJEFコード文字列を含むバッファ

int dst_len (Input) dst_bufのバイト長

int ∗ret_len (Output) 変換結果文字列のバイト長

void ∗context (Input) 変換コンテキスト・ハンドル

struct FTRA_ITEM_LIST ∗itemlist (Input)
変換時設定を行うパラメータ・リスト

ftra_dec_jef_initにおいて設定した初期値を一時的に変更することが可能です。 初期値は変更されませんので，呼び出しごとの設定が必要です。

指定可能なItem Codeは次のとおりです。

FTRA_k_end_of_item アイテム・リストの終了

FTRA_k_trans_mode 変換モードの設定
Item Valueの詳細は『F-RJE for DEC OSF/1 インストレーション/プログラ ミング・ガイド』を参照。

FTRA_k_asc_ebc_tbl 変換テーブルの設定
DECからJEFへの1バイトコード変換テーブル（256バイト）を設定します。

機能説明

・ DEC漢字文字セット中の未定義コードは %x’A2A2’(’□)に変換します。

・ DEC拡張漢字文字セットのコードの変換は使用する外字管理ファイルの設定に 依存します。未定義コードは %x’A2A2’(’□’)に変換します。

・ 入力バッファ(src_buf)，出力バッファ(dst_buf)が 同じ文字列領域を指示していた場合の変換結果は不定です。

・ 変換対象文字列に漢字および半角カナ・コードが混在する場合には，それぞれを識別 するためにシフト・コードにより明示されている必要があります（シフト・コード としてロッキング・シフト( LS2R， LS3R ) または シングル・シフト ( SS2 ) を 使用します）。

・ 正しい変換結果を得るためには，変換モード設定および 1バイトコード変換 テーブルが適切に設定されている必要があります。

戻り値

[FTRA_s_normal] 正常終了

[FTRA_s_truncate] 結果文字列の切り詰めが行なわれました（正常終了）

[FTRA_s_invparam] パラメータが正しくありません

[FTRA_s_badctx] 変換コンテキストが正しくありません