->delete()
->delete() – 表からアイテムを削除します
Synopsis
int $DB_DataObject->delete (
boolean $useWhere
)
Description
主キーあるいは whereAdd() メソッドコールのいずれかに基づいてデータベースからデータを削除します。 デフォルトでは、削除はセットされた変数に基づいて行われます。 しかしながら、 whereAdd() メソッドを使用したい場合、 $useWhere パラメータに DB_DATAOBJECT_WHEREADD_ONLY をセットすべきです。
Return value
int 作用した行数、あるいは失敗した場合 FALSE
Throws
| エラーコード | エラーメッセージ | 意味 | 解決策 |
|---|---|---|---|
| DB_* | "*" | PEAR::DB を参照してください | PEAR::DB を参照してください |
| DB_DATAOBJECT_ERROR_NODATA | "削除: クエリの $condition にデータが指定されていません" |
Note
This function can not be called statically.
Example
単純な削除
<?php
$person = new DataObjects_Person;
$person->get(12);
$person->delete();
$person = new DataObjects_Person;
$person->name = 'test';
$person->age = 21;
$person->delete();
$person = new DataObjects_Person;
$person->whereAdd('age < 21');
$person->delete(DB_DATAOBJECT_WHEREADD_ONLY);
?>
結果の SQL
<?php
SELECT * FROM person WHERE person.id = 12
DELETE FROM person WHERE ( person.id = 12 )
DELETE FROM person WHERE ( person.name = 'test' ) AND ( person.age = 21 )
DELETE FROM person WHERE ( age < 21 )
?>
忘却曲線を使ってこの知識を確実に記憶に残す
