View Discussion
Improve Article
Save Article
View Discussion
Improve Article
Save Article
The array_merge[] is a builtin function in PHP and is used to merge two or more arrays into a single array. This function is used to merge the elements or values of two or more arrays together into a single array. The merging occurs in such a manner that the values of one array are appended at the end of the previous array. The function takes the list of arrays separated by commas as a parameter that are needed to be merged and returns a new array with merged values of arrays passed in parameter.
Syntax:
array array_merge[$array1, $array2, ......, $arrayn]
Parameters: The array_merge[] function takes a list of arrays separated by commas as a parameter that are needed to be merged as shown in the syntax. There are n arrays [[$array1, $array2, ……, $arrayn] separated by [‘,’] in the syntax. We can pass any number of arrays in parameter.
Return Value: It returns a new array in which the elements of all arrays passed in parameters are merged such that the values of one array are appended at the end of the previous array.
Below programs illustrates the working of array_merge[] function in PHP:
- Merging Two Simple Arrays: When two more arrays are passed to the array_merge[] function then the values of one array are appended at the end of the previous array. If two elements have the same string keys then the latter value will be overridden. The integer keys will be renumbered starting from zero. To merge two arrays, the array_merge[] function can be executed in the following way:
Output:
Array [ [size] => medium [0] => 2 [1] => 3 [2] => a [3] => b [shape] => circle [4] => 4 ]
Note: If the input arrays contain the same string keys, then the later value for that key will overwrite the previous one.
- Passing parameter with integer keys: If parameters are passed to the array_merge[] function and the keys of this array parameter are an integer then the keys in the output array will be renumbered starting from 0 and incrementing for next elements by 1.
Below programs illustrates this:
Output:
Array [ [0] => Geeks [1] => for [2] => Geeks ]
Output:
Array [ [0] => zero_a [1] => two_a [2] => three_a [3] => one_b [4] => three_b [5] => four_b ]
❮ PHP Array Reference
Example
Merge two arrays into one array:
Try it Yourself »
Definition and Usage
The array_merge[] function merges one or more arrays into one array.
Tip: You can assign one array to the function, or as many as you like.
Note: If two or more array elements have the same key, the last one overrides the others.
Note: If you assign only one array to the array_merge[] function, and the keys are integers, the function returns a new array with integer keys starting at 0 and increases by 1 for each value [See example below].
Tip: The difference between this function and the array_merge_recursive[] function is when two or more array elements have the same key. Instead of override the keys, the array_merge_recursive[] function makes the value as an array.
Syntax
array_merge[array1, array2, array3, ...]
Parameter Values
array1 | Required. Specifies an array |
array2 | Optional. Specifies an array |
array3,... | Optional. Specifies an array |
Technical Details
Returns the merged array |
4+ |
As of PHP 5.0, this function only accept parameters of type array |
More Examples
Example
Merge two associative arrays into one array:
Try it Yourself »
Example
Using only one array parameter with integer keys:
Try it Yourself »
❮ PHP Array Reference