This iterator will insert values into a property of each of the records returned. The values to be inserted come out of another traversal object. This is useful when you have two separate collections and want to merge them together by placing each of the values from one collection into a property inside the other collection.
$_path
protected array
An array containing each of the properties to be traversed to reach the point where the values should be inserted.
$_target
protected string
$_validValues
protected boolean
$_values
protected Constructs a new collection that will dynamically add properties to it out of the values found in $values.
Returns the current element in the target collection after inserting the value from the source collection into the specified path.
__construct( array|Traversable $into , string $path , array|Traversable $values )
Constructs a new collection that will dynamically add properties to it out of the values found in $values.
$into
The target collection to which the values will be inserted at the specified path.
$path
A dot separated list of properties that need to be traversed to insert the value into the target collection.
$values
The source collection from which the values will be inserted at the specified path.
Cake\Collection\Collection::__construct()
current( )
Returns the current element in the target collection after inserting the value from the source collection into the specified path.
IteratorIterator::current()
next( )
Advances the cursor to the next record
IteratorIterator::next()
__debugInfo( )
Returns an array that can be used to describe the internal state of this object.
count( )
Returns the amount of elements in the collection.
Cake\Collection\CollectionInterface::count()
countKeys( )
Returns the number of unique keys in this iterator. This is, the number of elements the collection will contain after calling toArray()
Cake\Collection\CollectionInterface::countKeys()
serialize( )
Returns a string representation of this object that can be used to reconstruct it
Serializable::serialize()
unserialize( string $collection )
Unserializes the passed string and rebuilds the Collection instance
$collection
Serializable::unserialize()
_unwrap( )
append( $items )
appendItem( $item , $key = null )
avg( $matcher = null )
cartesianProduct( callable $operation = null , callable $filter = null )
$operation
optional null $filter
optional null Cake\Collection\CollectionInterface
chunk( $chunkSize )
chunkWithKeys( $chunkSize , $preserveKeys = true )
combine( $keyPath , $valuePath , $groupPath = null )
compile( $preserveKeys = true )
contains( $value )
countBy( $callback )
each( callable $c )
every( callable $c )
extract( $matcher )
first( )
firstMatch( array $conditions )
groupBy( $callback )
indexBy( $callback )
isEmpty( )
jsonSerialize( )
last( )
lazy( )
listNested( $dir = 'desc' , $nestingKey = 'children' )
Cake\Collection\Iterator\TreeIterator
match( array $conditions )
max( $callback , $type = \SORT_NUMERIC )
median( $matcher = null )
min( $callback , $type = \SORT_NUMERIC )
nest( $idPath , $parentPath , $nestingKey = 'children' )
newCollection( ... $args )
Returns a new collection.
Allows classes which use this trait to determine their own type of returned collection interface
$args
Cake\Collection\CollectionInterface
optimizeUnwrap( )
Unwraps this iterator and returns the simplest traversable that can be used for getting the data out
prepend( $items )
prependItem( $item , $key = null )
reduce( callable $c , $zero = null )
sample( $size = 10 )
shuffle( )
skip( $howMany )
some( callable $c )
sortBy( $callback , $dir = \SORT_DESC , $type = \SORT_NUMERIC )
sumOf( $matcher = null )
take( $size = 1 , $from = 0 )
takeLast( $howMany )
through( callable $handler )
toArray( $preserveKeys = true )
toList( )
transpose( )
Cake\Collection\CollectionInterface
unfold( callable $transformer = null )
unwrap( )
zip( $items )
zipWith( $items , $callable )
cartesianProduct() |
protected array
An array containing each of the properties to be traversed to reach the point where the values should be inserted.
protected boolean
Holds whether the values collection is still valid. (has more records)
true
protected Cake\Collection\Collection
The collection from which to extract the values to be inserted
© 2005–present The Cake Software Foundation, Inc.
Licensed under the MIT License.
CakePHP is a registered trademark of Cake Software Foundation, Inc.
We are not endorsed by or affiliated with CakePHP.
https://api.cakephp.org/3.8/class-Cake.Collection.Iterator.InsertIterator.html