動態網頁技術PHP的數組處理函數庫

array :  建立一個新的數組。 
array_walk :  讓使用者自訂函數能處理數組中的每一個元素。 
arsort :  將數組的值由大到小排序。 
asort :  將數組的值由小到大排序。 
count :  計算變數或數組中的元素個數。 
current :  返回數組中目前的元素。 
each :  返回數組中下一個元素的索引及值。 
end :  將數組的內部指標指到最後的元素。 
key :  取得數組中的索引資料。 
ksort :  將數組的元素依索引排序。 
list :  列出數組中元素的值。 
next :  將數組的內部指標向後移動。 
pos :  返回數組目前的元素。 
prev :  將數組的內部指標往前移動。 
range :  建立一個整數範圍的數組。 
reset :  將數組的指標指到數組第一個元素。 
rsort :  將數組的值由大到小排序。 
shuffle :  將數組的順序弄混。 
sizeof :  獲知數組的大小。 
sort :  將數組排序。 
uasort :  將數組依使用者自定的函數排序。 
uksort :  將數組的索引依使用者自定的函數排序。 
usort :  將數組的值依使用者自定的函數排序。 

array

建立一個新的數組。

文法: array array(...);

傳回值:數組

函數種類: 資料處理

內容說明: 返回的參數是數群組類型。參數可以是帶有 => 運運算元的索引。array() 其實不是一個正規的函數，它主要是要用來表示數組。

使用範例 : 下面範例用顯示如何建立一個二維數組，如何指定聯合數組的索引值，及如何略過和繼續數組中的數字索引。

$fruits = array(
"fruits" => array("a"=>"orange","b"=>"banana","c"=>"apple"),
"numbers" => array(1, 2, 3, 4, 5, 6),
"holes" => array("first", 5 => "second", "third")
);

參考 list()

array_walk
讓使用者自訂函數能處理數組中的每一個元素。

文法: int array_walk(array arr, string func);

傳回值: 整數

函數種類: 資料處理

內容說明 此函數使每個數組元素 arr 依序與函數名稱 func 相對應。元素傳送到函數 func 的第一個參數，若參數超過一個，則每次都會有警告資訊。要處理警告資訊，可在本函數前面加上 '@' 字元 (變成 @array_walk)；或是使用 error_reporting 函數。

注意: 使用者自訂函數 func 真的會將數組元素 arr 依序代入，所以任何對元素所做的改變都會影響到數組本身。

使用範例

<?
$fruits = array("d"=>"lemon","a"=>"orange","b"=>"banana","c"=>"apple");
function test_alter( $item1 ) {
$item1 = 'bogus';
}function test_print( $item2 ) {
echo "$item2<br>\n";
}array_walk( $fruits, 'test_print' );
array_walk( $fruits, 'test_alter' );
array_walk( $fruits, 'test_print' );
?>
參考 each() list()

arsort
將數組的值由大到小排序。
文法: void arsort(array array);
傳回值: 無
函數種類:資料處理內容說明這個函數將數組的值重新排序，由大至小排列。數組的索引亦跟著值的順序而變動。當您在程式中需要重新整理數組值的順序時，就可以使用這個函數。

使用範例
底下的範例返回的結果為
fruits[a] = orange
fruits[d] = lemon
fruits[b] = banana
fruits[c] = apple。
我們可以看到水果名 (數組值) 已按英文字母的順序由 z 往 a 重新排序，而索引亦跟著值變動。
<?
$fruits = array("d"=>"lemon","a"=>"orange","b"=>"banana","c"=>"apple");
arsort($fruits);
for(reset($fruits); $key = key($fruits); next($fruits)) {
echo "fruits[$key] = ".$fruits[$key]."\n";
}
?>

參考 asort() rsort() ksort() sort()

asort
將數組的值由小到大排序。
文法: void asort(array array);
傳回值: 無
函數種類: 資料處理

內容說明 這個函數將數組的值重新排序，由小至大排列。數組的索引亦跟著值的順序而變動。當您在程式中需要重新整理數組值的順序時，就可以使用這個函數。

