array_splice

(PHP 4 >= 4.0.0)

array_splice -- Odstranit Φßst pole a nahradit ji n∞Φφm jin²m

Popis

array array_splice ( array input, int offset [, int length [, array replacement]])

array_splice() odstra≥uje prvky pole input urΦenΘ argumenty offset a length, a p°φpadn∞ je nahrazuje prvky volitelnΘho argumentu (pole) replacement.

Pokud je offset kladn², tato odstran∞nß Φßst zaΦne offset polo╛ek od zaΦßtku array. Pokud je offset zßporn², zaΦne tolik polo╛ek od konce array.

Pokud vynechßte length, array_splice() odstranφ v╣echno od offset do konce pole. Pokud je length kladnß, odstranφ se prßv∞ tolik prvk∙. Pokud je length zßpornß, konec odstran∞nΘ Φßsti bude prßv∞ tolik prvk∙ od konce pole. Tip: k odstran∞nφ v╣ech prvk∙ od offset do konce pole p°i souΦasn∞ urΦenΘm argumentu replacement pou╛ijte jako length count($input).

Pokud zadßte replacement pole, odstran∞nΘ prvky se nahradφ prvky tohoto pole. Pokud argumenty offset a length definovßny tak, ╛e se nic neodstranφ, prvky pole replacement se vlo╛φ na mφsto urΦenΘ argumentem offset. Tip: pokud je replacement jen jedna hodnota, nenφ nutno ji umis╗ovat do array(), leda╛e chcete, aby tato polo╛ka byla opravdu pole.

Nßsledujφcφ volßnφ jsou ekvivalentnφ:
array_push ($input, $x, $y)     array_splice ($input, count ($input), 0,
                                             array ($x, $y))
array_pop ($input)              array_splice ($input, -1)
array_shift ($input)            array_splice ($input, 0, 1)
array_unshift ($input, $x, $y)  array_splice ($input, 0, 0, array ($x, $y))
$a[$x] = $y                     array_splice ($input, $x, 1, $y)

Vracφ pole odstran∞n²ch prvk∙.

P°φklad 1. Ukßzky array_splice()

$input = array ("red", "green", "blue", "yellow");

array_splice ($input, 2);      // $input is now array ("red", "green")
array_splice ($input, 1, -1);  // $input is now array ("red", "yellow")
array_splice ($input, 1, count($input), "orange");
                               // $input is now array ("red", "orange")
array_splice ($input, -1, 1, array("black", "maroon"));
                               // $input is now array ("red", "green",
                               //          "blue", "black", "maroon")

Viz takΘ: array_slice().