__construct(FormInterface $form, array $errors)

Creates a new iterator.

Parameters

FormInterface	$form	The erroneous form
array	$errors	The form errors

Exceptions

InvalidArgumentException

If the errors are invalid

string __toString()

Returns all iterated error messages as string.

Return Value

string

The iterated error messages

FormInterface getForm()

Returns the iterated form.

Return Value

FormInterface

The form whose errors are iterated by this object

FormError|FormErrorIterator current()

Returns the current element of the iterator.

Return Value

FormError|FormErrorIterator

an error or an iterator containing nested errors

next()

Advances the iterator to the next position.

int key()

Returns the current position of the iterator.

Return Value

int	The 0-indexed position

bool valid()

Returns whether the iterator's position is valid.

Return Value

bool	Whether the iterator is valid

rewind()

Sets the iterator's position to the beginning.

This method detects if errors have been added to the form since the construction of the iterator.

bool offsetExists(int $position)

Returns whether a position exists in the iterator.

Parameters

int

$position

The position

Return Value

bool	Whether that position exists

FormError|FormErrorIterator offsetGet(int $position)

Returns the element at a position in the iterator.

Parameters

int

$position

The position

Return Value

FormError|FormErrorIterator

The element at the given position

Exceptions

OutOfBoundsException

If the given position does not exist

offsetSet($position, $value)

Unsupported method.

Parameters

	$position
	$value

Exceptions

BadMethodCallException

offsetUnset($position)

Unsupported method.

Parameters

$position

Exceptions

BadMethodCallException

bool hasChildren()

Returns whether the current element of the iterator can be recursed into.

Return Value

bool	Whether the current element is an instance of this class

getChildren()

Alias of {@link current()}.

int count()

Returns the number of elements in the iterator.

Note that this is not the total number of errors, if the constructor parameter $deep was set to true! In that case, you should wrap the iterator into a {@link \RecursiveIteratorIterator} with the standard mode {@link \RecursiveIteratorIterator::LEAVES_ONLY} and count the result.

$iterator = new \RecursiveIteratorIterator($form->getErrors(true));
$count = count(iterator_to_array($iterator));

Alternatively, set the constructor argument $flatten to true as well.

$count = count($form->getErrors(true, true));

Return Value

int	The number of iterated elements

seek(int $position)

Sets the position of the iterator.

Parameters

int

$position

The new position

Exceptions

OutOfBoundsException

If the position is invalid

FormErrorIterator findByCodes(string|string[] $codes)

Creates iterator for errors with specific codes.

Parameters

string|string[]

$codes

The codes to find

Return Value

FormErrorIterator

new instance which contains only specific errors