Функсияи array_splice

Функсияи array_splice як қисми массивро мебурад ва бармегардонад. Дар ин ҳол, қисми буридашуда аз массив нест мешавад. Ба ҷои қисми буридашуда метавон элементҳои нав гузошт.

Ҳамчун параметри аввал массиве, ки бояд бурида шавад, муайян карда мешавад. Ҳамчун параметри дуюм муайян карда мешавад, ки аз кадом элемент буриданро оғоз кунем, ҳамчун параметри сеюм - чанд элемент бурида шавад. Параметри сеюм метавонад манфӣ бошад - дар ин ҳол ҳисоб аз охир оғоз мешавад (-1 - элементҳои охирин, -2 - пеш аз он ва ғайра). Параметри сеюм умуман муайян карда намешавад - дар ин ҳол массив то ба охир бурида мешавад.

Дар параметри ихтиёрӣи охирин метавон массиви элементҳоро муқаррар кард, ки ба ҷои элементҳои нестшуда гузошта мешаванд.

Синтаксис

array_splice(array &$array, int $offset, ?int $length = null, mixed $replacement = []): array

Намуна

Биёед элементҳоро аз аввал (рақами 0 дорад), 3 адад бурем:

<?php
	$arr = ['a', 'b', 'c', 'd', 'e'];
	
	$res = array_splice($arr, 0, 3);
	var_dump($res);
?>

Натиҷаи иҷрои код:

['a', 'b', 'c']

Дар ин ҳол массиви $arr ин тавр намоиш дода мешавад:

['d', 'e']

Намуна

Биёед элементҳоро аз дуюм (рақами 1 дорад), 3 адад бурем:

<?php
	$arr = ['a', 'b', 'c', 'd', 'e'];
	
	$res = array_splice($arr, 1, 3);
	var_dump($res);
?>

Натиҷаи иҷрои код:

['b', 'c', 'd']

Дар ин ҳол массиви $arr ин тавр намоиш дода мешавад:

['a', 'e']

Намуна

Биёед элементҳоро аз дуюм (рақами 1 дорад) то охири массив бурем. Барои ин параметри сеюм наменвисем:

<?php
	$arr = ['a', 'b', 'c', 'd', 'e'];
	
	$res = array_splice($arr, 1);
	var_dump($res);
?>

Натиҷаи иҷрои код:

['b', 'c', 'd', 'e']

Дар ин ҳол массиви $arr ин тавр намоиш дода мешавад:

['a']

Намуна

Биёед элементҳоро аз пеши охирин, 2 адад бурем. Барои ин параметри дуюм ба -2 муқаррар мекунем (мавқеи элементҳои пеши охирин):

<?php
	$arr = ['a', 'b', 'c', 'd', 'e'];
	
	$res = array_splice($arr, -2, 2);
	var_dump($res);
?>

Натиҷаи иҷрои код:

['d', 'e']

Дар ин ҳол массиви $arr ин тавр намоиш дода мешавад:

['a', 'b', 'c']

Намуна

Биёед элементҳоро аз дуюм (рақами 1 дорад), 2 адад бурем, ва ба ҷои он элементҳои 1, 2, 3-ро гузем:

<?php
	$arr = ['a', 'b', 'c', 'd', 'e'];
	
	$res = array_splice($arr, 1, 2, [1, 2, 3]);
	var_dump($res);
?>

Натиҷаи иҷрои код:

['b', 'c']

Дар ин ҳол массиви $arr ин тавр намоиш дода мешавад:

['a', 1, 2, 3, 'd', 'e']

Намуна

Биёед умуман ҳеҷ чиз набурем, ва танҳо элементҳои 1, 2, 3-ро аз мавқеи 1 гузем. Барои ин параметри сеюм ба сифр муқаррар карда мешавад:

<?php
	$arr = ['a', 'b', 'c', 'd', 'e'];
	
	$res = array_splice($arr, 1, 0, [1, 2, 3]);
	var_dump($res);
?>

Натиҷаи иҷрои код:

[]

Дар ин ҳол массиви $arr ин тавр намоиш дода мешавад:

['a', 1, 2, 3, 'b', 'c', 'd', 'e']

Инчунин бубинед

функсияи array_slice,
ки як қисми массивро мебурад, вале худи массивро дигаргун намекунад