©
This document uses PHP Chinese website manual Release
(PHP 5 < 5.4.0, PECL sqlite >= 1.0.0)
sqlite_fetch_all -- SQLiteResult::fetchAll -- SQLiteUnbuffered::fetchAll — Fetches all rows from a result set as an array of arrays
$result
[, int $result_type
= SQLITE_BOTH
[, bool $decode_binary
= true
]] )面向对象风格 (method):
$result_type
= SQLITE_BOTH
[, bool $decode_binary
= true
]] )$result_type
= SQLITE_BOTH
[, bool $decode_binary
= true
]] ) sqlite_fetch_all() returns an array of the entire result
set from the result
resource. It is similar to calling
sqlite_query() (or
sqlite_unbuffered_query() ) and then
sqlite_fetch_array() for each row in the result set.
result
The SQLite result resource. This parameter is not required when using the object-oriented method.
result_type
可选的 result_type
参数接受常量,且决定返回的数组如何被索引。使用
SQLITE_ASSOC
会仅返回关联索引(已命名字段),而
SQLITE_NUM
会仅返回数值索引。 SQLITE_BOTH
会同时返回关联和数值索引。 SQLITE_BOTH
是此函数的默认值。
decode_binary
当
decode_binary
参数设置为 TRUE
(默认值)时,PHP 会解码那些由
sqlite_escape_string()
编码后的二进制数据。通常应保留此值为其默认值,除非要与其他使用 SQLlite 的应用程序建立的数据交互。
Returns an array of the remaining rows in a result set. If called right after sqlite_query() , it returns all rows. If called after sqlite_fetch_array() , it returns the rest. If there are no rows in a result set, it returns an empty array.
由
SQLITE_ASSOC
与 SQLITE_BOTH
返回的列名会依照 sqlite.assoc_case
配置选项的值决定大小写。
Example #1 Procedural example
<?php
$dbhandle = sqlite_open ( 'sqlitedb' );
$query = sqlite_query ( $dbhandle , 'SELECT name, email FROM users LIMIT 25' );
$result = sqlite_fetch_all ( $query , SQLITE_ASSOC );
foreach ( $result as $entry ) {
echo 'Name: ' . $entry [ 'name' ] . ' E-mail: ' . $entry [ 'email' ];
}
?>
Example #2 Object-oriented example
<?php
$dbhandle = new SQLiteDatabase ( 'sqlitedb' );
$query = $dbhandle -> query ( 'SELECT name, email FROM users LIMIT 25' ); // buffered result set
$query = $dbhandle -> unbufferedQuery ( 'SELECT name, email FROM users LIMIT 25' ); // unbuffered result set
$result = $query -> fetchAll ( SQLITE_ASSOC );
foreach ( $result as $entry ) {
echo 'Name: ' . $entry [ 'name' ] . ' E-mail: ' . $entry [ 'email' ];
}
?>
[#1] Minots Estich <minots at D0X dot de> [2004-10-21 09:15:52]
The usage of sqlite_fetch_all should be your choise
(instead the well known practice of "while()" loop)
when unmodified tabledata is prefered.
Example code for a better illustration:
<?php
if ($dbhandle = sqlite_open('mysqlitedb', 0666, $sqliteerror)):
$query = "SELECT x, y FROM sometable LIMIT 3;";
$result = sqlite_query($dbhandle, $query);
// usage with sqlite_fetch_all
$array1 = sqlite_fetch_all($result, SQLITE_ASSOC);
// the "well known practice"
$i = '0';
while ($row = sqlite_fetch_array($result, SQLITE_ASSOC)):
$array2["$i"] = $row;
$i++;
endwhile;
sqlite_close($dbhandle);
endif;
?>
There are no differents within the values of array1 and array2.
Both arrays will be something like:
Array
(
[0] => Array
(
[x] => 22004
[y] => example_data1
)
[1] => Array
(
[x] => 92044
[y] => example_data2
)
[2] => Array
(
[x] => 143060
[y] => example_data3
)
)
If you want to let me know about your comments, feel
free to send me a note via feedback-formular at:
http://www.d0x.de/pages/kontakt.php