SQLite3Result::fetchArray()函数—用法及示例

函数名称：SQLite3Result::fetchArray()

适用版本：PHP 5 >= 5.3.0, PHP 7, PHP 8

用法：SQLite3Result::fetchArray() 函数用于从查询结果集中获取下一行作为关联数组、数字索引数组或两者兼有的数组。

语法：public SQLite3Result::fetchArray(int $mode = SQLITE3_BOTH, bool $decode_binary = true): array|false

参数：

• $mode（可选）：指定返回的数组类型。默认值为 SQLITE3_BOTH，可选值有：
  • SQLITE3_ASSOC: 返回关联数组。
  • SQLITE3_NUM: 返回数字索引数组。
  • SQLITE3_BOTH: 返回关联数组和数字索引数组的组合。
• $decode_binary（可选）：指定是否解码二进制数据。默认值为 true，如果设置为 false，则二进制数据将以二进制字符串的形式返回。

返回值：返回获取到的下一行数据的数组，如果没有更多行，则返回 false。

示例：

// 创建SQLite3数据库连接
$db = new SQLite3('mydatabase.db');

// 执行查询语句
$query = $db->query('SELECT * FROM mytable');

// 获取查询结果的下一行数据
while ($row = $query->fetchArray(SQLITE3_ASSOC)) {
    // 使用关联数组方式访问数据
    echo $row['column1'] . ", " . $row['column2'] . "\n";
}

// 使用数字索引数组方式访问数据
while ($row = $query->fetchArray(SQLITE3_NUM)) {
    echo $row[0] . ", " . $row[1] . "\n";
}

// 使用关联数组和数字索引数组的组合方式访问数据
while ($row = $query->fetchArray(SQLITE3_BOTH)) {
    echo $row['column1'] . ", " . $row[1] . "\n";
}

// 关闭数据库连接
$db->close();

上述示例代码中，我们首先创建了一个 SQLite3 数据库连接。然后执行了一个查询语句，并使用 fetchArray() 函数以不同的数组类型获取查询结果集的下一行数据。最后，我们通过关联数组和数字索引数组的方式访问了获取到的数据。最后，我们关闭了数据库连接。

请注意，此函数在 PHP 7.4 之前的版本中不支持解码二进制数据的功能。在 PHP 7.4 及更高版本中，默认情况下会解码二进制数据，但可以通过将 $decode_binary 参数设置为 false 来禁用解码。