使用範例
底下的範例返回的結果為
fruits[c] = apple
fruits[b] = banana
fruits[d] = lemon
fruits[a] = orange
我們可以看到水果名 (數組值) 已按英
文字母的順序由 a 往 z 排序，而索引亦跟著值變動。
<?
$fruits = array("d"=>"lemon","a"=>"orange","b"=>"banana","c"=>"apple");
asort($fruits);
for(reset($fruits); $key = key($fruits); next($fruits)) {
echo "fruits[$key] = ".$fruits[$key]."\n";
}
?>
 
參考 arsort() rsort() ksort() sort()

count
計算變數或數組中的元素個數。
文法: int count(mixed var);
傳回值: 整數
函數種類: 資料處理

內容說明 這個函數用來計算數組的元素個數 (亦可將變數代入，只不過返回的整數將是 1)。變數還沒有配置時，傳回值為 0。變數若不是數組，傳回值為 1。

參考 sizeof() isset() is_array()

current
返回數組中目前的元素。
文法: mixed current(array array);
傳回值: 混合類型資料
函數種類: 資料處理

內容說明 說明: 每一個陣列變數都有一個內部指標，指到它的每一個元素。此外，為了互動參考，數組有份所有元素的雙向鏈結表。數組的內部指標指到原先插入的元素上，直到程式執行到有改動數組指標的函數。函數 current() 簡單地返回數組元素中目前指到的數組內部指標。它不會改變指標的值，若數組指標指到內部指標表外，則返回 false 的值。

注意: 若數組中包含空的元素 (0 或者 "" Null 字元串)，則本函數會返回 false 值。要是目前元素是個零值的空元素或者是超出數組指標，結果當然是未定的 false 值。遇到這種情形，可以使用 each() 函數會更適合。

參考 end() next() prev() reset()

each
返回數組中下一個元素的索引及值。
文法: array each(array array);
傳回值: 數組
函數種類: 資料處理

內容說明 返回數組為目前數組指標的 索引/值 對。返回的數組有四個元素，依序為 0, 1, 索引, 及值。前述的 0 與 索引 為數組的索引，1 與 值則為數組元素的值。
使用範例
範例一:
<?
$foo = array( "bob", "fred", "jussi", "jouni" );
$bar = each( $foo );
?>
上面的例子，返回數組 $bar 的 索引/值 為
0 => 0
1 => 'bob'
key => 0
value => 'bob'

範例二:
<?
$foo = array( "robert" => "bob", "seppo" => "sepi" );
$bar = each( $foo );
?>
這個的例子，返回數組 $bar 的 索引/值 為
0 => 'robert'
1 => 'bob'
key => 'robert'
value => 'bob'

範例三:
each() 函數最典型的例子是拿來與 list() 函數合用，如下例的 $http_post_vars 變數。
<?
echo "post 所送出的值為:<br>";
while ( list( $key, $val ) = each( $http_post_vars ) ) {
echo "$key => $val<br>";
}
?>

參考 current() key() list() next() prev() reset()

end
將數組的內部指標指到最後的元素。
文法: end(array array);
傳回值: 無
函數種類: 資料處理

內容說明 本函數會改變數組的內部指標，它將指標指到最後一個元素上。

參考 current() each() next() reset()

key
取得數組中的索引資料。
文法: mixed key(array array);
傳回值: 混合類型資料
函數種類: 資料處理
內容說明
本函數從目前數組的指標，返回其索引

參考 current() next()

ksort
將數組的元素依索引排序。
文法: void ksort(array array);
傳回值: 無
函數種類: 資料處理
內容說明
本函數將數組中的元素依索引排序，排序後的索引和值仍然對應

使用範例
<?
$fruits = array("d"=>"lemon","a"=>"orange","b"=>"banana","c"=>"apple");
ksort($fruits);
for(reset($fruits); $key = key($fruits); next($fruits)) {
echo "fruits[$key] = ".$fruits[$key]."\n";
}
?>
上面的例子，返回的資料為
fruits[a] = orange
fruits[b] = banana
fruits[c] = apple
fruits[d] = lemon
 
