【PHP8.x】PDO::FETCH_ORI_REL定数の使い方
FETCH_ORI_REL定数の使い方について、初心者にもわかりやすく解説します。
基本的な使い方
FETCH_ORI_REL定数は、PDO(PHP Data Objects)において、データベースから取得した結果セット内のデータをフェッチする際のカーソルの移動方向を表す定数です。PDOは、PHPで様々なデータベースに接続し、データ操作を行うための統一的なインターフェースを提供する拡張機能です。
この定数は、主にPDOStatement::fetch()メソッドやPDOStatement::fetchAll()メソッドの第2引数として使用されます。FETCH_ORI_RELを指定することにより、結果セット内のカーソルを「現在の位置から相対的に」移動させてデータ行を取得することが可能になります。例えば、現在のレコードの場所から数えて次のN番目のレコードや、前のN番目のレコードを取得したい場合に利用されます。
具体的には、fetch()メソッドの第3引数に移動したいオフセット値(行数)を指定することで、現在のカーソル位置を基準に、そのオフセット値だけ前後に移動してレコードを取得します。正のオフセット値はカーソルを後方に、負のオフセット値はカーソルを前方に移動させます。これにより、結果セットの先頭や末尾だけでなく、現在のカーソル位置から柔軟に目的のレコードへアクセスできるため、特定のデータ範囲を効率的に処理する際に役立ちます。この定数を使用することで、データベースから取得したデータを、より柔軟かつ効率的に操作することが可能となります。
構文(syntax)
1PDO::FETCH_ORI_REL;
引数(parameters)
引数なし
引数はありません
戻り値(return)
int
PDO::FETCH_ORI_REL は、PDOStatement::fetch() メソッドなどで使用される定数で、現在の結果セットのカーソル位置から相対的なオフセットを指定して行を取得するために、整数値 1 を返します。