core::delete

(CoreMVC 1.0)

core::delete — 根据实例中的主键条件删除数据库中的一条记录

---

◎描述

bool core::delete ( [ string $tablename = '' [, int $primary_index = 0 ] ] )

---

bool core::delete ( string $tablename , string $primary_name )

---

该方法可以根据主键删除数据库中相应的一条记录，该方法必须是通过实例调用的。需要注意的是该方法不会修改成员的值，只会删除数据库中的数据。

◎参数

tablename

要删除记录的完整表名，系统不粘附前缀。如果是使用默认参数空串则表名为继承类的类名加上前缀，但如果此时是直接从核心类调用则返回false。无论是默认的还是带表名参数的，系统都会根据设置的前缀替换规则进行替换。

primary_index

主键位置。0表示第1个字段是主键，1表示第2个字段是主键，以此类推。当不使用主键而直接交由系统删除一条记录时，该参数可以设置为-1。

primary_name

主键名称。和primary_index一样，如果主键名称不存在则视为不使用主键而直接交由系统删除一条记录。

◎返回值

当从核心类实例调用并且表名为空串时返回false。其他情况下删除成功返回true，删除失败返回false。

◎例子

在继承类中的使用

《user.php》
<?php
class user extends core {
    final public static function remove ($id) {
        $user = new self;
        $user->user_id = $id;
        if ($user->delete ()) {
            $message = '删除成功';
        } else {
            $message = '删除失败';
        }
        self::view (__CLASS__ . '/' . __FUNCTION__ '.tpl', compact ('user', 'message'));
    }
}
?>

指定表名和主键字段

《test.php》
<?php
$user = new core;
$user->delete ('pre_user', -1); //直接删除pre_user表中的一条记录，不使用主键。

$user->user_id = 1;
$user->delete ('pre_user', 'user_id'); //以user_id=1为主键条件删除pre_user表中相应的一条记录。
?>