Правильное чтение документации на PHP

[kilogram]

array array_slice ( array $array , int $offset [, int $length = NULL [, bool $preserve_keys = false ]] )

Как читать правильно эту строку в документации PHP? Первый параметр означает, что переменная должна передаваться как массив, а вот второй параметр загадочно как-то, расшифруйте.

[Kolyaj]

Целое число.

[kilogram]

Как читать в документации второй параметр? Там несколько вложенных квадратных скобок, они сбивают с толку.

[kilogram]

То есть при вызове функции array_slice я могу передать этой функции 4 параметра, но обязательно их должно быть как минимум 2?

array_slice ( $array ,2,3, true);

[Kolyaj]

В квадратных скобках пишутся необязательные параметры, да.

[kilogram]

А так чтоб сохранялись ключи при замене существующего массива не получиться?

$input = array("color1"=>"red","color2"=> "green","color3"=>"blue","color4"=>"yellow");
array_splice($input,1,count($input),"orange");
echo '<pre>'.print_r($input,1).'</pre>';

Результат:

Array
(
    [color1] => red
    [0] => orange
)

Как сделать чтоб не нумировался ключ с нуля, а подставлялось ассоциативное имя ключа?

[kilogram]

Вот так тоже переименовывает ключи в числа.

$mas = array("Имя1"=>"orange","Имя2"=>"magenta");
$input = array("color1"=>"red","color2"=> "green","color3"=>"blue","color4"=>"yellow");
array_splice($input,1,2,$mas);
echo '<pre>'.print_r($input,1).'</pre>';

Array
(
[color1] => red
[0] => orange
[1] => magenta
[color4] => yellow
)

[kilogram]

Ещё небольшое уточнение. Почему если заменить это:

array_splice($input,1,2,$mas);
echo '<pre>'.print_r($input,1).'</pre>';

на это

$d = array_splice($input,-2,2,$mas);
echo '<pre>'.print_r($d,1).'</pre>';

Почему обрезания значений элементов не произойдет, а выведет просто последние 2 элемента массива без изменений?

[kilogram]

Значения последних 2-ух элементов массива $input не меняются почему то