PHP1234|PHP修炼之路|跟着明礼馨德一起修炼PHP

【函数功能】

该函数用于向数组插入新元素，新数组的值将被插入到数组的开头。

【函数语法】

array_unshift (array &$array, $value1, $_ = null)

【参数说明】

&$array：必需，原始数组。
$value1：必需，要插入的值。
$_：可选，要插入的值。

【演示程序】

<?php
        /**
         * array_unshift (array &$array, $value1, $_ = null)
         * **/
         $array = array('site_name'=>'PHP1234','site_url'=>'php1234.cn','site_auth'=>'明礼馨德');
         array_unshift($array, 'ThinkPHP','PHP');
         var_dump($array);
?>

【输出结果】

array(5) { [0]=> string(8) "ThinkPHP" [1]=> string(3) "PHP" ["site_name"]=> string(7) "PHP1234" ["site_url"]=> string(10) "php1234.cn" ["site_auth"]=> string(12) "明礼馨德" }

【特别注意】

1.被加上的元素作为一个整体添加，这些元素在数组中的顺序和在参数中的顺序一样。
2.该函数会返回数组中元素的个数。
3.可以插入一个或多个值。
4.数值键名将从 0 开始，以 1 递增。字符串键名将保持不变。
5.PHP 版本：4+。

【原版定义】

/**
 * Prepend one or more elements to the beginning of an array
 * @link http://www.php.net/manual/en/function.array-unshift.php
 * @param array array <p>
 * The input array.
 * </p>
 * @param value1 mixed <p>
 * First value to prepend.
 * </p>
 * @param _ mixed[optional] 
 * @return int the new number of elements in the array.
 */

转载请注明出处：php1234.cn ,原文地址：http://www.php1234.cn/a/functions/2016/1226/172.html