each(3) [php man page]

EACH(3) 								 1								   EACH(3)

each - Return the current key and value pair from an array and advance the array cursor

SYNOPSIS

       array each (array  &$array)

DESCRIPTION

	Return the current key and value pair from an array and advance the array cursor.

	After each(3) has executed, the array cursor will be left on the next element of the array, or past the last element if it hits the end of
       the array. You have to use reset(3) if you want to traverse the array again using each.

PARAMETERS

	      o $array
		- The input array.

RETURN VALUES

	Returns the current key and value pair from the array $array. This pair is returned in a four-element array, with the keys 0, 1, key,  and
       value. Elements 0 and key contain the key name of the array element, and 1 and value contain the data.

	If the internal pointer for the array points past the end of the array contents, each(3) returns FALSE.

EXAMPLES

       Example #1

	      each(3) examples

	      <?php
	      $foo = array("bob", "fred", "jussi", "jouni", "egon", "marliese");
	      $bar = each($foo);
	      print_r($bar);
	      ?>

	      $bar now contains the following key/value pairs:

	      Array
	      (
		  [1] => bob
		  [value] => bob
		  [0] => 0
		  [key] => 0
	      )

       <?php
       $foo = array("Robert" => "Bob", "Seppo" => "Sepi");
       $bar = each($foo);
       print_r($bar);
       ?>

       $bar now contains the following key/value pairs:

       Array
       (
	   [1] => Bob
	   [value] => Bob
	   [0] => Robert
	   [key] => Robert
       )

       each(3) is typically used in conjunction with list(3) to traverse an array, here's an example:

       Example #2

	      Traversing an array with each(3)

	      <?php
	      $fruit = array('a' => 'apple', 'b' => 'banana', 'c' => 'cranberry');

	      reset($fruit);
	      while (list($key, $val) = each($fruit)) {
		  echo "$key => $val
";
	      }
	      ?>

	      The above example will output:

	      a => apple
	      b => banana
	      c => cranberry

       Caution

	       Because	assigning  an array to another variable resets the original array's pointer, our example above would cause an endless loop
	      had we assigned $fruit to another variable inside the loop.

       Warning

	      each(3) will also accept objects, but may return unexpected results. It's therefore not recommended to iterate though object proper-
	      ties with each(3).

SEE ALSO

       key(3), list(3), current(3), reset(3), next(3), prev(3), foreach, Object Iteration.

PHP Documentation Group 														   EACH(3)

Check Out this Related Man Page

ARRAY_INTERSECT_ASSOC(3)						 1						  ARRAY_INTERSECT_ASSOC(3)

array_intersect_assoc - Computes the intersection of arrays with additional index check

SYNOPSIS

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

DESCRIPTION

       array_intersect_assoc(3)  returns  an  array containing all the values of $array1 that are present in all the arguments. Note that the keys
       are used in the comparison unlike in array_intersect(3).

PARAMETERS

	      o $array1
		- The array with master values to check.

	      o $array2
		- An array to compare values against.

	      o $...
		- A variable list of arrays to compare.

RETURN VALUES

	Returns an associative array containing all the values in $array1 that are present in all of the arguments.

EXAMPLES

       Example #1

	      array_intersect_assoc(3) example

	      <?php
	      $array1 = array("a" => "green", "b" => "brown", "c" => "blue", "red");
	      $array2 = array("a" => "green", "b" => "yellow", "blue", "red");
	      $result_array = array_intersect_assoc($array1, $array2);
	      print_r($result_array);
	      ?>

	      The above example will output:

	      Array
	      (
		  [a] => green
	      )

	In our example you see that only the pair "a" => "green" is present in both arrays and thus is returned. The value "red" is  not  returned
       because in $array1 its key is 0 while the key of "red" in $array2 is 1, and the key "b" is not returned because its values are different in
       each array.

	The two values from the key => value pairs are considered equal only if (string) $elem1 === (string) $elem2 . In other words a strict type
       check is executed so the string representation must be the same.

SEE ALSO 
array_intersect(3), array_uintersect_assoc(3), array_intersect_uassoc(3), array_uintersect_uassoc(3), array_diff(3), array_diff_assoc(3).

PHP Documentation Group 												  ARRAY_INTERSECT_ASSOC(3)

Linux and UNIX Man Pages

each(3) [php man page]

Check Out this Related Man Page