pg_result

Name

pg_result -- 問い合わせ結果情報を入手します。

Synopsis

pg_result resultHandle resultOption

入力

resultHandle

問い合わせ結果のハンドルです。

resultOption

利用できるオプションの 1 つを指定します。

オプション

-status

結果のステータスです。

-error

状態がエラーを示すものであった場合はエラーメッセージです。 さもなくば、空文字列です。

-conn

その結果を生成した接続です。

-oid

コマンドが INSERTの場合、挿入されたタプルの OID です。 さもなくば、0 です。

-numTuples

問い合わせで返されるタプル数です。

-numAttrs

各タプルの属性数です。

-assign arrayName

結果を、(tupno,attributeName) という形式でインデックスされた配列に代入します。

-assignbyidx arrayName ?appendstr?

結果を、最初の属性値と残る属性名をキーとして使った配列に代入します。 appendstrがある場合、各キーにそれを追加します。 簡単にいうと、各タプルの最初のフィールドを除くすべてが、(firstFieldValue,fieldNameAppendStr)という形式にインデックスされた配列の中に格納されます。

-getTuple tupleNumber

リストから指定タプルのフィールドを返します。 タプル番号は0から始まります。

-tupleArray tupleNumber arrayName

指定されたタプルのフィールドを、フィールド名でインデックスされた配列 arrayNameに保存します。 タプル番号は0から始まります。

-attributes

タプルの属性名のリストを返します。

-lAttributes

各タプルの属性について {name ftype fsize} という副リストを持つリストを返します。

-clear

問い合わせ結果オブジェクトをクリアします。

出力

結果は、上述のとおり、選択したオプションに依存します。

説明

pg_result は、事前に行われたpg_exec によって作成された問い合わせ結果についての情報を返します。

必要な期間、問い合わせ結果を保持できます。 ただし必要がなくなったら、確実に pg_result -clear を実行して結果を解放してください。 さもないと、メモリリークが起こり、Pgtcl が突然、あまりにも多くの問い合わせ結果オブジェクトを作成したといった警報を出すことがあります。