core::insert

(CoreMVC 1.0)

core::insert — 将实例中的数据作为一条记录插入到数据库中去

---

◎描述

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

---

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

---

该方法可以设置主键并将实例中的数据作为一条记录插入到数据库中去，然后定义为主键的那个成员得到自增值，该方法必须是通过实例调用的。需要注意的是该方法会插入实例中除主键外所有成员字段，插入后成员不会变化。

◎参数

tablename

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

primary_index

主键位置。0表示第1个字段是主键，1表示第2个字段是主键，以此类推。当不使用主键而直接插入整条记录时，该参数可以设置为-1。

primary_name

主键名称。和primary_index一样，如果主键名称不存在则视为不使用主键而直接插入整条记录。和primary_index一样，如果该参数是数据库中真正的主键，则插入后该成员会得到自增值。

◎返回值

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

◎例子

在继承类中的使用

《user.php》
<?php
class user extends core {
    final public static function append () {
        $user = new self;
        $user->user_id = null;
        $user->struct ($_POST);
        if ($user->insert ()) {
            $message = '插入成功';
        } else {
            $message = '插入失败';
        }
        self::view (__CLASS__ . '/' . __FUNCTION__ '.tpl', compact ('user', 'message'));
    }
}
?>

指定表名和主键字段

《test.php》
<?php
$user = new core;
$user->user_id = 1;
$user->name = '张三';
$user->insert ('pre_user', -1); //向pre_user表中插入一条记录，不使用主键。

$user->user_id = null;
$user->name = '张三';
$user->insert ('pre_user', 'user_id'); //向pre_user表中插入一条记录，并返回user_id。
echo $user->user_id;
?>