MDB_Common::getOne() (Previous)

(Next) MDB_Common::getTextValue()

View this page in	Last updated: Sun, 31 Aug 2008
English \| Dutch \| French \| German \| Hungarian \| Japanese \| Polish \| Russian \| Spanish \| Plain HTML

MDB_Common::getRow()

MDB_Common::getRow() -- 最初の行を取得する

概要

require_once 'MDB.php';

array &getRow (string $query, array [$types = NULL], array [$params = array()], array [$param_types = NULL], integer [$fetchmode = MDB_FETCHMODE_DEFAULT])

説明

クエリの結果セットから最初の行のデータを取得します。この関数はクエリの実行を行い、終了時に結果を開放します。

パラメータ

string $query: SQL クエリ。
array $types: 指定した場合は、結果セットのカラムの型が取得時に設定されます。
array $params: 指定した場合は、 prepareQuery()/ executeQuery() はこの配列を実行時のパラメータとして使用します。
array $param_types: 指定した場合は、$param の値が渡されたデータ型に自動的に設定されます。
integer $fetchmode: 使用する取得モード。デフォルトは MDB_FETCHMODE_DEFAULT です。

返り値

array - 結果の最初の行を、ゼロから始まる数値添字の配列で返します。失敗した場合は MDB_Error を返します。

例外・エラー

表 39-1PEAR_Error の値

エラーコード	エラーメッセージ	原因	対応
`MDB_ERROR_INVALID`	`NULL`	準備した SQL ステートメントが無効です。	SQL 文でワイルドカードを使用する方法については、 prepareQuery() のドキュメントを参照ください。
`MDB_ERROR_NEED_MORE_DATA`	`NULL`	プリペアド SQL ステートメントに代入するデータが足りません。	prepareQuery() で処理した SQL 文中のワイルドカードの数を確認します。また、`$params` で指定した配列の要素数を確認します。この要素数は、ワイルドカードの数と一致しなければなりません。
`MDB_ERROR_NO_DB_SELECTED`	`NULL`	データベースが選択されていません。	connect() で指定した DSN を確認します。
その他のすべてのエラーコード		データベース固有のエラー	PHP マニュアルのデータベース関連の章で、エラーの意味を調べます。たいていの場合は SQL の文法が間違っていることが原因です。たとえば Oracle データベースの SQL 文で LIMIT を使用していることなどです。

注意

この関数は、スタティックにコールすることはできません。

参照

query() , limitQuery() , prepareQuery() executeQuery() , getCol() , getRow() , getAssoc()

MDB_Common::getOne() (Previous)

(Next) MDB_Common::getTextValue()

Download Documentation	Last updated: Sun, 31 Aug 2008
Do you think that something on this page is wrong? Please file a bug report or add a note.
User Notes:
There are no user contributed notes for this page.