Метод add класса ArrayCollection

Метод add класса ArrayCollection добавляет переданный элемент в конец коллекции. Первым параметром передаётся значение, которое нужно добавить. Метод возвращает саму коллекцию, что позволяет выстраивать цепочку вызовов.

Синтаксис

$collection->add($element);

Пример

Давайте создадим коллекцию и добавим в неё несколько элементов:

<?php
	use DoctrineCommonCollectionsArrayCollection;

	$collection = new ArrayCollection();
	$collection->add('abcde');
	$collection->add('article');
	$collection->add('user');

	$res = $collection->toArray();
	print_r($res);
?>

Результат выполнения кода:

["abcde", "article", "user"]

Пример

Метод add возвращает коллекцию, поэтому вызовы можно объединять в цепочку:

<?php
	use DoctrineCommonCollectionsArrayCollection;

	$collection = new ArrayCollection();
	$collection
		->add('hello')
		->add('article')
		->add('abcde');

	$res = $collection->toArray();
	print_r($res);
?>

Результат выполнения кода:

["hello", "article", "abcde"]

Пример

Давайте добавим в коллекцию элементы с числовыми значениями:

<?php
	use DoctrineCommonCollectionsArrayCollection;

	$collection = new ArrayCollection();
	$collection->add(1);
	$collection->add(2);
	$collection->add(3);

	$res = $collection->toArray();
	print_r($res);
?>

Результат выполнения кода:

[1, 2, 3]

Пример

Давайте создадим пустую коллекцию и проверим, что метод add её наполняет:

<?php
	use DoctrineCommonCollectionsArrayCollection;

	$collection = new ArrayCollection();
	$res = $collection->isEmpty();
	var_dump($res);

	$collection->add('abcde');
	$res = $collection->isEmpty();
	var_dump($res);
?>

Результат выполнения кода:

true
false

Смотрите также

класс ArrayCollection,
который представляет собой коллекцию элементов
метод removeElement,
который удаляет элемент из коллекции
метод contains,
который проверяет наличие элемента в коллекции
метод toArray,
который преобразует коллекцию в массив