函式名:fbird_blob_info()
適用版本:Firebird 2.0 及以上版本
用法:fbird_blob_info(resource $blob_handle)
描述:該函式用於獲取 BLOB 物件的資訊,包括 BLOB 的大小和最大段大小。
引數:
- $blob_handle:BLOB 物件的控制程式碼,由 fbird_blob_create() 或 fbird_blob_open() 返回。
返回值:
- 如果成功,返回一個關聯陣列,包含以下鍵值對:
- "size":BLOB 的大小,以位元組為單位。
- "max_segment":BLOB 的最大段大小,以位元組為單位。
- 如果失敗,返回 FALSE。
示例:
<?php
// 建立一個 Firebird 資料庫連線
$database = ibase_connect("localhost:employee.fdb", "username", "password");
// 開啟一個 BLOB 物件
$blob_handle = ibase_blob_open($database, $blob_id);
// 獲取 BLOB 物件的資訊
$blob_info = fbird_blob_info($blob_handle);
if ($blob_info !== false) {
echo "BLOB size: " . $blob_info['size'] . " bytes\n";
echo "Max segment size: " . $blob_info['max_segment'] . " bytes\n";
} else {
echo "Failed to retrieve BLOB info\n";
}
// 關閉 BLOB 物件
ibase_blob_close($blob_handle);
// 關閉資料庫連線
ibase_close($database);
?>
注意事項:
- 在呼叫該函式之前,必須先使用 fbird_blob_create() 或 fbird_blob_open() 函式開啟一個 BLOB 物件。
- BLOB 物件必須是有效的,否則函式會返回 FALSE。
- 在使用完 BLOB 物件後,應該使用 fbird_blob_close() 函式關閉它,以釋放資源。