English | 简体中文 | 繁體中文
查询

SqlStatementResult::fetchOne()函数—用法及示例

「 从SQL语句执行结果集中获取一行数据 」


函数名称:SqlStatementResult::fetchOne()

适用版本:PHP 5.3.0及以上版本

函数描述:fetchOne()方法用于从SQL语句执行结果集中获取一行数据。

用法:

mixed SqlStatementResult::fetchOne()

参数说明: 该函数不接受任何参数。

返回值:

  • 如果结果集中有数据行,则返回该行数据;
  • 如果结果集为空,则返回false;
  • 如果发生错误,则返回null。

示例:

// 假设已经建立了数据库连接并执行了SQL查询

// 获取SQL语句执行结果集
$result = $db->query("SELECT * FROM users");

// 获取结果集中的第一行数据
$row = $result->fetchOne();

if ($row) {
    // 输出结果集中的第一行数据
    echo "用户ID:" . $row['id'] . "<br>";
    echo "用户名:" . $row['username'] . "<br>";
    echo "邮箱:" . $row['email'] . "<br>";
} else {
    echo "结果集为空";
}

注意事项:

  • 在调用fetchOne()方法之前,需要先执行SQL查询并获取结果集对象;
  • 如果结果集中有多行数据,fetchOne()方法只返回第一行数据;
  • 如果需要获取所有行数据,可以使用fetch()或fetchAll()方法;
  • 在使用fetchOne()方法时,需要确保SQL查询语句返回的结果集不为空,否则会返回false。
补充纠错
热门PHP函数
分享链接