日本語 OpenVMS
日本語ライブラリ 利用者の手引き

前へ 次へ 目次 索引

＜戻り値＞

   ret-status SS$_NORMAL 正常終了
  JSY$_STRTRU 出力結果の切り捨てが行われた

JSY$RMS_GET_ENCODING

現在の RMS ファイル名コンバータの状態を取得します。

コンバータが有効の場合は "sdeckanji" が返されます。コンバータが無効の場合は "DISABLE" が返されます。

＜形式＞

ret-status = JSY$RMS_GET_ENCODING ( dst-str, dst-len )

＜引数＞

dst-str
        JLB usage コンバータ名の出力領域の先頭を指すポインタ
        type 文字列
        access 出力のみ
        mechanism Value 渡し
dst-len
        JLB usage コンバータ名のバイト長
        type Longword
        access 出力のみ
        mechanism Reference 渡し

＜戻り値＞

    ret-status SS$_NORMAL 正常終了
  SS$_INSFARG 引数の数が少なすぎる
  SS$_TOO_MANY_ARGS 引数の数が多すぎる

JSY$RMS_LIST_ENCODING

システムにインストールされているファイル名コンバータの名前を取得します。

最初に JSY$RMS_LIST_ENCODING を呼び出す時に，あらかじめ引数 context をゼロに初期化しておきます。そして JSY$RMS_LIST_ENCODING を呼び出すごとに，システムにインストールされているファイル名コンバータを１つずつ返します。
全てのコンバータの名前を取得し終えると，戻り値として SS$_NOMOREITEMS が返されます。この場合，コンバータ名は返されず，引数 context も更新されません。

＜形式＞

ret-status = JSY$RMS_LIST_ENCODING ( context, dst-str, dst-len )

＜引数＞

context
        JLB usage コンバータ管理用インデックス
        type Longword
        access 更新
        mechanism Reference 渡し
dst-str
        JLB usage コンバータ名の出力領域の先頭を指すポインタ
        type 文字列
        access 出力のみ
        mechanism Value 渡し
dst-len
        JLB usage コンバータ名のバイト長
        type Longword
        access 出力のみ
        mechanism Reference 渡し

＜戻り値＞

    ret-status SS$_NORMAL 正常終了
  RMS$_EXTNOTFOU ファイル名コンバータがシステムにインストールされていない
  SS$_BADPARAM 引数の値が不正である
  SS$_INSFARG 引数の数が少なすぎる
  SS$_NOMOREITEMS これ以上ファイル名コンバータが見つからない
  SS$_TOO_MANY_ARGS 引数の数が多すぎる

JSY$RMS_SET_ENCODING

RMS ファイル名コンバータを有効または無効に設定します。

コンバータを有効にする場合はコンバータ名として "sdeckanji" を指定します。コンバータを無効にする場合はコンバータ名として "DEFAULT" を指定します。なお，大文字/小文字の違いは無視されます。

＜形式＞

ret-status = JSY$RMS_SET_ENCODING ( src-str, src-len )

＜引数＞

src-str
        JLB usage コンバータ名の先頭を指すポインタ
        type 文字列
        access 入力のみ
        mechanism Value 渡し
src-len
        JLB usage コンバータ名のバイト長
        type Longword
        access 入力のみ
        mechanism Value 渡し

＜戻り値＞

    ret-status SS$_NORMAL 正常終了
  RMS$_EXTNOTFOU 指定されたファイル名コンバータが見つからない
  SS$_ACCVIO 不正なメモリをアクセスしようとした
  SS$_BADPARAM 引数の値が不正である
  SS$_INSFARG 引数の数が少なすぎる
  SS$_TOO_MANY_ARGS 引数の数が多すぎる

JSY$RMS_USER_VTF7

指定されたコードセットから VTF-7 コードセットへ，日本語ファイル名の文字コード変換を行います。このルーチンは RMS を使用せずにファイルにアクセスするアプリケーションなどが，日本語ファイル名をサポートするために利用することができます。

