PHP中的数组函数

系统管理员 2022-07-14 06:43 209阅读 0赞

#### 1. array\_column ####

函数原型：
    array_column ( array $input , mixed $column_key [, mixed $index_key = null ] )
    
    功能描述：
    可用来返回二维数组中指定的某一列或所有列。（返回所有列时，第二个参数为 null，配合第三个参数来重新设置数组的键，非常管用）。
    
    示例：
    <?php 
    $records = array(
        array('id' => 2135,'name' => 'John'),
        array('id' => 3245,'name' => 'Smith'),
        array('id' => 5342,'name' => 'Peter')
    );
    
    //从结果集中取出 name 列
    $names = array_column($records, 'name');
    print_r($names);
    
    //从结果集中取出 name 列，并用相应的 id 作为键
    $names = array_column($records, 'name', 'id');
    print_r($names);
    
    //从结果集中取出所有列，并用相应的 id 作为键
    $names = array_column($records, null, 'id');
    print_r($names);

#### 2. array\_combine ####

函数原型：
    array_combine ( array $keys , array $values )
    
    功能描述：
    用来自 keys 数组的值作为键名，来自 values 数组的值作为相应的值，返回数组。
    如果两个数组的单元数不同或者数组为空时返回FALSE。
    
    示例：
    $arr = array_combine(array('id', 'name'), array('1', 'jack'));
    var_dump($arr);

#### 3. array\_merge ####

函数原型：
    array_merge ( array $array1 [, array $array2 [, array $... ]] )
    
    功能描述：
    合并一个或多个数组，后一个数组中的值附加在前一个数组的后面，返回合并后的数组。
    如果数组中有相同的字符串键名，后面的值将覆盖前面的值。
    
    示例：
    $arr = array_merge( array('a', 'b') , array('b', 'c'));
    var_dump($arr);

#### 4. array\_merge\_recursive ####

函数原型：
    array_merge_recursive ( array $array1 [, array $... ] )
    
    功能描述：
    递归合并一个或多个数组，后一个数组中的值附加在前一个数组的后面，返回合并后的数组。
    如果数组中有相同的字符串键名，对应的值会合并放到一个数组中。

#### 5. range ####

函数原型：
    range ( mixed $low , mixed $high [, number $step ] )	
    
    功能描述：
    将从$low到$high的单元（包括它们本身）放入数组中，返回该数组。
    如果 $low > $high，则是逆序数组。
    
    示例：
    $arr = range ( 'a' , 'f' );

#### 6. extract ####

函数原型：
    extract ( array $var_array [, int $extract_type [, string $prefix ]] )
    
    功能描述：
    从数组中将变量导入到当前的符号表，键名当作变量名，值作为变量的值。
    每个键值对都会在当前的符号表中建立变量，受extract_type和prefix参数的影响。
    
    示例：
    extract ( $_GET );

#### 7. compact ####

