array_replace_recursive(3) [php man page]

ARRAY_REPLACE_RECURSIVE(3)						 1						ARRAY_REPLACE_RECURSIVE(3)

array_replace_recursive - Replaces elements from passed arrays into the first array recursively

SYNOPSIS

       array array_replace_recursive (array  $array1, array  $array2, [array  $...])

DESCRIPTION

       array_replace_recursive(3) replaces the values of $array1 with the same values from all the following arrays. If a key from the first array
       exists in the second array, its value will be replaced by the value from the second array. If the key exists in the second array,  and  not
       the  first,  it	will  be created in the first array. If a key only exists in the first array, it will be left as is. If several arrays are
       passed for replacement, they will be processed in order, the later array overwriting the previous values.

       array_replace_recursive(3) is recursive : it will recurse into arrays and apply the same process to the inner value.

	When the value in $array1 is scalar, it will be replaced by the value in $array2, may it be scalar or array. When the value in $array1 and
       $array2 are both arrays, array_replace_recursive(3) will replace their respective value recursively.

PARAMETERS

	      o $array1
		- The array in which elements are replaced.

	      o $array2
		- The array from which elements will be extracted.

	      o $...
		- Optional. More arrays from which elements will be extracted.

RETURN VALUES

	Returns an array, or NULL if an error occurs.

EXAMPLES

       Example #1

	      array_replace_recursive(3) example

	      <?php
	      $base = array('citrus' => array( "orange") , 'berries' => array("blackberry", "raspberry"), );
	      $replacements = array('citrus' => array('pineapple'), 'berries' => array('blueberry'));

	      $basket = array_replace_recursive($base, $replacements);
	      print_r($basket);

	      $basket = array_replace($base, $replacements);
	      print_r($basket);
	      ?>

	      The above example will output:

	      Array
	      (
		  [citrus] => Array
		      (
			  [0] => pineapple
		      )

		  [berries] => Array
		      (
			  [0] => blueberry
			  [1] => raspberry
		      )

	      )
	      Array
	      (
		  [citrus] => Array
		      (
			  [0] => pineapple
		      )

		  [berries] => Array
		      (
			  [0] => blueberry
		      )

	      )

       Example #2

	      array_replace_recursive(3) and recursive behavior

	      <?php
	      $base = array('citrus' => array("orange") , 'berries' => array("blackberry", "raspberry"), 'others' => 'banana' );
	      $replacements = array('citrus' => 'pineapple', 'berries' => array('blueberry'), 'others' => array('litchis'));
	      $replacements2 = array('citrus' => array('pineapple'), 'berries' => array('blueberry'), 'others' => 'litchis');

	      $basket = array_replace_recursive($base, $replacements, $replacements2);
	      print_r($basket);

	      ?>

	      The above example will output:

	      Array
	      (
		  [citrus] => Array
		      (
			  [0] => pineapple
		      )

		  [berries] => Array
		      (
			  [0] => blueberry
			  [1] => raspberry
		      )

		  [others] => litchis
	      )

SEE ALSO

       array_replace(3), array_merge_recursive(3).

PHP Documentation Group 												ARRAY_REPLACE_RECURSIVE(3)

ARRAY_MAP(3)								 1							      ARRAY_MAP(3)

array_map - Applies the callback to the elements of the given arrays

SYNOPSIS

       array array_map (callable  $callback, array  $array1, [array  $...])

DESCRIPTION

       array_map(3)  returns  an  array  containing  all  the elements of $array1 after applying the $callback function to each one. The number of
       parameters that the $callback function accepts should match the number of arrays passed to the array_map(3)

PARAMETERS

	      o $callback
		- Callback function to run for each element in each array.

	      o $array1
		- An array to run through the $callback function.

	      o $...
		- Variable list of array arguments to run through the $callback function.

RETURN VALUES

	Returns an array containing all the elements of $array1 after applying the $callback function to each one.

