array_slice(3) [php man page]
ARRAY_SLICE(3) 1 ARRAY_SLICE(3) array_slice - Extract a slice of the array SYNOPSIS
array array_slice NULL (array $array, int $offset, [int $length], [bool $preserve_keys = false]) DESCRIPTION
array_slice(3) returns the sequence of elements from the array $array as specified by the $offset and $length parameters. PARAMETERS
o $array - The input array. o $offset - If $offset is non-negative, the sequence will start at that offset in the $array. If $offset is negative, the sequence will start that far from the end of the $array. o $length - If $length is given and is positive, then the sequence will have up to that many elements in it. If the array is shorter than the $length, then only the available array elements will be present. If $length is given and is negative then the sequence will stop that many elements from the end of the array. If it is omitted, then the sequence will have everything from $offset up until the end of the $array. o $preserve_keys - Note that array_slice(3) will reorder and reset the numeric array indices by default. You can change this behaviour by setting $preserve_keys to TRUE. RETURN VALUES
Returns the slice. CHANGELOG
+--------+---------------------------------------------------+ |Version | | | | | | | Description | | | | +--------+---------------------------------------------------+ | 5.2.4 | | | | | | | The default value of the $length parameter was | | | changed to NULL. A NULL$length now tells the | | | function to use the length of $array. Prior to | | | this version, a NULL$length was taken to mean a | | | zero length (nothing will be returned). | | | | | 5.0.2 | | | | | | | The optional $preserve_keys parameter was added. | | | | +--------+---------------------------------------------------+ EXAMPLES
Example #1 array_slice(3) examples <?php $input = array("a", "b", "c", "d", "e"); $output = array_slice($input, 2); // returns "c", "d", and "e" $output = array_slice($input, -2, 1); // returns "d" $output = array_slice($input, 0, 3); // returns "a", "b", and "c" // note the differences in the array keys print_r(array_slice($input, 2, -1)); print_r(array_slice($input, 2, -1, true)); ?> The above example will output: Array ( [0] => c [1] => d ) Array ( [2] => c [3] => d ) SEE ALSO
array_splice(3), unset(3), array_chunk(3). PHP Documentation Group ARRAY_SLICE(3)
Check Out this Related Man Page
SUBSTR_REPLACE(3) 1 SUBSTR_REPLACE(3) substr_replace - Replace text within a portion of a string SYNOPSIS
mixed substr_replace (mixed $string, mixed $replacement, mixed $start, [mixed $length]) DESCRIPTION
substr_replace(3) replaces a copy of $string delimited by the $start and (optionally) $length parameters with the string given in $replace- ment. PARAMETERS
o $string - The input string. An array of strings can be provided, in which case the replacements will occur on each string in turn. In this case, the $replacement, $start and $length parameters may be provided either as scalar values to be applied to each input string in turn, or as arrays, in which case the corresponding array element will be used for each input string. o $replacement - The replacement string. o $start - If $start is positive, the replacing will begin at the $start'th offset into $string. If $start is negative, the replacing will begin at the $start'th character from the end of $string. o $length - If given and is positive, it represents the length of the portion of $string which is to be replaced. If it is negative, it rep- resents the number of characters from the end of $string at which to stop replacing. If it is not given, then it will default to strlen( $string ); i.e. end the replacing at the end of $string. Of course, if $length is zero then this function will have the effect of inserting $replacement into $string at the given $start offset. RETURN VALUES
The result string is returned. If $string is an array then array is returned. EXAMPLES
Example #1 Simple substr_replace(3) examples <?php $var = 'ABCDEFGH:/MNRPQR/'; echo "Original: $var<hr /> "; /* These two examples replace all of $var with 'bob'. */ echo substr_replace($var, 'bob', 0) . "<br /> "; echo substr_replace($var, 'bob', 0, strlen($var)) . "<br /> "; /* Insert 'bob' right at the beginning of $var. */ echo substr_replace($var, 'bob', 0, 0) . "<br /> "; /* These next two replace 'MNRPQR' in $var with 'bob'. */ echo substr_replace($var, 'bob', 10, -1) . "<br /> "; echo substr_replace($var, 'bob', -7, -1) . "<br /> "; /* Delete 'MNRPQR' from $var. */ echo substr_replace($var, '', 10, -1) . "<br /> "; ?> Example #2 Using substr_replace(3) to replace multiple strings at once <?php $input = array('A: XXX', 'B: XXX', 'C: XXX'); // A simple case: replace XXX in each string with YYY. echo implode('; ', substr_replace($input, 'YYY', 3, 3))." "; // A more complicated case where each replacement is different. $replace = array('AAA', 'BBB', 'CCC'); echo implode('; ', substr_replace($input, $replace, 3, 3))." "; // Replace a different number of characters each time. $length = array(1, 2, 3); echo implode('; ', substr_replace($input, $replace, 3, $length))." "; ?> The above example will output: A: YYY; B: YYY; C: YYY A: AAA; B: BBB; C: CCC A: AAAXX; B: BBBX; C: CCC NOTES
Note This function is binary-safe. SEE ALSO
str_replace(3), substr(3), String access and modification by character. PHP Documentation Group SUBSTR_REPLACE(3)