Класс ExtractIterator
Создает итератор из другого итератора, извлекая запрашиваемый столбец или свойство на основе пути.
- IteratorIterator реализует Iterator, Traversable, OuterIterator
-
Cake\Collection\Collection реализует Cake\Collection\CollectionInterface, Serializable использует Cake\Collection\CollectionTrait
-
Cake\Collection\Iterator\ExtractIterator
Краткое описание свойств
-
$_extractorprotectedcallableДелегат, ответственный за извлечение одного значения для каждого элемента в коллекции.
Краткое описание методов
- __construct() public
Создает итератор, который будет возвращать запрашиваемое свойство для каждого значения в коллекции, выраженного в $path.
- current() public
Возвращает значение столбца, определенного в $path, или null, если путь не может быть пройден.
- unwrap() public
Подробное описание методов
__construct()source public
__construct( array|Traversable $items , string $path )
Создает итератор, который будет возвращать запрашиваемое свойство для каждого значения в коллекции, выраженного в $path.
Пример:
Извлечь имя пользователя для всех комментариев в массиве:
$items = [ ['comment' => ['body' => 'cool', 'user' => ['name' => 'Mark']], ['comment' => ['body' => 'very cool', 'user' => ['name' => 'Renan']] ]; $extractor = new ExtractIterator($items, 'comment.user.name'');
Параметры
- array|Traversable
$items - Список значений для итерирования
- string
$path Строка с разделителями «.» , обозначающая путь для перехода в иерархии каждого значения для извлечения столбца.
Исключения
InvalidArgumentExceptionЕсли передан неверный тип для элементов.
Переопределяет
Cake\Collection\Collection::__construct() current()source public
current( )
Возвращает значение столбца, определенного в $path, или null, если путь не может быть пройден.
Возвращаемое значение
mixedПереопределяет
IteratorIterator::current() unwrap()source public
unwrap( )
Здесь мы выполняем некоторый анализ строгости, чтобы полностью обойти логику итератора.
Возвращаемое значение
IteratorПереопределяет
Cake\Collection\CollectionTrait::unwrap() Наследуемые методы из Cake\Collection\Collection
__debugInfo()source public
__debugInfo( )
Возвращает массив, который можно использовать для описания внутреннего состояния этого объекта.
Возвращаемое значение
arraycount()source public
count( )
Возвращает количество элементов в коллекции.
Возвращаемое значение
integerРеализация
Cake\Collection\CollectionInterface::count() countKeys()source public
countKeys( )
Возвращает количество уникальных ключей в этом итераторе. Это количество элементов, которые будут содержаться в коллекции после вызова toArray()
Возвращаемое значение
integerРеализация
Cake\Collection\CollectionInterface::countKeys() serialize()source public
serialize( )
Возвращает строковое представление этого объекта, которое можно использовать для его восстановления.
Возвращаемое значение
stringРеализация
Serializable::serialize() unserialize()source public
unserialize( string $collection )
Десериализует переданную строку и восстанавливает экземпляр Collection.
Параметры
- string
$collection - Десериализованная коллекция
Реализация
Serializable::unserialize() Используемые методы из Cake\Collection\CollectionTrait
_unwrap()source public
_unwrap( )
append()source public
append( $items )
appendItem()source public
appendItem( $item , $key = null )
avg()source public
avg( $matcher = null )
cartesianProduct()source public
cartesianProduct( callable $operation = null , callable $filter = null )
Возвращаемое значение
Cake\Collection\CollectionInterfacechunk()source public
chunk( $chunkSize )
chunkWithKeys()source public
chunkWithKeys( $chunkSize , $preserveKeys = true )
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 )
filter()source public
filter( callable $c = null )
Возвращает
Cake\Collection\Iterator\FilterIteratorfirst()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' )
Возвращает
Cake\Collection\Iterator\TreeIteratormatch()source public
match( array $conditions )
max()source public
max( $callback , $type = \SORT_NUMERIC )
median()source public
median( $matcher = null )
min()source public
min( $callback , $type = \SORT_NUMERIC )
nest()source public
nest( $idPath , $parentPath , $nestingKey = 'children' )
optimizeUnwrap()source protected
optimizeUnwrap( )
Распаковывает этот итератор и возвращает самый простой перебираемый объект, который можно использовать для извлечения данных.
Возвращает
Traversable|arrayprepend()source public
prepend( $items )
prependItem()source public
prependItem( $item , $key = null )
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 )
stopWhen()source public
stopWhen( $condition )
Возвращает
Cake\Collection\Iterator\StoppableIteratorsumOf()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 )
zip()source public
zip( $items )
zipWith()source public
zipWith( $items , $callable )
Подробное описание свойств
$_extractorsource
protected callable
Функция, ответственная за извлечение одного значения для каждого элемента в коллекции.
© 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.6/class-Cake.Collection.Iterator.ExtractIterator.html