PHPマニュアル/PEARマニュアル | ユーザフォーラムで議論/質問 | マニュアル検索 | ハイライト | ハイライトオフ | ポータル | php spot

DB_common::getOne() | JavaScript入門&応用&リファレンスなら「JavaScriptist」

  

DB_common::getOne()

DB_common::getOne() – クエリを実行し、最初の行の最初のカラムを返す

Synopsis

mixed &getOne ( string $query , mixed $params = array() )

Description

指定したクエリを実行し、結果の最初の行・最初のカラムのデータを返したあとで 結果セットを開放します。

Parameter

string $query

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

mixed $params

プリペアドステートメントに追加される、配列・文字列あるいは数値のデータ。 配列の要素数は、クエリ内のプレースホルダの数と同じでなければなりません。 配列以外を指定した場合はプレースホルダがひとつであることを意味し、 配列を指定した場合は配列の個々の要素がそれぞれのパラメータに対応します。

指定された場合は、 prepare()/ execute() が使用されます。

Return value

mixed - 最初のカラムのデータ (データがない場合は NULL)、あるいは失敗した場合に DB_Error オブジェクトを返します。

Throws

Possible PEAR_Error values
エラーコード エラーメッセージ 原因 対応法
DB_ERROR_INVALID invalid 準備された SQL 文が無効です。 プレースホルダを使用する SQL 文を用いる場合は prepare() のドキュメント を参照ください。
DB_ERROR_MISMATCH mismatch パラメータの数が、プリペアドステートメント中の プレースホルダの数と一致しません。 $query に渡した prepare() 済みの文中の プレースホルダの数が、$params で渡した項目の数と一致するかどうかを調べます。
DB_ERROR_NODBSELECTED no database selected データベースが選択されていません。 connect() の際の DSN を調べます。
その他のエラーコード データベース固有のエラー。 PHP マニュアル のデータベース関連の部分を調べ、エラーの原因を判断してください。 たいていの場合は SQL 文が間違っていることが原因です。例えば Oracle データベースに対して SQL で LIMIT を使用しているなどが 考えられます。

Note

This function can not be called statically.

Example

getOne() の使用法

<?php
// $db という名前の DB オブジェクトを取得しているとします...
$data =& $db->getOne('SELECT cf FROM foo');

if (
PEAR::isError($data)) {
    die(
$data->getMessage());
}

echo 
"$data\n";
?>

プレースホルダがひとつの場合の getOne() の使用法

<?php
// $db という名前の DB オブジェクトを取得しているとします...
$data =& $db->getOne('SELECT cf FROM foo WHERE nf = ?',
        
5);

if (
PEAR::isError($data)) {
    die(
$data->getMessage());
}

echo 
"$data\n";
?>

プレースホルダがふたつの場合の getOne() の使用法

<?php
// $db という名前の DB オブジェクトを取得しているとします...
$data =& $db->getOne('SELECT cf FROM foo WHERE nf IN (?, ?)',
        array(
510));

if (
PEAR::isError($data)) {
    die(
$data->getMessage());
}

echo 
"$data\n";
?>
忘却曲線を使ってこの知識を確実に記憶に残す

フォーラムで「DB_common::getOne()」について話す
各種マニュアル: PHPマニュアル | PEARマニュアル | Smarty(英語)マニュアル | PHP-GTKマニュアル | DB_common::getOne()」をGoogle検索
copyright © 1997-2024 PHP ドキュメント作成グループ(ライセンス). provided by php spot. マニュアル: