배열 array_unshift

(PHP 4, PHP 5, PHP 7, PHP 8)

array_unshift — 배열의 시작 부분에 하나 이상의 요소를 추가합니다.


설명

array_unshift(array &$array, mixed ...$values): int

array_unshift()는 전달된 요소를 array 앞에 추가합니다. 요소 목록은 전체적으로 앞에 추가되므로 앞에 추가된 요소가 동일한 순서로 유지됩니다. 모든 숫자 배열 키는 0부터 계산을 시작하도록 수정되지만 리터럴 키는 변경되지 않습니다.

메모: 배열의 내부 포인터를 첫 번째 요소로 재설정합니다.


매개변수

array
입력 배열입니다.
values
앞에 추가할 값입니다.

반환 값

array의 새로운 요소 수를 반환합니다.


변경 로그

버전 설명
7.3.0 이 함수는 이제 하나의 매개변수로 호출할 수 있습니다. 이전에는 두 개 이상의 매개변수가 필요했습니다.

Examples

예제 #1 array_unshift() 예제

                  
<?php
$queue = array("orange", "banana");
array_unshift($queue, "apple", "raspberry");
print_r($queue);
?>
                  
                

위의 예는 다음을 출력합니다.

Array
(
    [0] => apple
    [1] => raspberry
    [2] => orange
    [3] => banana
)
                

기타