函数名:cubrid_seq_insert()
适用版本:CUBRID 版本 8.4.0+
用法:cubrid_seq_insert() 用于向指定序列(sequence)中插入一个新的数值。序列是在 CUBRID 数据库中用于生成自增数值的对象。
语法:int cubrid_seq_insert(resource $conn_identifier, string $seq_name [, int $inserted_value])
参数:
- $conn_identifier: CUBRID 连接标识符,可由 cubrid_connect() 或 cubrid_connect_with_url() 函数返回。
- $seq_name: 输入要插入的序列的名称。
- $inserted_value(可选): 插入的数值。
返回值:成功插入时,返回新插入数值的 ID(整数类型)。失败时,返回 FALSE。
示例:
// 连接到数据库
$conn = cubrid_connect("localhost", 33000, "demodb", "username", "password");
if ($conn) {
// 定义要插入的序列名称
$seq_name = "my_seq";
// 在序列中插入新值
$inserted_value = cubrid_seq_insert($conn, $seq_name);
if ($inserted_value !== false) {
echo "新插入的数值为: " . $inserted_value;
} else {
echo "插入失败!";
}
// 关闭连接
cubrid_disconnect($conn);
} else {
echo "连接失败!";
}
在上面的示例中,我们首先使用 cubrid_connect() 函数连接到指定的 CUBRID 数据库。然后,我们定义了要插入的序列名称。最后,通过调用 cubrid_seq_insert() 函数,向指定序列中插入一个新的数值。如果插入成功,则输出新插入的数值;否则,输出插入失败的消息。
请注意,插入的数值是自动生成的,并且根据指定的序列规则生成。你可以选择提供一个可选的参数 $inserted_value,用于提供自定义的插入数值。