SybIODesc class

目次に戻る

# SybIODesc

SyBase クライアントライブラリーの、CS_IODESC構造体（入出力記述子構造体）の Rubyへの実装です。

このオブジェクト自身は、SybCommand のget_iodescメソッドによって生成されます。

### メソッド

props( hash=nil )

  hash を指定すると、SybIODesc のCS_IODESC構造体メンバーを設定し、変更後の値を HASHで返します。
  hash を省略すると、SybIODesc の CS_IODESC構造体メンバーが HASHで返り ます

  props(hash) でメンバー値を設定をする場合、対応するキーが hashになければ、そのキーに対応する CS_IODESC 構造体メンバー は変更されません。

  hash の キー と値について
  Key | Value
  --- | ---
  'datatype' | SybConstant::CS_IMAGE_TYPE または CS_TEXT_TYPE
  'total_txtlen' | データの全長(Byte)
  'log_on_update' | true -- トランザクションログに書き込む false -- トランザクションログに書き込まない
  'name' | カラム名
  'timestamp' | タイムスタンプ (Stringオブジェクト)
  'textptr' | カラムのテキストポインタ(Stringオブジェクト)

  例 （データ挿入時にログを取らず、全データ長を 1234バイトに設定する）

        iodesc.props( { 'log_on_update'=> false ,
                        'total_txtlen' => 1234 } )