php man page for array_pad

ARRAY_PAD(3)								 1							      ARRAY_PAD(3)

array_pad - Pad array to the specified length with a value

SYNOPSIS
       array array_pad (array  $array, int  $size, mixed  $value)

DESCRIPTION
       array_pad(3)  returns  a  copy  of  the	$array padded to size specified by $size with value $value. If $size is positive then the array is
       padded on the right, if it's negative then on the left. If the absolute value of $size is less than or equal to the length  of  the  $array
       then no padding takes place. It is possible to add at most 1048576 elements at a time.

PARAMETERS
	      o $array
		- Initial array of values to pad.

	      o $size
		- New size of the array.

	      o $value
		- Value to pad if $array is less than $size.

RETURN VALUES
	Returns  a  copy  of  the $array padded to size specified by $size with value $value. If $size is positive then the array is padded on the
       right, if it's negative then on the left. If the absolute value of $size is less than or equal to the length of the $array then no  padding
       takes place.

EXAMPLES
       Example #1

	      array_pad(3) example

	      <?php
	      $input = array(12, 10, 9);

	      $result = array_pad($input, 5, 0);
	      // result is array(12, 10, 9, 0, 0)

	      $result = array_pad($input, -7, -1);
	      // result is array(-1, -1, -1, -1, 12, 10, 9)

	      $result = array_pad($input, 2, "noop");
	      // not padded
	      ?>

SEE ALSO
       array_fill(3), range(3).

PHP Documentation Group 													      ARRAY_PAD(3)