函式名稱:cubrid_set_drop()
適用版本:CUBRID 9.1.0 或更高版本
函式描述:用於設定是否在 DROP 語句中包含 "IF EXISTS" 子句,以在物件不存在的情況下避免出現錯誤。
語法:cubrid_set_drop(bool $include_if_exists) : bool
引數:
- $include_if_exists(必需):一個布林值,指定是否在 DROP 語句中包含 "IF EXISTS" 子句。如果為 true,則包含子句;如果為 false,則不包含子句。
返回值:
- 如果成功設定了設定項,則返回 true;如果設定失敗,則返回 false。
示例用法:
// 設定在 DROP 語句中包含 "IF EXISTS" 子句
cubrid_set_drop(true);
// 建立一個表
$query = "CREATE TABLE my_table (id INT, name VARCHAR(100))";
$result = cubrid_execute($connection, $query);
// 刪除表,如果表不存在,則不會丟擲錯誤
$query = "DROP TABLE my_table";
$result = cubrid_execute($connection, $query);
// 取消設定,在 DROP 語句中不包含 "IF EXISTS" 子句
cubrid_set_drop(false);
在上述示例中,首先使用 cubrid_set_drop(true)
來設定在 DROP 語句中包含 "IF EXISTS" 子句。然後,建立一個名為 "my_table" 的表,接著使用 cubrid_execute()
函式執行 DROP 語句來刪除表。由於設定了 "IF EXISTS" 子句,即使表不存在,也不會丟擲錯誤。最後,使用 cubrid_set_drop(false)
取消設定,以確保後續 DROP 語句不包含 "IF EXISTS" 子句。