PEAR マニュアル
前のページ次のページ

MDB_Common::getOne()

MDB_Common::getOne() -- 最初の行の最初のカラムを取得する

概要

require_once 'MDB.php';

mixed &getOne (string $query, string [$type = NULL], array [$params = array()], array [$param_types = NULL])

説明

クエリから返されたデータの最初の行の最初のカラムの値を取得します。 この関数はクエリの実行を行い、終了時に結果を開放します。

パラメータ

string $query

SQL クエリあるいはプリペアドステートメント。

string $type

指定した場合は、結果セットのカラムの型が取得したものに設定されます。

array $params

指定した場合は、 prepareQuery()/ executeQuery() はこの配列を実行時のパラメータとして使用します。

array $param_types

指定した場合は、$param の値を自動的にその型に設定します。

返り値

mixed - 返された値、あるいは失敗した場合に 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() , getRow() , getCol() , getCol() , getCol()

前のページホーム次のページ
MDB_Common::getCol()上に戻るMDB_Common::getRow()