cubrid_seq_insert()函式—用法及示例

函式名：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，用於提供自定義的插入數值。