array_unshift() 함수

array_unshift() 함수는
배열의 시작 부분에(unshift, 위치 변경 없이 앞에서부터 순서대로) 하나 이상의 요소를 추가하는 함수입니다.
배열의 새로운 길이를 반환합니다.

PHP 
$array = [1, 2, 3];

// 배열 시작 부분에 하나의 요소를 추가합니다.
array_unshift($array, 4);
print_r($array);
/*
출력:
    Array
    (
        [0] => 4
        [1] => 1
        [2] => 2
        [3] => 3
    )
*/

// 배열 시작 부분에 여러 개의 요소를 추가합니다.
array_unshift($array, 5, 6, 7);
print_r($array);
/*
출력:
    Array
    (
        [0] => 5
        [1] => 6
        [2] => 7
        [3] => 4
        [4] => 1
        [5] => 2
        [6] => 3
    )
*/

array_unshift() 함수의 형식은 다음과 같습니다.

구문

PHP 
array_unshift(array &$array, mixed $value1 [, mixed $value2 [, mixed $... ]]): int

매개변수

array_unshift() 함수의 매개변수
&$array 요소를 추가할 대상 배열(참조 변수)입니다.
$value1, $value2, $... 배열 시작 부분에 추가할 요소(들)입니다. 배열에 추가할 하나 이상의 값을 지정할 수 있습니다.

반환 값

반환 값은 배열에 요소가 추가된 후의 총 요소 개수를 나타냅니다. 이 값은 정수(예: 1, 2, 3, ...)로 반환됩니다.

PHP array_unshift() 함수의 반환 값 
$array = [1, 2, 3];

// 배열 시작 부분에 하나의 요소를 추가하고 반환 값 저장
$totalElements = array_unshift($array, 4);
print_r($array);
/*
출력:
    Array
    (
        [0] => 4
        [1] => 1
        [2] => 2
        [3] => 3
    )
*/

echo '배열에 추가된 요소의 총 수: ' . $totalElements; // 출력: 배열에 추가된 요소의 총 수: 4

사용 예시

다음은 array_unshift() 함수를 사용하는 예제입니다.
여러 개의 요소를 추가하려면 array_unshift() 함수에 추가하려는 요소들을 쉼표(,)로 구분해서 순서대로 나열하면 됩니다.

PHP 
$fruits = ['apple', 'banana', 'cherry'];

// 배열 시작 부분에 요소 추가
array_unshift($fruits, 'date', 'elderberry');

// 배열의 내용 확인
print_r($fruits);
/*
출력:
    Array
    (
        [0] => date
        [1] => elderberry
        [2] => apple
        [3] => banana
        [4] => cherry
    )
*/

array_unshift() 함수를 사용한 배열 요소의 역순 배열

배열의 요소들을 역순으로 변경하고자 할 때 array_unshift() 함수를 사용할 수 있습니다.

PHP 
$numbers = [1, 2, 3, 4, 5];
$reversedNumbers = [];

foreach ($numbers as $number) {
    array_unshift($reversedNumbers, $number);
}

print_r($reversedNumbers);
/*
출력:
    Array
    (
        [0] => 5
        [1] => 4
        [2] => 3
        [3] => 2
        [4] => 1
    )
*/
  1. 먼저, $numbers라는 배열을 정의하고 초깃값으로 [1, 2, 3, 4, 5]를 가지고 있습니다.
  2. $reversedNumbers라는 빈 배열을 생성합니다. 이 배열은 나중에 역순으로 변경된 요소들을 저장할 용도로 사용됩니다.
  3. foreach() 반복문을 사용하여 $numbers 배열의 각 요소를 반복적으로 처리합니다. 반복문의 각 반복에서 현재 요소를 $number 변수에 저장합니다.
  4. array_unshift($reversedNumbers, $number) 함수를 사용하여 $reversedNumbers 배열의 시작 부분에 현재 요소인 $number를 추가합니다. 이 과정을 반복하면서 요소들이 역순으로 $reversedNumbers 배열에 추가됩니다.
foreach() 반복문 사용법 및 활용 예제

이 결과로 $reversedNumbers 배열은 $numbers 배열의 역순으로 요소가 저장되며, 역순된 순서대로 [5, 4, 3, 2, 1]과 같은 값을 가지게 됩니다.

이 코드를 실행하면 $numbers 배열의 순서가 뒤집혀서 $reversedNumbers 배열에 저장되는 것을 확인할 수 있습니다. 이와 같은 방식으로 배열을 역순으로 정렬할 수 있습니다.

참고문헌

같이 보기