EXAMPLES

       Example #1

	      array_map(3) example

	      <?php
	      function cube($n)
	      {
		  return($n * $n * $n);
	      }

	      $a = array(1, 2, 3, 4, 5);
	      $b = array_map("cube", $a);
	      print_r($b);
	      ?>

	       This makes $b have:

	      Array
	      (
		  [0] => 1
		  [1] => 8
		  [2] => 27
		  [3] => 64
		  [4] => 125
	      )

       Example #2

	      array_map(3) using a lambda function (as of PHP 5.3.0)

	      <?php
	      $func = function($value) {
		  return $value * 2;
	      };

	      print_r(array_map($func, range(1, 5)));
	      ?>

	      Array
	      (
		  [0] => 2
		  [1] => 4
		  [2] => 6
		  [3] => 8
		  [4] => 10
	      )

       Example #3

	      array_map(3) - using more arrays

	      <?php
	      function show_Spanish($n, $m)
	      {
		  return("The number $n is called $m in Spanish");
	      }

	      function map_Spanish($n, $m)
	      {
		  return(array($n => $m));
	      }

	      $a = array(1, 2, 3, 4, 5);
	      $b = array("uno", "dos", "tres", "cuatro", "cinco");

	      $c = array_map("show_Spanish", $a, $b);
	      print_r($c);

	      $d = array_map("map_Spanish", $a , $b);
	      print_r($d);
	      ?>

	      The above example will output:

	      // printout of $c
	      Array
	      (
		  [0] => The number 1 is called uno in Spanish
		  [1] => The number 2 is called dos in Spanish
		  [2] => The number 3 is called tres in Spanish
		  [3] => The number 4 is called cuatro in Spanish
		  [4] => The number 5 is called cinco in Spanish
	      )

	      // printout of $d
	      Array
	      (
		  [0] => Array
		      (
			  [1] => uno
		      )

		  [1] => Array
		      (
			  [2] => dos
		      )

		  [2] => Array
		      (
			  [3] => tres
		      )

		  [3] => Array
		      (
			  [4] => cuatro
		      )

		  [4] => Array
		      (
			  [5] => cinco
		      )

	      )

	Usually when using two or more arrays, they should be of equal length because the callback function is applied in parallel to  the  corre-
       sponding  elements. If the arrays are of unequal length, shorter ones will be extended with empty elements to match the length of the long-
       est.

	An interesting use of this function is to construct an array of arrays, which can be easily performed by using NULL as	the  name  of  the
       callback function

       Example #4

	      Creating an array of arrays

	      <?php
	      $a = array(1, 2, 3, 4, 5);
	      $b = array("one", "two", "three", "four", "five");
	      $c = array("uno", "dos", "tres", "cuatro", "cinco");

	      $d = array_map(null, $a, $b, $c);
	      print_r($d);
	      ?>

	      The above example will output:

	      Array
	      (
		  [0] => Array
		      (
			  [0] => 1
			  [1] => one
			  [2] => uno
		      )

		  [1] => Array
		      (
			  [0] => 2
			  [1] => two
			  [2] => dos
		      )

		  [2] => Array
		      (
			  [0] => 3
			  [1] => three
			  [2] => tres
		      )

		  [3] => Array
		      (
			  [0] => 4
			  [1] => four
			  [2] => cuatro
		      )

		  [4] => Array
		      (
			  [0] => 5
			  [1] => five
			  [2] => cinco
		      )

	      )

	If the array argument contains string keys then the returned array will contain string keys if and only if exactly one array is passed. If
       more than one argument is passed then the returned array always has integer keys.

       Example #5

	      array_map(3) - with string keys

	      <?php
	      $arr = array("stringkey" => "value");
	      function cb1($a) {
		  return array ($a);
	      }
	      function cb2($a, $b) {
		  return array ($a, $b);
	      }
	      var_dump(array_map("cb1", $arr));
	      var_dump(array_map("cb2", $arr, $arr));
	      var_dump(array_map(null,	$arr));
	      var_dump(array_map(null, $arr, $arr));
	      ?>

	      The above example will output:

	      array(1) {
		["stringkey"]=>
		array(1) {
		  [0]=>
		  string(5) "value"
		}
	      }
	      array(1) {
		[0]=>
		array(2) {
		  [0]=>
		  string(5) "value"
		  [1]=>
		  string(5) "value"
		}
	      }
	      array(1) {
		["stringkey"]=>
		string(5) "value"
	      }
	      array(1) {
		[0]=>
		array(2) {
		  [0]=>
		  string(5) "value"
		  [1]=>
		  string(5) "value"
		}
	      }

SEE ALSO

       array_filter(3), array_reduce(3), array_walk(3), information about the callback type.

PHP Documentation Group 													      ARRAY_MAP(3)