函数原型：
    compact ( mixed $varname [, mixed $... ] )
    
    功能描述：
    变量名成为键名而变量的值成为该键对应的值，返回将所有变量添加进去后的数组。
    和extract(）的作用正好相反。
    
    示例：
    $id = 1;
    $name = 'jack';
    $arr = compact ( 'id', 'name');
    var_dump($arr);

#### 8. array\_chunk ####

函数原型：
    array_chunk ( array $input , int $size [, bool $preserve_keys ] )
    
    功能描述：
    将数组分割成一个多维数组，每个子数组的元素个数由$size决定，返回新的数组。

#### 9. array\_slice ####

函数原型：
    array_slice ( array $array , int $offset [, int $length [, bool $preserve_keys ]] )
    
    功能描述：
    从数组中截取一部分元素作为新的数组返回。
    $offset表示起始位置（包括该位置的元素）。
    $length为正时，表示截取的长度；为负时，表示结束位置（不包括结束位置的元素）。

#### 10. array\_splice ####

函数原型：
    array_splice ( array &$input , int $offset [, int $length [, array $replacement ]] )	
    
    功能描述：
    从数组中去掉一部分元素，返回被移除的数组单元。
    如果给了第四个参数，则将$replacement从$offset位置处插入到$input数组中。  
    
    注意：$input数组本身发生了变化。

#### 11. array\_diff ####

函数原型：
    array_diff ( array $array1 , array $array2 [, array $ ... ] )
    
    功能描述：
    计算多个数组的差集，返回差集数组。
    该数组包含了所有在 $array1 中但不在其它数组中的值。
    
    注意：键名保持不变。

#### 12. array\_diff\_key ####

函数原型：
    array_diff_key ( array $array1 , array $array2 [, array $... ] )
    
    功能描述：
    根据键名计算多个数组的差集，返回差集数组。
    除了比较是根据键名而不是值来进行的之外，本函数和array_diff( )相同。

#### 13. array\_intersect ####

函数原型：
    array_intersect ( array $array1 , array $array2 [, array $ ... ] )
    
    功能描述：
    计算多个数组的交集，返回交集数组。
    该数组包含了所有在 $array1 中同时也在其它数组中的值。
    
    注意：键名保持不变。

#### 14. array\_search ####

函数原型：
    array_search ( mixed $needle , array $haystack [, bool $strict ] )
    
    功能描述：
    在数组中搜索给定的值，成功则返回相应的键名（返回第一次匹配的键），失败返回false。
    如果 $needle 是字符串，会区分大小写。

#### 15. array\_keys ####

函数原型：
    array_keys ( array $input [, mixed $search_value [, bool $strict ]] )
    
    功能描述：
    将数组中的所有键名以数组的形式返回。
    如果指定了可选参数 $search_value，则只返回匹配该值的键名。

#### 16. array\_key\_exists ####

函数原型：
    array_key_exists ( mixed $key , array $search )
    
    功能描述：
    判断给定的键名是否存在于数组中，返回布尔值。

#### 17. in\_array ####

函数原型：
    in_array ( mixed $needle , array $haystack [, bool $strict ] )
    
    功能描述：
    判断给定的值是否存在于数组中，返回布尔值。

#### 18. array\_values ####

函数原型：
    array_values ( array $input )
    
    功能描述：
    将数组中所有的值以数组的形式返回，新数组会重新建立数字索引。

#### 19. array\_sum ####

函数原型：
    array_sum ( array $array )
    
    功能描述：
    计算数组中所有值的和，并将其以整数或浮点数的形式返回。

#### 20. key ####

函数原型：
    key ( array &$array )
    
    功能描述：
    返回数组的内部指针当前指向的元素的键名。

#### 21. current ####

函数原型：
    current ( array &$array )
    
    功能描述：
    返回数组的内部指针当前指向的元素的值。

#### 22. next ####

函数原型：
    next ( array &$array )
    
    功能描述：
    将数组的内部指针，向后移动一位，返回移动后指针指向的元素的值。

#### 23. prev ####

函数原型：
    prev ( array &$array )
    
    功能描述：
    将数组的内部指针，向前移动一位，返回移动后指针指向的元素的值。

#### 24. reset ####

函数原型：
    reset ( array &$array )
    
    功能描述：
    将数组的内部指针重置（即回到初始位置，指向第一个元素），返回第一个元素的值。

#### 25. array\_push ####

函数原型：
    array_push ( array &$array , mixed $var [, mixed $... ] )
    
    功能描述：
    将一个或多个元素压入数组的末尾（入栈），返回新数组的长度。
    
    如果用 array_push() 来给数组增加一个单元，还不如用 $array[] = ，因为这样没有调用函数的额外负担。
    
    注意：$array 本身发生了变化。

#### 26. array\_pop ####

函数原型：
    array_pop ( array &$array )
    
    功能描述：
    将数组的最后一个元素弹出（出栈），返回被删除的元素的值。
    
    注意：$array 本身发生了变化。

#### 27. array\_unshift ####

函数原型：
    array_unshift ( array &$array , mixed $var [, mixed $... ] )
    
    功能描述：
    将一个或多个元素插入数组的开头，返回新数组的长度。
    
    注意：$array 本身发生了变化。

#### 28. array\_shift ####

函数原型：
    array_shift ( array &$array )
    
    功能描述：
    将数组的开头元素删除，返回被删除的元素的值。
    
    注意：$array 本身发生了变化。

#### 29. shuffle ####

函数原型：
    shuffle ( array &$array )
    
    功能描述：
    将数组中元素的顺序打乱，同时会删除原有的键名，并启用数字索引。返回布尔值。
    
    注意：$array 本身发生了变化。

#### 30. sort ####

函数原型：
    sort ( array &$array [, int $sort_flags ] )
    
    功能描述：
    将数组中的元素按照值从低到高的顺序排列，同时删除原有的键名，并启用数字索引。返回布尔值。
    
    注意：$array 本身发生了变化。

#### 31. asort ####

函数原型：
    asort ( array &$array [, int $sort_flags ] )
    
    功能描述：
    将数组中的元素按照值从低到高的顺序排列，同时保留键名。返回布尔值。
    
    注意：$array 本身发生了变化。

#### 32. rsort ####

函数原型：
    rsort ( array &$array [, int $sort_flags ] )
    
    功能描述：
    将数组中的元素按照值从高到低的顺序排列，同时删除原有的键名，并启用数字索引。返回布尔值。 
    
    注意：$array 本身发生了变化。

#### 33. arsort ####

函数原型：
    arsort ( array &$array [, int $sort_flags ] )
    
    功能描述：
    将数组中的元素按照值从高到低的顺序排列，同时保留键名。返回布尔值。
    
    注意：$array 本身发生了变化。

#### 34. ksort ####

函数原型：
    ksort ( array &$array [, int $sort_flags ] )
    
    功能描述：
    将数组按照键名从低到高的顺序排列，同时保留键名。返回布尔值。
    
    注意：$array 本身发生了变化。

#### 35. krsort ####

函数原型：
    krsort ( array &$array [, int $sort_flags ] )
    
    功能描述：
    将数组按照键名从高到低的顺序排列，同时保留键名。返回布尔值。 
    
    注意：$array 本身发生了变化。

#### 36. natsort ####

函数原型：
    natsort ( array &$array )
    
    功能描述：
    用“自然排序”算法将数组按照值从低到高的顺利排列，同时保留键名，返回布尔值。
    
    注意：$array 本身发生了变化。

#### 37. natcasesort ####

函数原型：
    natcasesort ( array &$array )
    
    功能描述：
    用“自然排序”算法将数组按照值（不区分大小写）从低到高的顺利排列，同时保留键名，返回布尔值。 
    
    注意：$array 本身发生了变化。

#### 38. array\_rand ####

函数原型：
    array_rand ( array $input [, int $num_req ] )
    
    功能描述：
    随机从数组中取出一个或多个元素的键名返回。
    $num_req表示取出的键名的个数，如果大于1，则返回包含多个键名的数组，默认值为1。

#### 39. count ####

函数原型：
    count ( mixed $var [, int $mode ] )
    
    功能描述：
    计算数组中元素的个数（数组的长度），返回该数目。
    如果是多维数组，可以指定第二个参数为COUNT_RECURSIVE或1，则会对多维数组进行递归计算。

#### 40. array\_flip ####

函数原型：
    array_flip ( array $trans )	
    
    功能描述：
    交换数组中的键和值，返回新的数组。

#### 41. array\_reverse ####

函数原型：
    array_reverse ( array $array )
    
    功能描述：
    将数组中元素的顺序进行颠倒，返回新的数组，同时保留键值对的对应关系。

#### 42. array\_unique ####

函数原型：
    array_unique ( array $array )
    
    功能描述：
    删除数组中重复的元素，返回新的数组。

#### 43. array\_change\_key\_case ####

函数原型：array_change_key_case ( array $input [, int $case ] ) 
    
    功能描述：
    将数组中的键名全部转换为小写或大写，返回新的数组。
    默认转换为小写，第二个参数有两个可选的常量：CASE_UPPER 和 CASE_LOWER。

#### 44. implode ####

函数原型：
    implode ( string $glue , array $pieces ) 
    
    功能描述：
    用指定的元素将数组中所有元素的值粘合为一个字符串，并返回该字符串。  
    implode()函数的别名为join()函数。

#### 45. array\_map ####

函数原型：
    array_map ( callable $callback , array $arr1 [, array $... ] )
    
    功能描述：
    用回调函数映射处理数组中的每一个值，返回处理后的新数组。
    
    示例：
    $a = array(1,2,3);
    $b = array_map(function($v){return $v?$v*$v:0;}, $a);

#### 46. list ####

函数原型：
    list ( mixed $varname , mixed $... )
    
    功能描述：
    把数组中的值依次赋给一些变量，没有返回值。
    
    注意：list() 仅能用于数组的数字索引部分，并假定数字索引从 0 开始。 
    
    示例：
    <?php 
    list($a, $b) = array('100', '200');
    echo $a.'-'.$b;   // 100-200

#### 47. each ####

函数原型：
    each ( array &$array )
    
    功能描述：
    将数组中当前指针指向的的键值对形成一个包含四个元素的新数组，返回该新数组，并将指针向后移动一位。
    
    键值对被返回为包含四个单元的新数组，新数组的键名为 0，1，key 和 value。
    0 和 key 对应的值为键值对的键，1 和 value 对应键值对的值。 
    
    示例：
    <?php 
    $arr = array('name'=>'jack', 'age'=>18);
    $newArr = each($arr);
    var_dump($newArr);
    
    输出结果为：
    array(4) {
      [1]=>
      string(4) "jack"
      ["value"]=>
      string(4) "jack"
      [0]=>
      string(4) "name"
      ["key"]=>
      string(4) "name"
    }

#### 48. array\_filter ####

函数原型:
    array_filter  ( array $input  [, callable  $callback  = "" ] )
    
    功能描述：
    依次将数组中的每个值传递到 callback 函数。如果 callback 函数返回 TRUE ，则 input 数组的当前值会被包含在返回的结果数组中，数组的键名保留不变。 返回处理后的数组。
    
    如果没有提供 callback 函数， 则删除 input 中所有值为 false 的单元。

#### 49. array\_walk ####

函数原型：
    array_walk  ( array &$array  , callable  $funcname  [, mixed  $userdata  = NULL ] )
    
    功能描述：
    使用用户自定义函数对数组中的每个元素做回调处理。返回布尔值。
    
    参数说明：
    第二个参数：回调函数，它接受两个或三个参数。数组元素的值作为第一个，键名作为第二个。 
    如果 funcname 需要直接作用于数组中的值，则将 funcname 的第一个参数指定为引用。这样任何对这些单元的改变将会改变原始数组本身。
    
    第三个参数：如果提供了可选参数 userdata，将被作为第三个参数传递给 funcname。
    
    示例：
    $a = array(3,4,5);
    $b = array();
    array_walk($a, function($v,$k) use(&$b){ $k="id_".$k; $b[$k]=$v;} );

#### 50. array\_walk\_recursive ####

函数原型：
    array_walk_recursive  ( array &$input  , callable  $funcname  [, mixed  $userdata  = NULL ] )
    
    功能描述：
    使用用户自定义函数对数组中的每个元素递归做回调处理。返回布尔值。
    
    参数说明同array_walk。
    
    注意：如果数组中某个元素的值也是一个数组，该元素本身不会被回调函数funcname处理，而是递归到它的内部进行处理。
    
    示例：
    $a = array('id'=>array(3,4), 'name'=>'jack');
    array_walk_recursive($a, function ($v,$k) { echo $k.'=>'.$v.'</br>'; });
    
    输出结果为：
    0=>3
    1=>4
    name=>jack

#### 51. usort ####

函数原型：bool usort ( array &$array , callable $cmp_function )
    
    功能描述：使用用户自定义的比较函数对数组中的值进行排序（会自动删除原来的键名）。
    
    本函数将用用户自定义的比较函数对一个数组中的值进行排序。如果要排序的数组需要用一种不寻常的标准进行排序，就使用此函数。 
    
    参数说明：
    $array：输入的数组。 
    $cmp_function：在第一个参数小于，等于或大于第二个参数时，该比较函数必须相应地返回一个小于，等于或大于 0 的整数。
    
    示例：
    $arr = ['a1'=>10, 'a2'=>5, 'a3'=>100, 'a4'=>9, 'a5'=>3];
    usort($arr, function($a, $b){if($a==$b) return 0;return $a>$b ? 1 : -1;});
    var_dump($arr);
    
    上述写法是按照值升序排序，如果把1和-1的位置调换，就是降序排序。

#### 52. uksort ####

函数原型：bool uksort ( array &$array , callable $cmp_function )
    
    功能描述：使用用户自定义的比较函数对数组中的键名进行排序。
    
    uksort() 函数将使用用户提供的比较函数对数组中的键名进行排序。如果要排序的数组需要用一种不寻常的标准进行排序，那么应该使用此函数。 
    
    参数说明：
    $array：输入的数组。 
    $cmp_function：在第一个参数小于，等于或大于第二个参数时，该比较函数必须相应地返回一个小于，等于或大于 0 的整数。
    
    示例：
    $arr = ['a1'=>10, 'a2'=>5, 'a3'=>100, 'a4'=>9, 'a5'=>3];
    uksort($arr, function($a, $b){if($a==$b) return 0;return $a>$b ? 1 : -1;});
    var_dump($arr);
    
    上述写法是按照键名升序排序，如果把1和-1的位置调换，就是降序排序。