參考 arsort() asort() sort() rsort()

list
列出數組中元素的值。
文法: void list(...);
傳回值: 無
函數種類: 資料處理

內容說明 和 array 函數一樣，不算是正規的函數。list() 函數用在列出所有數組中的數值。

使用範例
下面的範例列出從 mysql 資料庫返回的數組資料。
<table>
<tr>
<th>員工姓名</th>
<th>薪資</th>
</tr>
<?php
$result = mysql($conn, "select id, name, salary from employees");
while (list($id, $name, $salary) = mysql_fetch_row($result)) {
print(" <tr>\n".
" <td><a href=\"info.php3?id=$id\">$name</a></td>\n".
" <td>$salary</td>\n".
" </tr>\n");
}
?></table>

參考 each() array()

next
將數組的內部指標向後移動。
文法: mixed next(array array);
傳回值: 混合類型資料
函數種類: 資料處理
內容說明 這個函數返回數組下個元素的內部指標，若沒有下個元素，則返回 false 值。當然，若是一個空的數組，它也返回 false 值。要正確地處理可能是空的數組，可以使用 each() 函數。此函數看起來像 current() 函數，不同地方在於本函數使指標往後指到下一個元素，並返回新的指標處的元素值，意即指標後移，並返回下一個元素值。

參考 current() end() prev() reset()

pos
返回數組目前的元素。
文法: mixed pos(array array);
傳回值: 混合類型資料
函數種類: 資料處理
內容說明
此函數其實就是 current() 函數。
參考
end() next() prev() reset()

數組處理函數庫
prev
將數組的內部指標往前移動。
文法: mixed prev(array array);
傳回值: 混合類型資料
函數種類: 資料處理
內容說明 這個函數返回數組前一個元素的內部指標，若沒有前一個元素，則返回 false 值。當然，若是一個空的數組，它也返回 false 值。要正確地處理可能是空的數組，可以使用 each() 函數。此函數有點像 next() 函數，只是 prev() 函數是將指標往前移，而 next() 函數是將指標往後移。

參考 current() end() next() reset()

range
建立一個整數範圍的數組。
文法: array range(int low, int high);
傳回值: 數組
函數種類: 資料處理
內容說明 此函數建立一個由小到大的連續整數數組。在 shuffle() 函數有使用範例
參考 shuffle()

reset
將數組的指標指到數組第一個元素。
文法: mixed reset(array array);
傳回值: 混合類型資料
函數種類: 資料處理
內容說明 本函數將數組的指標重設，將指標改指到數組的第一個元素。傳回值的內容也是數組的第一個元素。
使用範例
技巧: kk@shonline.de 指出 (30-jul-1998)，當數組的資料不夠穩定時，使用 reset() 會有警告資訊。最常發生的時候是處理 html 表單(form)的輸入資料時，若使用者輸入的資料不夠充份，或使用者故意增刪輸入 (input) 欄位，就有可能會有警告資訊。用 @reset() 的方式可使警告資訊不出現 (在 reset() 前加 @)，不過這隻是掩耳盜鈴的方式；要斧底抽薪的方法是使用 if (isset()) 的方式 (參見 4.48.14 isset() 函數)，如下例

<?
if (isset($form_array)) {
reset($form_array);
while (list($k, $v) = each($form_array)) {
do_something($k, $v);
}
}
?>

參考 current() each() next() prev()

rsort
將數組的值由大到小排序。
文法: void rsort(array array);
傳回值: 無
函數種類: 資料處理
內容說明
本函數將數組依由大到小的方式重排。
使用範例
<?
$fruits = array("lemon","orange","banana","apple");
rsort($fruits);
for(reset($fruits); list($key,$value) = each($fruits); ) {
echo "fruits[$key] = ".$value."\n";
}
?>
處理後的結果為
fruits[0] = orange
fruits[1] = lemon
fruits[2] = banana
fruits[3] = apple

