DocResult::fetchOne()函式—用法及示例

函式: DocResult::fetchOne() 適用版本: PHP 7.1 及以上 用法: fetchOne(): mixed

該函式是一個靜態方法，用於從文件結果集中獲取單個文件（即一條記錄）。它返回單個文件作為一個關聯陣列或一個物件，或者在沒有文件可用時返回null。

示例:

// 假設我們有一個名為 $result 的文件結果集物件

// 從結果集中獲取單個文件作為關聯陣列
$documentAsArray = DocResult::fetchOne($result);

// 從結果集中獲取單個文件作為物件
$documentAsObject = DocResult::fetchOne($result, DocResult::FETCH_OBJECT);

// 在沒有文件可用時返回預設值
$documentOrDefault = DocResult::fetchOne($result) ?: ['id' => 0, 'name' => 'Unknown'];

// 使用返回的文件資料
echo $documentAsArray['name']; // 輸出文件的名稱
echo $documentAsObject->description; // 輸出文件的描述

// 處理未找到文件的情況
if ($documentAsArray === null) {
    echo "未找到該文件";
}

請注意，fetchOne() 函式返回的文件可以是一個關聯陣列，也可以是一個物件，具體取決於第二個引數（可選）傳遞的值。預設情況下，它返回關聯陣列。如果想返回物件，可以將第二個引數設定為 DocResult::FETCH_OBJECT。在上面的示例中，我們展示瞭如何使用這兩種返回型別。