日本語ファイル名は Windows NT のサポートするファイル名に準拠しているため，一部の文字の変換規則は iconv と異なります。
変換結果出力領域を省略した場合は (引数 dst-str および dst-len がゼロ)，変換結果のバイト数のみを out-len に出力します。
変換対象文字列と変換結果出力領域が全く同じアドレスだった場合， JSY$RMS_USER_VTF7 は自動的に内部バッファを確保し，正常に変換を行います。しかし変換対象文字列と変換結果出力領域の一部だけが重複していた場合は，結果は保証されません。
コードセット名を省略した場合は (引数 codeset および codeset-len がゼロ)，現在のプロセスが使用しているコードセットを自動的に選択します。

＜形式＞

ret-status = JSY$RMS_USER_VTF7  ( src-str, src-len, [dst-str], [dst-len], out-len, [codeset], [codeset-len])

＜引数＞

src-str
        JSY usage 変換対象文字列
        type Byte string
        access 入力のみ
        mechanism Reference 渡し
src-len
        JSY usage 変換対象文字列のバイト長
        type Longword
        access 入力のみ
        mechanism Value 渡し
dst-str
        JSY usage 変換結果出力領域
        type Byte string
        access 出力のみ
        mechanism Reference 渡し
dst-len
        JSY usage 変換結果出力領域のバイト長
        type Longword
        access 入力のみ
        mechanism Value 渡し
out-len
        JSY usage 変換結果のバイト長
        type Longword
        access 出力のみ
        mechanism Reference 渡し
codeset
        JSY usage コードセット名
        type Byte string
        access 入力のみ
        mechanism Reference 渡し
codeset-len
        JSY usage コードセット名のバイト長
        type Longword
        access 入力のみ
        mechanism Value 渡し

＜戻り値＞

    ret-status SS$_NORMAL 正常終了
  JSY$_STRTRU 出力結果の切り捨てが行われた

JSY$RMS_VTF7_USER

VTF-7 コードセットから指定されたコードセットへ，日本語ファイル名の文字コード変換を行います。このルーチンは RMS を使用せずにファイルにアクセスするアプリケーションなどが，日本語ファイル名をサポートするために利用することができます。

日本語ファイル名は Windows NT のサポートするファイル名に準拠しているため，一部の文字の変換規則は iconv と異なります。
変換結果出力領域を省略した場合は (引数 dst-str および dst-len がゼロ)，変換結果のバイト数のみを out-len に出力します。
変換対象文字列と変換結果出力領域が全く同じアドレスだった場合， JSY$RMS_VTF7_USER は自動的に内部バッファを確保し，正常に変換を行います。しかし変換対象文字列と変換結果出力領域の一部だけが重複していた場合は，結果は保証されません。
コードセット名を省略した場合は (引数 codeset および codeset-len がゼロ)，現在のプロセスが使用しているコードセットを自動的に選択します。

＜形式＞

ret-status = JSY$RMS_VTF7_USER  ( src-str, src-len, [dst-str], [dst-len], out-len, [codeset], [codeset-len])

＜引数＞

src-str
        JSY usage 変換対象文字列
        type Byte string
        access 入力のみ
        mechanism Reference 渡し
src-len
        JSY usage 変換対象文字列のバイト長
        type Longword
        access 入力のみ
        mechanism Value 渡し
dst-str
        JSY usage 変換結果出力領域
        type Byte string
        access 出力のみ
        mechanism Reference 渡し
dst-len
        JSY usage 変換結果出力領域のバイト長
        type Longword
        access 入力のみ
        mechanism Value 渡し
out-len
        JSY usage 変換結果のバイト長
        type Longword
        access 出力のみ
        mechanism Reference 渡し
codeset
        JSY usage コードセット名
        type Byte string
        access 入力のみ
        mechanism Reference 渡し
codeset-len
        JSY usage コードセット名のバイト長
        type Longword
        access 入力のみ
        mechanism Value 渡し

＜戻り値＞

    ret-status SS$_NORMAL 正常終了
  JSY$_STRTRU 出力結果の切り捨てが行われた

前へ 次へ 目次 索引