參考 arsort() asort() ksort() sort() usort()

shuffle
將數組的順序弄混。
文法: void shuffle(array array);
傳回值: 無
函數種類: 資料處理
內容說明 本函數將數組以隨機的方式使全部元素重新亂排。
使用範例
<?
$numbers = range(1,20);
srand(time());
shuffle($numbers);
while (list(,$number) = each($numbers)) {
echo "$number ";
}
?>
注意:
ccunning@math.ohio-state.edu 指出 (31-may-1999)，在 solaris 上由於受了 libc 函數庫的影響，會使本函數出現問題。目前解決的方式如下面的例子。(注: 或許之後新的 php 版本會修正這個問題。)
<?
function myshuffle($array) {
mt_srand((double) microtime()*1000000);
$num = count($array);
for ($i=0; $i<$num-1; $i++) {
$n = mt_rand($i+1,$num);
$temp = $array[$n];
$array[$n] = $array[$i];
$array[$i] = $temp;
}
}
$array = array(1,2,3,4,5,6,7,8,9,10);
myshuffle(&$array);
while (list(,$var)=each($array)) {
echo $var . " ";
}
?>

參考 arsort() asort() ksort() rsort() sort() usort()

sizeof
獲知數組的大小。
文法: int sizeof(array array);
傳回值: 整數
函數種類: 資料處理
內容說明
本函數以整數類型返回數組的元素個數。
參考 count()

sort
將數組排序。
文法: void sort(array array);
傳回值: 無
函數種類: 資料處理
內容說明 本函數將數組依由小到大的方式重排。
使用範例
<?
$fruits = array("lemon","orange","banana","apple");
sort($fruits);
for(reset($fruits); list($key,$value) = each($fruits); ) {
echo "fruits[$key] = ".$value."\n";
}
?>
返回的結果為
fruits[0] = apple
fruits[1] = banana
fruits[2] = lemon
fruits[3] = orange
 
參考 arsort() asort() ksort() rsort() usort()

uasort
將數組依使用者自定的函數排序。
文法: void uasort(array array, function cmp_function);
傳回值: 無
函數種類: 資料處理
內容說明 本函數將數組依使用者自定的方式重排，當然元素的索引和值仍然保持對應的關係。當您覺得需要自行設計排序的方式時，可以先自訂處理函數，再使用本函數將數組值排序。
參考 arsort() asort() ksort() rsort() sort() uksort()

uksort
將數組的索引依使用者自定的函數排序。
文法: void uksort(array array, function cmp_function);
傳回值: 無
函數種類: 資料處理
內容說明 本函數將數組的索引依使用者自定的方式重排，cmp_function 即使用者自行開發的函數。

使用範例
<?
function mycompare($a, $b) {
if ($a == $b) return 0;
return ($a > $b) ? -1 : 1;
}
$a = array(4 => "four", 3 => "three", 20 => "twenty", 10 => "ten");
uksort($a, mycompare);
while(list($key, $value) = each($a)) {
echo "$key: $value\n";
}
?>
上面的程式返回資料為
20: twenty
10: ten
4: four
3: three
參考 arsort() asort() ksort() rsort() sort() uasort()

usort
將數組的值依使用者自定的函數排序。
文法: void usort(array array, function cmp_function);
傳回值: 無
函數種類: 資料處理
內容說明
本函數將數組的值依使用者自定的方式重排。若程式中需要使用特殊的排序方式，則可以使用這個函數。

使用範例
<?
function cmp($a,$b) {
if ($a == $b) return 0;
return ($a > $b) ? -1 : 1;
}
$a = array(3,2,5,6,1);
usort($a, cmp);
while(list($key,$value) = each($a)) {
echo "$key: $value\n";
}
?>
此例的傳回值為
0: 6
1: 5
2: 3
3: 2
4: 1
參考 arsort() asort() ksort() rsort() sort()