函式名:cubrid_field_name()
適用版本:PHP 5 >= 5.3.0, PECL cubrid >= 8.3.0
用法:cubrid_field_name() 函式用於獲取 CUBRID 查詢結果集中指定欄位的名稱。
語法:string cubrid_field_name ( resource $result , mixed $field_offset )
引數:
result:CUBRID 查詢結果集(透過 cubrid_execute() 返回的結果集)的資源控制代碼。
field_offset:欄位的偏移量或者欄位名。整數偏移量從 0 開始,可以是一個欄位名的字串。
返回值:返回指定欄位的名稱,如果出錯則返回 FALSE。
示例:
// 假設有一個名為 "employees" 的 CUBRID 資料庫表 $sql = "SELECT * FROM employees"; $result = cubrid_execute($conn, $sql);
// 獲取第一個欄位的名稱 $field_name = cubrid_field_name($result, 0); echo "第一個欄位名稱:".$field_name;
// 獲取 "name" 欄位的名稱 $field_name = cubrid_field_name($result, "name"); echo "欄位名稱為 'name':".$field_name;
// 關閉結果集 cubrid_close_request($result);
輸出: 第一個欄位名稱:id 欄位名稱為 'name':name
注意事項:
- 在呼叫該函式之前,必須先透過 cubrid_execute() 函式執行 SQL 查詢並獲取結果集。
- 如果指定的欄位在結果集中不存在,則返回 FALSE。
- 如果無法連線到 CUBRID 伺服器或者查詢執行出錯,則也會返回 FALSE。