 |
V. Array 数组函数
本类函数允许用多种方法来操作数组和与之交互。数组的本质是储存,管理和操作一组变量。
PHP 支持一维和多维数组,可以是用户创建或由另一个函数创建。有一些特定的数据库处理函数可以从数据库查询中生成数组,还有一些函数返回数组。
参见手册中的数组一节关于
PHP 是怎样实现和使用数组的详细解释。参见数组运算符一节关于怎样操作数组的其它方法。
本函数库作为 PHP 内核的一部分,不用安装就能使用。 本扩展模块在 php.ini 中未定义任何配置选项。 以下常量作为 PHP 核心的一部分一直有效。
排序顺序标识:
排序类型标识:用于各种排序函数
- SORT_REGULAR
(integer)
SORT_REGULAR 用于对对象进行通常比较。
- SORT_NUMERIC
(integer)
SORT_NUMERIC 用于对对象进行数值比较。
- SORT_STRING
(integer)
SORT_STRING 用于对对象进行字符串比较。
- SORT_LOCALE_STRING
(integer)
SORT_LOCALE_STRING 基于当前区域来对对象进行字符串比较。PHP
4.4.0 和 5.0.2 新加。
zspencer at zacharyspencer dot com
01-Nov-2006 10:59
The array system is sadly lacking a "set" function... I needed one that would set the pointer to the key that I specified.
So I wrote my own.
<?
$array=array();
$array['a']='lala';
$array['b']='blabla';
$array['c']='nono';
set($array, 'b');
echo current($array);
// outputs blabla
function set(&$array, $key)
{
reset($array);
while($current=key($array))
{
if($current==$key)
{
return true;
}
next($array);
}
return false;
}
?>
sneskid at hotmail dot com
24-Oct-2006 09:30
notice
<?php
$v = array();
$v['0'] = 's';
$v[0] = 'i';
echo $v['0'];
echo $v[0];
$v['.1'] = 's';
$v[.1] = 'i';
echo $v['.1'];
echo $v[.1];
$v['0.1'] = 's';
$v[0.1] = 'i';
echo $v['0.1'];
echo $v[0.1];
// output: iisi
foreach($v as $key => $val) echo $v[$key] . ' : ' . $val . "\r\n";
// output: iisi
?>
This means foreach preserves the key data type, it also means arrays distinguish between float numbers and float like strings, unlike integers
r2rien at gmail dot com
16-Oct-2006 08:06
Regarding the string to array (parse_array) function posted by Kevin Law(thanks) and urlencoded by vinaur(thanks) ,
The function will not work correctly if you use integer values as keys.
Thus I exchanged array_merge with a simple combined operator.
For example dealing with 4digit year strings as keys; parse_array(2006:abc,B:bcd) will produce
=> with array_merge:
<?php //...
$result = array_merge($result, parse_line2array(substr($line,$comma_pos+1)));
//...
$result = array_merge($result, parse_line2array($line));
//... ?>
Array (
[0] => abc
[B] => bcd
)
=> with combined operator:
<?php //...
$result += parse_line2array(substr($line,$comma_pos+1));
//...
$result += parse_line2array($line);
//... ?>
Array
(
[2006] => abc
[B] => bcd
)
Binny V A
06-Oct-2006 03:17
A small function to remove an element from a list(numerical array)
<?php
function array_remove($arr,$value) {
return array_values(array_diff($arr,array($value)));
}
?>
Or, if you don't like that...
<?php
function array_remove($arr,$value) {
if(!in_array($value,$arr)) return $arr;
unset($arr[array_search($value,$arr)]);
return array_values($arr);
}
?>
Binny V A
http://www.bin-co.com/php/
kthejoker - google mail
21-Sep-2006 01:00
re jeremyquintion:
your solution is array_merge(), which will reindex a numeric array.
So if you have
$array[0] = "something";
$array[1] = "something else";
$array[2] = "yet another";
unset($array[1]);
array_merge($array);
the result is
$array[0] = "something";
$array[1] = "yet another";
and then you can use a for loop accordingly. Obviously this isn't ideal if you want to maintain key association.
jeremyquinton at gmail dot com
31-Aug-2006 06:20
//using the foreach loop of php instead of a normal
//for loop with the sizeof operator after unset is used.
$values = array();
array_push($values,"lion");
array_push($values,"elephant");
array_push($values,"cheetah");
array_push($values,"wildebeest");
unset($values[2]);
//normal for loop thinks array size is three
//when sizoef function is used in conjunction
//the for loop.
for($i = 0;$i < sizeof($values); $i++) {
echo "animals " . $values[$i]. "\n";
}
//prints
animals lion
animals elephant
animals
echo "\n";
//foreach prints the three values left properly
foreach($values as $animals) {
echo "animal " . $animals. "\n";
}
//prints
animal lion
animal elephant
animal wildebeest
//simple but valid
ob at babcom dot biz
28-Aug-2006 11:18
Regarding my own posting 2 postings down about the function ArrayDepth() to find the maximum depth of a multidimensional array:
A number of functions for counting array dimensions have been posted. And I tried using them. Yet, if at all they only return the depth of the first branch of the array. They can not handle arrays where a later path holds a more dimension than the first.
My version will check all paths down the array and return the maximum depth. That's why I posted it.
ob at babcom dot biz
28-Aug-2006 08:56
Here are two functions Array2String() and String2Array() based on functions posted below by daenders AT yahoo DOT com.
An improvement handling NULL values correctly was posted by designatevoid at gmail dot com.
My version also solves the NULL-value-problem plus keeps support of multidimensional arrays.
<?php
// convert a multidimensional array to url save and encoded string
// usage: string Array2String( array Array )
function Array2String($Array) {
$Return='';
$NullValue="^^^";
foreach ($Array as $Key => $Value) {
if(is_array($Value))
$ReturnValue='^^array^'.Array2String($Value);
else
$ReturnValue=(strlen($Value)>0)?$Value:$NullValue;
$Return.=urlencode(base64_encode($Key)) . '|' . urlencode(base64_encode($ReturnValue)).'||';
}
return urlencode(substr($Return,0,-2));
}
?>
<?php
// convert a string generated with Array2String() back to the original (multidimensional) array
// usage: array String2Array ( string String)
function String2Array($String) {
$Return=array();
$String=urldecode($String);
$TempArray=explode('||',$String);
$NullValue=urlencode(base64_encode("^^^"));
foreach ($TempArray as $TempValue) {
list($Key,$Value)=explode('|',$TempValue);
$DecodedKey=base64_decode(urldecode($Key));
if($Value!=$NullValue) {
$ReturnValue=base64_decode(urldecode($Value));
if(substr($ReturnValue,0,8)=='^^array^')
$ReturnValue=String2Array(substr($ReturnValue,8));
$Return[$DecodedKey]=$ReturnValue;
}
else
$Return[$DecodedKey]=NULL;
}
return $Return;
}
?>
ob at babcom dot biz
28-Aug-2006 07:23
Here is a function to find out the maximum depth of a multidimensional array.
<?php
// return depth of given array
// if Array is a string ArrayDepth() will return 0
// usage: int ArrayDepth(array Array)
function ArrayDepth($Array,$DepthCount=-1,$DepthArray=array()) {
$DepthCount++;
if (is_array($Array))
foreach ($Array as $Key => $Value)
$DepthArray[]=ArrayDepth($Value,$DepthCount);
else
return $DepthCount;
foreach($DepthArray as $Value)
$Depth=$Value>$Depth?$Value:$Depth;
return $Depth;
}
?>
ob at babcom dot biz
28-Aug-2006 07:18
Regarding the function of spam at madhermit dot net from January 9th 2006:
That function only preserves the deepest keys and values.
If you try to flatten an array with that function where the deepest instance of keys might be the same where as keys in the "key-path" are different, values will be overwritten.
So here is a function that preserves the whole key-path and the keys of the flattened array will be string keys consisting of the key-path separated by $Separator.
<?php
// flatten multidimensional array to one dimension
// preserves keys by generating a key for the flattened array which consists of the
// key-path of the multidimensional array separated by $Separator
// usage: array ArrayFlatten( array Array [, string Separator] )
function ArrayFlatten($Array,$Separator="_",$FlattenedKey='') {
$FlattenedArray=Array();
foreach($Array as $Key => $Value) {
if(is_Array($Value))
$FlattenedArray=Array_merge($FlattenedArray,
ArrayFlatten($Value,$Separator,
(strlen($FlattenedKey)>0
?$FlattenedKey.$Separator
:"").$Key)
);
else
$FlattenedArray[$FlattenedKey.$Separator.$Key]=$Value;
}
return $FlattenedArray;
}
?>
sergio at {NO_SPAM_PLEASE]inservibile dot org
16-Aug-2006 08:17
In a pratical problem, I was involved in a system of queries giving the behaviour of all combinations of some parameters. How to write those queries?
The problem was to generate automatically every possible combination of those parameters. I didn't find a function and I wrote it.
(Naturally, a different way could be to build a binary sequence, but I find this function more compact and useful).
So, consider an array of objects and suppose to need all possibile combinations of those objects. Here is the function, that could be useful for some folk.
Enjoy.
<?php
function combinations($elements) {
if (is_array($elements)) {
/*
I want to generate an array of combinations, i.e. an array whose elements are arrays
composed by the elements of the starting object, combined in all possible ways.
The empty array must be an element of the target array.
*/
$combinations=array(array()); # don't forget the empty arrangement!
/*
Built the target array, the algorithm is to repeat the operations below for each object of the starting array:
- take the object from the starting array;
- generate all arrays given by the target array elements merged with the current object;
- add every new combination to the target array (the array of arrays);
- add the current object (as a vector) to the target array, as a combination of one element.
*/
foreach ($elements as $element) {
$new_combinations=array(); # temporary array, see below
foreach ($combinations as $combination) {
$new_combination=array_merge($combination,(array)$element);
# I cannot merge directly with the main array ($combinations) because I'm in the foreach cycle
# I use a temporary array
array_push($new_combinations,$new_combination);
}
$combinations=array_merge($combinations,$new_combinations);
}
return $combinations;
} else {
return false;
}
}
?>
To test the function:
<?php
$elements=array('bitter','sour','salty','sweet');
print_r(combinations($elements));
?>
The exemple was suggested in 6th century BC.
See why on: http://en.wikipedia.org/wiki/Combinatorics#Overview_and_history
Nicolai Bloch
11-Aug-2006 03:51
Here are two functions for checking if an array contains numeric or string indexes only.
Hope someone else will find them useful.
<?php
//Check for numeric array
function isNumeric($ar) {
$keys = array_keys($ar);
natsort($keys); //String keys will be last
return is_int(array_pop($keys));
}
//Check for associative array
function isAssoc($ar) {
$keys = array_keys($ar);
natsort($keys); //Numeric keys will be first
return is_string(array_shift($keys));
}
?>
za at byza dot it
20-Jul-2006 11:52
Updated functions for moving element between associative arrays using a numeric index.
Sample:
$a=array("04"=>"alpha",4=>"bravo","c"=>"charlie","d"=>"delta");
$b=array_move($a,4,2);
Move element "bravo" after "delta" keeping keys.
Old function probably goes wrong moving "alpha": caused by array_search that match numeric index 4 with "04" (string).
Follow:
<?php
// array functions - 20/07/2006 12.28
if(!defined("ARRAY_FUNCS")) {
// Swap 2 elements in array preserving keys.
function array_swap(&$array,$key1,$key2) {
$v1=$array[$key1];
$v2=$array[$key2];
$out=array();
foreach($array as $i=>$v) {
if($i===$key1) {
$i=$key2;
$v=$v2;
} else if($i===$key2) {
$i=$key1;
$v=$v1;
}
$out[$i]=$v;
}
return $out;
}
// Get a key position in array
function array_kpos(&$array,$key) {
$x=0;
foreach($array as $i=>$v) {
if($key===$i) return $x;
$x++;
}
return false;
}
// Return key by position
function array_kbypos(&$array,$pos) {
$x=0;
foreach($array as $i=>$v) {
if($pos==$x++) return $i;
}
return false;
}
// Move an element inside an array preserving keys
// $relpos should be like -1, +2...
function array_move(&$array,$key,$relpos) {
if(!$relpos) return false;
$from=array_kpos($array,$key);
if($from===false) return false;
$to=$from+$relpos+($relpos>0?1:0);
$len=count($array);
if($to>=$len) {
$val=$array[$key];
unset($array[$key]);
$array[$key]=$val;
} else {
if($to<0) $to=0;
$new=array();
$x=0;
foreach($array as $i=>$v) {
if($x++==$to) $new[$key]=$array[$key];
if($i!==$key) $new[$i]=$v;
}
$array=$new;
}
return $array;
}
define("ARRAY_FUNCS",true);
}
?>
g8z at yahoo dot com
20-Jul-2006 04:42
<?php
/**
filter_by_occurrence scans an array, and depending on the $exclusive parameter, includes or excludes elements occuring at least $min_occurences times, and at most $max_occurances times.
parameters:
$data_set = the array to work on
$min_occurrences = the minimum number of occurrences
$max_occurrences = the maximum number of occurrences (zero for unlimited)
$exclusive = if true, will return only results that do not occur within the specified bounds
Courtesy of the $5 Script Achive: http://www.tufat.com
**/
function filter_by_occurrence ($data_set, $min_occurrences, $max_occurrences = 0, $exclusive = false) {
$results = array();
// iterate through unique elements
foreach (array_unique($data_set) as $value) {
// count how many times element is in the array
$count = 0;
foreach ($data_set as $element) {
if ($element == $value)
$count++;
}
// check if meets min_occurences
$is_in_range = false;
if ($count >= $min_occurrences) {
// check if meets max_occurrences (unless max_occurences is 0)
if ( $count <= $max_occurrences || $max_occurrences == 0)
$is_in_range = true;
}
// add item to array if appropriate
if ($is_in_range && !$exclusive)
array_push($results, $value);
if (!$is_in_range && $exclusive)
array_push($results, $value);
}
// return results
return $results;
}
// EXAMPLE:
$test_data = array('pizza', 'ham', 'pizza', 'pizza', 'ham', 'fish', 'fish', 'fish', 'fish', 'dinosaur');
foreach (filter_by_occurrence( $test_data, 3, 0, false ) as $value)
{
print $value . ' occurs at least 3 times. <br />';
}
?>
nick
11-Jul-2006 08:46
This little function will move an array element up or down. Unlike the similar function in a previous comment this will work for associative arrays too.
Because it uses current to traverse the array it will fail if a value is false (or 0). It could probably be rewritten to use each() but I couldn't work it out.
<?php
function array_move_element($array, $value, $direction = 'up') {
$temp = array();
if(end($array) == $value && $direction == 'down') {
return $array;
}
if(reset($array) == $value && $direction == 'up') {
return $array;
}
while ($array_value = current($array)) {
$this_key = key($array);
if ($array_value == $value) {
if($direction == 'down') {
$next_value = next($array);
$temp[key($array)] = $next_value;
$temp[$this_key] = $array_value;
} else {
$prev_value = prev($array);
$prev_key = key($array);
unset($temp[$prev_key]);
$temp[$this_key] = $array_value;
$temp[$prev_key] = $prev_value;
next($array);
next($array);
}
continue;
} else {
$temp[$this_key] = $array_value;
}
next($array);
}
return $temp;
}
?>
kroczu at interia dot pl
06-Jul-2006 09:53
<?
//A little function to convert array to simle xml:
function array_xml($array, $num_prefix = "num_")
{
if(!is_array($array)) // text
{
return $array;
}
else
{
foreach($array as $key=>$val) // subnode
{
$key = (is_numeric($key)? $num_prefix.$key : $key);
$return.="<".$key.">".array_xml($val, $num_prefix)."</".$key.">";
}
}
return $return;
}
//example:
$array[0][0] = 1;
$array[0]['test'] = "test";
$array['test1']['test2'] = "test";
$array['test'][0] = "test";
$array['test'][1]['test_x'] = $array;
print_r($array);
print"<xml>";
print array_xml($array);
print"</xml>";
/*
print_r($array) previev:
Array
(
[0] => Array
(
[0] => 1
[test] => test
)
[test1] => Array
(
[test2] => test
)
[test] => Array
(
[0] => test
[1] => Array
(
[test_x] => Array
(
[0] => Array
(
[0] => 1
[test] => test
)
[test1] => Array
(
[test2] => test
)
[test] => Array
(
[0] => test
)
)
)
)
)
result xml in firefox preview:
-<xml>
- <num_0>
<num_0>1</num_0>
<test>test</test>
</num_0>
- <test1>
<test2>test</test2>
</test1>
- <test>
<num_0>test</num_0>
- <num_1>
- <test_x>
- <num_0>
<num_0>1</num_0>
<test>test</test>
</num_0>
- <test1>
<test2>test</test2>
</test1>
- <test>
<num_0>test</num_0>
</test>
</test_x>
</num_1>
</test>
</xml>
*/
?>
vinaur at gmail dot com
07-Jun-2006 04:36
Regarding the array to string (parse_line) and string to array (parse_array) functions posted below by Kevin Law.
The functions will not work correctly if the array being parsed contains values that include commas and possibly parentheses.
To solve this problem I added urlencode and urldecode functions and the result looks like this:
<?php
function parse_line($array){
$line = "";
foreach($array AS $key => $value){
if(is_array($value)){
$value = "(". parse_line($value) . ")";
}
else
{
$value = urlencode($value);
}
$line = $line . "," . urlencode($key) . ":" . $value . "";
}
$line = substr($line, 1);
return $line;
}
function parse_array($line){
$q_pos = strpos($line, ":");
$name = urldecode(substr($line,0,$q_pos));
$line = trim(substr($line,$q_pos+1));
$open_backet_pos = strpos($line, "(");
if($open_backet_pos===false || $open_backet_pos>0){
$comma_pos = strpos($line, ",");
if($comma_pos===false){
$result[$name] = urldecode($line);
$line = "";
}else{
$result[$name] = urldecode(substr($line,0,$comma_pos));
$result = array_merge($result, parse_array(substr($line,$comma_pos+1)));
$line = "";
}
}else if ($open_backet_pos==0){
$line = substr($line,1);
$num_backet = 1;
$line_char_array = str_split($line);
for($index = 0; count($line_char_array); $index++){
if($line_char_array[$index] == '('){
$num_backet++;
}else if ($line_char_array[$index] == ')'){
$num_backet--;
}
if($num_backet == 0){
break;
}
}
$sub_line = substr($line,0,$index);
$result[$name] = parse_array($sub_line);
$line = substr($line,$index+2);
}
if(strlen($line)!=0){
$result = array_merge($result, parse_array($line));
}
return $result;
}
?>
php_spam at erif dot org
28-May-2006 03:15
Public domain, yadda yadda. This is an extension of the assocSort below, patched up a bit. Feedback would be wonderful.
<?php
function assocMultiSort(&$array,$keys,$directions=true) {
if (!is_array($array) || count($array) == 0) return true;
if (!is_array($keys)) { $keys = Array($keys); }
//we want "current" instead of necessarily the "zeroth" element; there may not be a zeroth element
$test = current($array);
$assocSortCompare = '';
for ($i=0,$count=count($keys);$i<$count;$i++) {
$key = $keys[$i];
if (is_array($directions)) {
$direction = $directions[$i];
} else {
$direction = $directions;
}
if ($i > 0) $assocSortCompare .= 'if ($retval != 0) return $retval; ';
$assocSortCompare .= '$ax = $a["'.$key.'"]; $bx = $b["'.$key.'"];';
//TODO -- if it's "blank", search up the list until we find something not blank
if (is_numeric($test[$key]) || ($test[$key] == ((int)$test[$key]))) {
if ($direction) {
$assocSortCompare.= ' $retval = ($ax == $bx) ? 0 : (($ax < $bx) ? -1 : 1);';
} else {
$assocSortCompare.= ' $retval = ($ax == $bx) ? 0 : (($ax < $bx) ? 1 : -1);';
}
} else {
if ($direction) {
$assocSortCompare.= ' $retval = strcmp($ax,$bx);';
} else {
$assocSortCompare.= ' $retval = strcmp($bx,$ax);';
}
}
}
$assocSortCompare.= ' return $retval;';
$assocSortCompare = create_function('$a,$b',$assocSortCompare);
$retval = usort($array,$assocSortCompare);
return $retval;
}
?>
ben
14-Apr-2006 05:59
In reference to the cleanArray function below, note that it checks the value using the empty() function and removes it. This will also remove the integer value 0 and the string "0" among other possibly unexpected things. Check the manual entry for empty().
g dot bell at NOSPAM dot managesys dot com dot au
03-Apr-2006 06:57
/*
function to give array of ranks. Handles ties.
input $arr is zero based array to be ranked
$order is the sorting order
'asc' (default) ranks smallest as 1
'desc' ranks largest as 1
output zero based array of ranks.
Ties (repeated values) given equal (integer) values
*/
function array_rank($arr,$order='asc') {
// $direction parameter
foreach($arr as $being_ranked) {
$t1 = $t2 = 0;
if ($order == 'asc') {
foreach ($arr as $checking) {
if ($checking > $being_ranked) continue;
if ($checking < $being_ranked) {
$t1++;
} else {
$t2++; // equal so increment tie counter
}
}
} elseif ($order == 'desc') {
foreach ($arr as $checking) {
if ($checking < $being_ranked) continue;
if ($checking > $being_ranked) {
$t1++;
} else {
$t2++; // equal so increment tie counter
}
}
}
$ranks[] = floor($t1 + ($t2 + 1) / 2);
}
return $ranks;
}
administrador(ensaimada)sphoera(punt)com
31-Mar-2006 08:37
With this simple function you can convert a (partial) bidimensional array into a XHTML table structure:
<?php
$table = array();
$table[1][1] = "first";
$table[2][1] = "second";
$table[5][3] = "odd one";
$table[1][2] = "third";
echo matrix2table($table);
function matrix2table($arr,$tbattrs = "width='100%' border='1'", $clattrs="align='center'"){
$maxX = $maxY = 1;
for ($x=0;$x<100;$x++){
for ($y=0;$y<100;$y++){
if ($arr[$x][$y]!=""){
if ($maxX < $x) $maxX = $x;
if ($maxY < $y) $maxY = $y;
}
}
}
$retval = "<table $tbattrs>\n";
for ($x=1;$x<=$maxX;$x++){
$retval.=" <tr>\n";
for ($y=1;$y<=$maxY;$y++){
$retval.= (isset($arr[$x][$y]))
?" <td $clattrs>".$arr[$x][$y]."</td>\n"
:" <td $clattrs> </td>\n";
}
$retval.=" </tr>\n";
}
return $retval."</table>\n";
}
?>
more scripts at http://www.sphoera.com
elkabong at samsalisbury dot co dot uk
25-Mar-2006 06:31
Hello all! I've just been working on a system to automatically manage virtualhosts on an Apache box and I needed to duplicate some multidimensional arrays containing references to other multidimensional array some of which also contained references. These big arrays are defaults which need to be overwritten on a per-virtualhost basis, so copying references into the virtualhost arrays was not an option (as the defults would get corrupted).
After hours of banging me head on the wall, this is what I've come up with:
<?PHP # Tested on PHP Version 5.0.4
# Recursively set $copy[$x] to the actual values of $array[$x]
function array_deep_copy (&$array, &$copy) {
if(!is_array($copy)) $copy = array();
foreach($array as $k => $v) {
if(is_array($v)) {
array_deep_copy($v,$copy[$k]);
} else {
$copy[$k] = $v;
}
}
}
# To call it do this:
$my_lovely_reference_free_array = array();
array_deep_copy($my_array_full_of_references, $my_lovely_reference_free_array);
# Now you can modify all of $my_lovely_reference_free_array without
# worrying about $my_array_full_of_references!
?>
NOTE: Don't use this on self-referencing arrays! I haven't tried it yet but I'm guessing an infinate loop will occur...
I hope someone finds this useful, I'm only a beginner so if there's any fatal flaws or improvements please let me know!
alessandronunes at gmail dot com
19-Mar-2006 06:06
The Ninmja sugestion plus multidiomensional array search (recursive):
function cleanArray($array) {
foreach ($array as $index => $value) {
if(is_array($array[$index])) $array[$index] = cleanArray($array[$index]);
if (empty($value)) unset($array[$index]);
}
return $array;
}
padraig at NOSPAM dot ohannelly dot com
15-Mar-2006 01:08
Re removing blank elements from arrays, this is even more concise:
<?php
$arraytest = array_diff($arraytest, array(""));
?>
Nimja
23-Feb-2006 11:35
A very clean and efficient function to remove empty values from an Array.
<?php
function cleanArray($array) {
foreach ($array as $index => $value) {
if (empty($value)) unset($array[$index]);
}
return $array;
}
?>
|