배열 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 )
기타
- array_shift() - 배열의 시작 부분에서 요소 이동
- array_push() - 하나 이상의 요소를 배열의 끝으로 푸시
- array_pop() - 배열 끝에서 요소 팝