PHP의 array_unshift() 함수는 배열의 맨 앞에 하나 이상의 새로운 요소를 추가하는 데 사용됩니다. 요소가 추가되면 기존 요소들은 뒤로 밀려나고, 숫자 키는 0부터 다시 정렬됩니다.
문법
array_unshift(arr, val1, val2, val3)
매개변수
arr − 요소를 추가할 대상 배열입니다. 필수 값입니다.
val1 − 배열 앞에 삽입할 첫 번째 값입니다. 필수 값입니다.
val2 − 삽입할 두 번째 값입니다. 선택 사항입니다.
val3 − 삽입할 세 번째 값입니다. 선택 사항입니다.
반환값
array_unshift() 함수는 요소가 추가된 후 배열에 포함된 전체 요소의 개수를 반환합니다.
예제 1
다음은 array_unshift() 함수를 사용해 배열 맨 앞에 값을 추가하고, 반환값을 확인하는 예제입니다.
<?php
$arr = array("p"=>"one","q"=>"two");
print_r(array_unshift($arr,"three"));
?>
출력
3
"three"라는 값이 배열 앞에 추가되어 총 요소 수가 3개가 되었음을 확인할 수 있습니다.
예제 2
이번에는 함수 실행 후 실제 배열의 내용이 어떻게 변경되는지 살펴보겠습니다.
<?php
$arr = array("p"=>"one","q"=>"two");
array_unshift($arr,"three");
print_r($arr);
?>
출력
Array
(
[0] => three
[p] => one
[q] => two
)
새로 추가된 "three"는 숫자 키 [0]을 할당받고, 기존의 문자열 키인 "p"와 "q"는 그대로 유지되는 것을 볼 수 있습니다. 즉, 연관 배열에서도 문자열 키는 보존되지만 숫자 키는 항상 0부터 재정렬된다는 점을 기억하면 좋습니다.