sesam_fetch_row

説明

array sesam_fetch_row ( string result_id [, int whence [, int offset]] )

取得したレコードを含む配列またはもうレコードがない場合に FALSE を返します。

結果集合のカラム数が連想配列の要素 $array["count"] で返されます。 いくつかのカラムは空である可能性があるため、 sesam_fetch_row() により返された結果レコードに 対して count() 関数を使用することはできません。

result_id は、 sesam_query() (select 型クエリのみ!) により 返された有効な結果 ID です。

whence は "スクロール型" カーソルで 取得処理を行うためのオプションパラメータで、次のような定義済みの 定数を設定することが可能です。

このパラメータは、"スクロール型" カーソルでのみ有効です。

"スクロール型" カーソルを使用している場合、カーソルは結果集合を 自由に移動可能です。whence パラメータが 省略された場合、スクロールの型には、グローバルなデフォルト値 (SESAM_SEEK_NEXT に初期化されており、 sesam_seek_row() で設定可能です) が使用されます。 whence が指定された場合、その値は グローバルデフォルト値に置換されます。

offset は、オプションのパラメータであり、 whence が SESAM_SEEK_RELATIVE または SESAM_SEEK_ABSOLUTE のどちらかである場合にのみ 評価されます (そして必要とされます)。このパラメータは、 "スクロール型" カーソルでのみ有効です。

sesam_fetch_row() は、指定した結果 ID が指す 結果から 1 件分のレコードのデータを取得します。レコードは、( 0 から $array["count"]-1 を 添字とした) 配列として返されます。フィールドは空である可能性が あるため、PHP の isset() 関数を使用して フィールドの存在を確認する必要があります。返されるフィールドの型は、 そのカラムを宣言した SQL 型に依存します (適用される変換については、 SESAMの概要 を参照ください)。 SESAM "複数フィールド" は "インライン化" されており、連続する カラムのように処理されます。

sesam_fetch_row() を連けてコールした場合、 結果集合の次の (スクロール属性に応じて前または n 番目の前/後) レコードまたはレコードがもうない場合に FALSE を返します。

例 1. SESAM レコードを取得 <?php $result = sesam_query("SELECT * FROM phone\n" .                        "  WHERE LASTNAME='" . strtoupper($name) . "'\n" .                        "  ORDER BY FIRSTNAME", 1); if (!$result) {     /* ... エラー ... */ } // 逆順にテーブルを出力する echo "<table border=\"1\">\n"; $row = sesam_fetch_row($result, SESAM_SEEK_LAST); while (is_array($row)) {     echo "<tr>\n";     for ($col = 0; $col < $row["count"]; ++$col) {         echo "<td>" . htmlspecialchars($row[$col]) . "</td>\n";     }     echo "</tr>\n";     // 暗黙のうちに SESAM_SEEK_PRIOR が使用される     $row = sesam_fetch_row($result); } echo "</table>\n"; sesam_free_result($result); ?>

連想配列を返す sesam_fetch_array()、そして 一度に多くのレコードを返す sesam_fetch_result() も参照ください。