MDB_Common::queryCol()

MDB_Common::queryCol() – 単一のカラムを取得する

Synopsis

require_once 'MDB.php';

array &queryCol ( string $query , string $type = = null , mixed $colnum = 0 )

Description

クエリの結果セットから単一のカラムを取得します。 この関数はクエリの実行を行い、終了時に結果を開放します。

Parameter

string $query

SQL クエリ。

string $type

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

array $params

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

array $param_types

指定した場合は、$param の値が 渡されたデータ型に自動的に設定されます。

mixed $colnum

どのカラムを返すか (整数値 [0 から始まるカラム番号] あるいは文字列 [カラム名])。

Return value

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

Throws

Possible PEAR_Error values
エラーコード エラーメッセージ 原因 対応
MDB_ERROR_NO_DB_SELECTED NULL データベースが選択されていません。 connect() で指定した DSN を確認します。
MDB_ERROR_TRUNCATED NULL 結果セットに二つ以上のカラムがありません。 SQL クエリを調べるか、別の get*() 関数を選択します。
その他のすべてのエラーコード   データベース固有のエラー PHP マニュアル のデータベース関連の章で、エラーの意味を調べます。 たいていの場合は SQL の文法が間違っていることが原因です。 たとえば Oracle データベースの SQL 文で LIMIT を使用していることなどです。

Note

This function can not be called statically.

結果セットを入れ子状の配列として取得する (Previous) 最初の行の最初のカラムを取得する (Next)
Last updated: Sat, 25 Oct 2014 — Download Documentation
Do you think that something on this page is wrong? Please file a bug report or add a note.
View this page in:

User Notes:

There are no user contributed notes for this page.