->get()

->get() --  単純な取得 (Select) リクエスト

概要

int $DB_DataObject->get (mixed Key or Value [, mixed value])

説明

キーや値を使用して結果を取得します。 成功した場合、行数を返し (通常は1) 、 このクラス変数に全ての表カラムをセットします。 もし、1つのパラメータのみが使用された場合、第1引数は値と見なされ、 get() は主キーを使用します。

パラメータ

返り値

int - 行数

例外・エラー

表 33-1PEAR_Error の値

エラーコードエラーメッセージ意味解決策
DB_DATAOBJECT_ERROR_INVALIDCONFIG"$table でキーが利用できません"  
DB_DATAOBJECT_ERROR_INVALIDARGS"値が指定されていません"  

注意

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

同じオブジェクトインスタンスで2回 get をコールすることを回避すべきです。 その場合、予期しない結果となります。

例 33-1主キーに基づいたデータの簡単なフェッチ


<?php
$person = new DataObjects_Person;
$person->get(12);
print_r($person);
?>

例 33-2結果の SQL

SELECT * FROM person WHERE id=12

例 33-3キーと値に基づいたデータの簡単なフェッチ


<?php
$person = new DataObjects_Person;
$person->get('email','test@example.com');
print_r($person);
?>

例 33-4結果の SQL

SELECT * FROM person WHERE email='test@example.com'

例 33-5サンプルコードの結果


<?php
Object (DataObjects_Person) =>
    [N] => 1
    [id] => 12
    [group] => 5
    [has_glasses] => 1
    [name] => 'fred blogs'
    [password] => '**testing'
    [email] => 'test@example.com'
?>