On this page
Class NestIterator
A type of collection that is aware of nested items and exposes methods to check or retrieve them
- IteratorIterator implements Iterator, Traversable, OuterIterator
 
 Cake\Collection\Collection implements Cake\Collection\CollectionInterface, Serializable uses Cake\Collection\CollectionTrait
   
 Cake\Collection\Iterator\NestIterator implements RecursiveIterator
   
Properties summary
- 
    
$_nestKeyprotectedThe name of the property that contains the nested items for each elementstring|callable 
Method Summary
- 
    __construct() publicConstructor
 - 
    getChildren() publicReturns a traversable containing the children for the current item
 - 
    hasChildren() public
Returns true if there is an array or a traversable object stored under the configured nestKey for the current item
 
Method Detail
__construct()source public
__construct( array|Traversable $items , string|callable $nestKey )
   Constructor
Parameters
- 
     array|Traversable 
$items - Collection items.
 - 
     string|callable 
$nestKey - 
     
the property that contains the nested items If a callable is passed, it should return the childrens for the passed item
 
Throws
InvalidArgumentExceptionIf passed incorrect type for items.
Overrides
Cake\Collection\Collection::__construct()
  getChildren()source public
getChildren( )
   Returns a traversable containing the children for the current item
Returns
TraversableImplementation of
RecursiveIterator::getChildren()
  hasChildren()source public
hasChildren( )
   Returns true if there is an array or a traversable object stored under the configured nestKey for the current item
Returns
booleanImplementation of
RecursiveIterator::hasChildren()
  Methods inherited from Cake\Collection\Collection
__debugInfo()source public
__debugInfo( )
   Returns an array that can be used to describe the internal state of this object.
Returns
arraycount()source public
count( )
   Throws an exception.
Issuing a count on a Collection can have many side effects, some making the Collection unusable after the count operation.
Throws
LogicExceptionserialize()source public
serialize( )
   Returns a string representation of this object that can be used to reconstruct it
Returns
stringImplementation of
Serializable::serialize()
  unserialize()source public
unserialize( string $collection )
   Unserializes the passed string and rebuilds the Collection instance
Parameters
- 
     string 
$collection - The serialized collection
 
Implementation of
Serializable::unserialize()
  Methods used from Cake\Collection\CollectionTrait
_unwrap()source public
_unwrap( )
   Backwards compatible wrapper for unwrap()
Deprecated
Returns
Iteratorappend()source public
append( $items )
  cartesianProduct()source public
cartesianProduct( callable $operation null , callable $filter null )
   Returns
Cake\Collection\CollectionInterfacechunk()source public
chunk( $chunkSize )
  combine()source public
combine( $keyPath , $valuePath , $groupPath null )
  compile()source public
compile( $preserveKeys true )
  contains()source public
contains( $value )
  countBy()source public
countBy( $callback )
  each()source public
each( callable $c )
  every()source public
every( callable $c )
  extract()source public
extract( $matcher )
  first()source public
first( )
  firstMatch()source public
firstMatch( array $conditions )
  groupBy()source public
groupBy( $callback )
  indexBy()source public
indexBy( $callback )
  isEmpty()source public
isEmpty( )
  jsonSerialize()source public
jsonSerialize( )
  last()source public
last( )
  listNested()source public
listNested( $dir 'desc' , $nestingKey 'children' )
   Returns
Cake\Collection\Iterator\TreeIteratormatch()source public
match( array $conditions )
  max()source public
max( $callback , $type SORT_NUMERIC )
  min()source public
min( $callback , $type SORT_NUMERIC )
  nest()source public
nest( $idPath , $parentPath , $nestingKey 'children' )
  reduce()source public
reduce( callable $c , $zero null )
  sample()source public
sample( $size 10 )
  shuffle()source public
shuffle( )
  skip()source public
skip( $howMany )
  some()source public
some( callable $c )
  sortBy()source public
sortBy( $callback , $dir SORT_DESC , $type SORT_NUMERIC )
  sumOf()source public
sumOf( $matcher null )
  take()source public
take( $size 1 , $from 0 )
  through()source public
through( callable $handler )
  toArray()source public
toArray( $preserveKeys true )
  toList()source public
toList( )
  unfold()source public
unfold( callable $transformer null )
  unwrap()source public
unwrap( )
  zip()source public
zip( $items )
  zipWith()source public
zipWith( $items , $callable )
  Properties detail
$_nestKeysource
protected string|callable
The name of the property that contains the nested items for each element
© 2005–2017 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.3/class-Cake.Collection.Iterator.NestIterator.html