函式名:php dbase_replace_record()
適用版本:PHP 4, PHP 5, PHP 7
用法: dbase_replace_record() 函式用於替換指定的記錄(行)。
語法: bool dbase_replace_record(int $dbase_identifier, array $record, int $record_number)
引數: $dbase_identifier:dbase 資料庫的識別符號,可透過 dbase_open() 函式獲得。 $record:要替換的記錄的欄位值陣列。陣列的鍵是欄位的索引(0 到 n-1)或欄位名。 $record_number:要替換的記錄的行號。
返回值: 如果成功,返回 true,否則返回 false。
示例:
// 開啟 dbase 資料庫檔案
$db = dbase_open('data.dbf', 2);
// 定義要替換的記錄(第 3 行)
$newRecord = array(
'name' => 'John Smith',
'age' => 35,
'email' => '[email protected]'
);
// 替換指定的記錄
$result = dbase_replace_record($db, $newRecord, 3);
if ($result) {
echo "記錄替換成功!";
} else {
echo "記錄替換失敗!";
}
// 關閉 dbase 資料庫檔案
dbase_close($db);
注意事項:
- 使用此函式之前,必須先開啟 dbase 資料庫檔案,並確保檔案模式為寫入(2)。
- $record 陣列的鍵可以是欄位的索引或欄位名,但兩者不要混用。
- $record 陣列的長度必須與 dbase 資料庫檔案定義的欄位數相同,否則會導致替換失敗。
- $record_number 行號從 1 開始計算,而不是從 0 開始。
- 替換成功後,原來的記錄將被新記錄完全替換,包括索引欄位和資料欄位的值。