Главная страница>Исходный код PHP>Другие категории
Скачать

Библиотека инструментов Zicht Iterator

Инструменты итератора, или сокращенно itertools , представляют собой набор удобных инструментов для обработки последовательностей данных, таких как массивы, итераторы и строки. Некоторые имена и API основаны на Python itertools .

Примеры

Общие операции включают в себя:

  • картографирование: map и mapBy
  • фильтрация: filter , difference
  • сортировка: sorted
  • группировка: groupBy
  • сокращение: accumulate , collapse и reduce

Использование

Чтобы использовать доступные фильтры/функции itertools через Twig, просто добавьте это определение службы в свой config/services.yaml

itertoolstwigExtension: tags: ['twig.extension']">
 Zicht itertools twigExtension :
  tags : ['twig.extension']

Скрипты

  • модульный тест: composer test
  • тест на ворс: composer lint

Пример данных

В приведенных ниже примерах будут использоваться следующие данные, чтобы проиллюстрировать, как работают различные инструменты Iterator: 

 $ words = [ ' Useful ' , ' Goonies ' , ' oven ' , ' Bland ' , ' notorious ' ];
$ numbers = [ 1 , 3 , 2 , 5 , 4 ];
$ vehicles = [
    [
        ' id ' => 1 ,
        ' type ' => ' car ' , 
        ' wheels ' => 4 , 
        ' colors ' => [ ' red ' , ' green ' , ' blue ' ], 
        ' is_cool ' => false , 
        ' price ' => 20000 ,
    ],
    [
        ' id ' => 2 ,
        ' type ' => ' bike ' , 
        ' wheels ' => 2 , 
        ' colors ' => [ ' red ' , ' green ' , ' blue ' ], 
        ' is_cool ' => false , 
        ' price ' => 600 ,
    ],
    [
        ' id ' => 5 ,
        ' type ' => ' unicicle ' , 
        ' wheels ' => 1 , 
        ' colors ' => [ ' red ' ], 
        ' is_cool ' => true , 
        ' price ' => 150 ,
    ],
    [
        ' id ' => 9 ,
        ' type ' => ' car ' , 
        ' wheels ' => 8 , 
        ' colors ' => [ ' blue ' ], 
        ' is_cool ' => true , 
        ' price ' => 100000 ,
    ],
];

Примеры

Используя приведенный выше пример данных, вы можете использовать itertools , чтобы получить все уникальные цвета автомобилей в алфавитном порядке:

itertoolsutilFilters; use function Zicht itertools iterable; $vehicles = iterable($vehicles) ->filter(Filters::equals('car', 'type')) // {[vehicle...], [vehicle...]} ->map('colors') // {0: ['red', 'green', 'blue'], 1: ['blue']} ->collapse() // {0: 'red', 1: 'green', 2: 'blue', 3: 'blue'} ->unique() // {0: 'red', 1: 'green', 2: 'blue'} ->sorted(); // {2: 'blue', 1: 'green', 0: 'red'}">
 use Zicht  itertools  util  Filters ;
use function Zicht  itertools  iterable ;

$ vehicles = iterable ( $ vehicles )
    -> filter (Filters:: equals ( ' car ' , ' type ' )) // {[vehicle...], [vehicle...]}
    -> map ( ' colors ' ) // {0: ['red', 'green', 'blue'], 1: ['blue']}
    -> collapse () // {0: 'red', 1: 'green', 2: 'blue', 3: 'blue'}
    -> unique () // {0: 'red', 1: 'green', 2: 'blue'}
    -> sorted (); // {2: 'blue', 1: 'green', 0: 'red'}

Вы можете добиться того же в Twig: 

{% for vehicle_color in vehicles
    |it. filter ( it . filters . equals ( ' car ' , ' type ' ))
    |it. map ( ' colors ' )
    |it. collapse
    |it. unique
    |it. sorted
%}
    {{ vehicle_color }}
{% endfor %}

Стратегия получения

Многим itertools можно передать параметр $strategy . Этот параметр используется для получения значения из элементов коллекции. $strategy может быть одним из трех:

  1. null, и в этом случае возвращается сам элемент. Например:

    itertoolsiterable; $result = iterable($words)->map(null); var_dump($result); // {0: 'Useful', 1: 'Goonies', 2: 'oven', 3: 'Bland', 4: 'notorious'}">
     use function Zicht  itertools  iterable ;

$ result = iterable ( $ words )-> map ( null );
var_dump ( $ result );
// {0: 'Useful', 1: 'Goonies', 2: 'oven', 3: 'Bland', 4: 'notorious'}

    Или в Twig: 

    {{ dump ( word |it. map ) }}

  2. замыкание, и в этом случае замыкание вызывается со значением элемента и ключом в качестве параметров, которые будут использоваться для вычисления возвращаемого значения. Например:

    itertoolsiterable; $getDouble = fn($value, $key) => 2 * $value; $result = iterable($numbers)->map($getDouble); var_dump($result); // {0: 2, 1: 6, 2: 4, 3: 10, 4: 8}">
     use function Zicht  itertools  iterable ;

$ getDouble = fn ( $ value , $ key ) => 2 * $ value ;
$ result = iterable ( $ numbers )-> map ( $ getDouble );
var_dump ( $ result );
// {0: 2, 1: 6, 2: 4, 3: 10, 4: 8}

    Или в Twig: 

    {{ dump ( numbers |it. map ( num => 2 * num )) }}

  3. строка, и в этом случае эта строка используется для создания замыкания, которое пытается найти общедоступные свойства, методы или индексы массива. Например:

    itertoolsiterable; $result = iterable($vehicles)->map('type'); var_dump($result); // {0: 'car', 1: 'bike', 2: 'unicicle', 3: 'car'}">
     use function Zicht  itertools  iterable ;

$ result = iterable ( $ vehicles )-> map ( ' type ' );
var_dump ( $ result );
// {0: 'car', 1: 'bike', 2: 'unicicle', 3: 'car'}

    Или в Twig: 

    {{ dump ( word |it. map ) }}

    Строка может состоять из нескольких слов, разделенных точками, что обеспечивает доступ к вложенным свойствам, методам и индексам массива.

    Если одно из слов в строке невозможно преобразовать в существующее свойство, метод или индекс массива, будет возвращено значение null . Например:

    itertoolsiterable; $result = iterable($vehicles)->map('colors.2'); var_dump($result); // {0: 'blue', 1: 'blue', 2: null, 3: null}">
     use function Zicht  itertools  iterable ;

$ result = iterable ( $ vehicles )-> map ( ' colors.2 ' );
var_dump ( $ result );
// {0: 'blue', 1: 'blue', 2: null, 3: null}

    Или в Twig: 

    {{ dump ( vehicles |it. map ( ' colors.2 ' )) }}

Свободный интерфейс

Один из способов использования инструментов Iterator — преобразовать массив, Iterator, строку и т. д. в IterableIterator . Этот класс обеспечивает удобный интерфейс для всех распространенных операций. Например:

itertoolsiterable; $result = iterable($vehicles)->filter('is_cool')->mapBy('id')->map('type'); var_dump($result); // {5: 'unicicle', 9: 'car'}">
 use function Zicht  itertools  iterable ;

$ result = iterable ( $ vehicles )-> filter ( ' is_cool ' )-> mapBy ( ' id ' )-> map ( ' type ' );
var_dump ( $ result );
// {5: 'unicicle', 9: 'car'}

Или в Twig: 

{{ dump ( vehicles |it. filter ( ' is_cool ' ).mapBy( ' id ' ).map( ' type ' )) }}

Картирование

Сопоставление преобразует одну коллекцию в другую коллекцию равной длины. Использование map позволяет манипулировать элементами, а mapBy позволяет манипулировать ключами коллекции.

Например, мы можем использовать замыкание для создания заголовка для каждого элемента в $vehicles :

itertoolsiterable; $getTitle = fn($value, $key) => sprintf('%s with %s wheels', $value['type'], $value['wheels']); $titles = iterable($vehicles)->map($getTitle); var_dump($titles); // {0: 'car with 4 wheels', ..., 3: 'car with 8 wheels'}">
 use function Zicht  itertools  iterable ;

$ getTitle = fn ( $ value , $ key ) => sprintf ( ' %s with %s wheels ' , $ value [ ' type ' ], $ value [ ' wheels ' ]);
$ titles = iterable ( $ vehicles )-> map ( $ getTitle );
var_dump ( $ titles );
// {0: 'car with 4 wheels', ..., 3: 'car with 8 wheels'}

Используя стратегию получения строк, мы можем легко получить типы для каждого элемента в $vehicles сопоставленные с идентификаторами транспортных средств. Например:

itertoolsiterable; $types = iterable($vehicles)->mapBy('id')->map('type'); var_dump($types); // {1: 'car', 2: 'bike', 5: 'unicicle', 9: 'car'}">
 use function Zicht  itertools  iterable ;

$ types = iterable ( $ vehicles )-> mapBy ( ' id ' )-> map ( ' type ' );
var_dump ( $ types );
// {1: 'car', 2: 'bike', 5: 'unicicle', 9: 'car'}

Или в Twig: 

{{ dump ( vehicles |it. mapBy ( ' id ' ).map( ' type ' )) }}

В Mappings.php доступно несколько распространенных замыканий сопоставления. Вызов этих функций возвращает замыкание, которое можно передать в map и mapBy . Например:

itertoolsutilMappings; use function Zicht itertools iterable; $lengths = iterable($words)->map(Mappings::length()); var_dump($lengths); // {0: 6, 1: 3, 2: 4, 3: 5, 4: 9}">
 use Zicht  itertools  util  Mappings ;
use function Zicht  itertools  iterable ;

$ lengths = iterable ( $ words )-> map (Mappings:: length ());
var_dump ( $ lengths );
// {0: 6, 1: 3, 2: 4, 3: 5, 4: 9}

Или в Twig: 

{{ dump ( words |it. map ( it . mappings . length )) }}

Фильтрация

Фильтрация преобразует одну коллекцию в другую, возможно более короткую. С помощью filter оценивается каждый элемент в коллекции, элементы, которые считаются empty будут отклонены, а элементы, которые не являются empty будут пропущены через фильтр.

Например, мы можем использовать замыкание, чтобы определить, является ли элемент дорогим, тогда filter будет пропускать только дорогие элементы:

itertoolsiterable; $isExpensive = fn($value, $key) => $value['price'] >= 10000; $expensiveTypes = iterable($vehicles)->filter($isExpensive)->map('type'); var_dump($expensiveTypes); // {1: 'car', 9: 'car'}">
 use function Zicht  itertools  iterable ;

$ isExpensive = fn ( $ value , $ key ) => $ value [ ' price ' ] >= 10000 ;
$ expensiveTypes = iterable ( $ vehicles )-> filter ( $ isExpensive )-> map ( ' type ' );
var_dump ( $ expensiveTypes );
// {1: 'car', 9: 'car'}

Или в Twig: 

{{ dump ( vehicles |it. filter ( vehicle => vehicle . price >= 10000 ).map( ' type ' )) }}

Используя стратегию получения строк, мы можем получить только те $vehicles , которые считаются крутыми. Например:

itertoolsiterable; $coolVehicleTypes = iterable($vehicles)->filter('is_cool')->map('type'); var_dump($coolVehicleTypes); // {5: 'unicicle', 9: 'car'}">
 use function Zicht  itertools  iterable ;

$ coolVehicleTypes = iterable ( $ vehicles )-> filter ( ' is_cool ' )-> map ( ' type ' );
var_dump ( $ coolVehicleTypes );
// {5: 'unicicle', 9: 'car'}

Или в Twig: 

{{ dump ( vehicles |it. filter ( ' is_cool ' ).map( ' type ' )) }}

В filter.php доступно несколько распространенных замыканий фильтров. Вызов этой функции возвращает замыкание, которое можно передать в filter . Например:

itertoolsutilFilters; use function Zicht itertools iterable; $movieWords = iterable($words)->filter(Filters::in(['Shining', 'My little pony', 'Goonies'])); var_dump($movieWords); // {1: 'Goonies'}">
 use Zicht  itertools  util  Filters ;
use function Zicht  itertools  iterable ;

$ movieWords = iterable ( $ words )-> filter (Filters:: in ([ ' Shining ' , ' My little pony ' , ' Goonies ' ]));
var_dump ( $ movieWords );
// {1: 'Goonies'}

Или в Twig: 

{{ dump ( words |it. filter ( it . filters . in ([ ' Shining ' , " My little pony', 'Goonies'])) }}

Сортировка

sorted преобразует одну коллекцию в другую коллекцию равного размера, но с возможным переупорядочением элементов.

Например, используя стратегию получения null значений, которая используется по умолчанию, мы будем сортировать значения элементов в порядке возрастания:

itertoolsiterable; $ordered = iterable($numbers)->sorted(); var_dump($ordered); // {0: 1, 2: 2, 1: 3, 4: 4, 3: 5}">
 use function Zicht  itertools  iterable ;

$ ordered = iterable ( $ numbers )-> sorted ();
var_dump ( $ ordered );
// {0: 1, 2: 2, 1: 3, 4: 4, 3: 5}

Или в Twig: 

{{ dump ( numbers |it. sorted }}

Алгоритм сортировки сохранит ключи и гарантированно будет стабильным. Т.е. когда элементы сортируются по одному и тому же значению, порядок сортировки гарантированно совпадает с порядком входных элементов. Это противоречит стандартным функциям сортировки PHP.

Используя стратегию получения замыкания, возвращаемое значение используется для определения порядка. Замыкание вызывается ровно один раз для каждого элемента, и полученные значения должны быть сопоставимы. Например:

itertoolsiterable; $getLower = fn($value, $key) => strtolower($value); $ordered = iterable($words)->sorted($getLower); var_dump($ordered); // {3: 'Bland', 1: 'Goonies', 2: 'oven', 0: 'Useful', 4: 'notorious'};">
 use function Zicht  itertools  iterable ;

$ getLower = fn ( $ value , $ key ) => strtolower ( $ value );
$ ordered = iterable ( $ words )-> sorted ( $ getLower );
var_dump ( $ ordered );
// {3: 'Bland', 1: 'Goonies', 2: 'oven', 0: 'Useful', 4: 'notorious'};

Mappings.php предоставляет замыкание сопоставления, которое возвращает случайное число. Это можно использовать для сортировки коллекции в случайном порядке. Например:

itertoolsutilMappings; use function Zicht itertools iterable; $randomized = iterable($words)->sorted(Mappings::random()); var_dump($randomized); // {... randomly ordere words ...}">
 use Zicht  itertools  util  Mappings ;
use function Zicht  itertools  iterable ;

$ randomized = iterable ( $ words )-> sorted (Mappings:: random ());
var_dump ( $ randomized );
// {... randomly ordere words ...}

Или в Twig: 

{{ dump ( words |it. sorted ( it . mappings . random )) }}

Группировка

groupBy преобразует одну коллекцию в одну или несколько коллекций, которые группируют элементы по определенному критерию.

Например, используя стратегию получения строк, мы можем сгруппировать все $vehicles одного типа вместе:

itertoolsiterable; $vehiclesByType = iterable($vehicles)->groupBy('type'); var_dump($vehiclesByType); // {'bike': {1: [...]}, 'car': {0: [...], 3: [...]} 'unicicle': {2: [...]}}">
 use function Zicht  itertools  iterable ;

$ vehiclesByType = iterable ( $ vehicles )-> groupBy ( ' type ' );
var_dump ( $ vehiclesByType );
// {'bike': {1: [...]}, 'car': {0: [...], 3: [...]} 'unicicle': {2: [...]}}

Или в Twig: 

{{ dump ( vehicles |it. groupBy ( ' type ' )) }}

Это не значит, что исходные ключи от транспортных средств по-прежнему являются частью результирующих групп, а элементы внутри каждой группы сохраняют порядок, который они имели во входных данных, то есть используется стабильная сортировка, предоставляемая sorted .

Сокращение

reduce преобразует коллекцию в одно значение, вызывая замыкание двух аргументов кумулятивно для элементов коллекции, слева направо.

Например, без каких-либо аргументов reduce добавит все элементы коллекции вместе:

itertoolsiterable; $sum = iterable($numbers)->reduce(); var_dump($sum); // 15">
 use function Zicht  itertools  iterable ;

$ sum = iterable ( $ numbers )-> reduce ();
var_dump ( $ sum );
// 15

Или в Twig: 

{{ dump ( numbers |it. reduce ) }}

В приведенном выше примере используемое замыкание по умолчанию выглядит следующим образом: 

 public static function add ( $ a , $ b ):  Closure
{
    return $ a + $ b ;
}

Учитывая, что $numbers состоит из элементов {1, 3, 2, 5, 4}, замыкание add вызывается четыре раза: 

 $ sum = Reductions:: add (Reductions:: add (Reductions:: add (Reductions:: add (( 1 , 3 ), 2 ), 5 ), 4 ));
var_dump ( $ sum );
// 15

В Reduction.php доступно несколько распространенных замыканий сокращения. Вызов этих функций возвращает замыкание, которое можно передать в reduction . Например:

itertoolsutilReductions; use function Zicht itertools iterable; $scentence = iterable($words)->reduce(Reductions::join(' - ')); var_dump($scentence); // 'Useful - Goonies - oven - Bland - notorious'">
 use Zicht  itertools  util  Reductions ;
use function Zicht  itertools  iterable ;

$ scentence = iterable ( $ words )-> reduce (Reductions:: join ( ' - ' ));
var_dump ( $ scentence );
// 'Useful - Goonies - oven - Bland - notorious'

Или в Twig: 

{{ dump ( words |it. reduce ( it . reductions . join ( ' - ' )) }}

Еще одно распространенное сокращение — объединение нескольких списков в один список. Мы называем этот процесс коллапсом. Этот процесс также может быть достигнут с помощью reduce и объединения в chain , однако, поскольку он используется часто, помощник collapse упрощает его использование, например:

itertoolsiterable; $flat = iterable([['one', 'two'], ['three']])->collapse(); var_dump($flat); // {0: 'one', 1: 'two', 0: 'three'}">
 use function Zicht  itertools  iterable ;

$ flat = iterable ([[ ' one ' , ' two ' ], [ ' three ' ]])-> collapse ();
var_dump ( $ flat );
// {0: 'one', 1: 'two', 0: 'three'}

Или в Twig: 

{% set data = [[ ' one ' , ' two ' ], [ ' three ' ]] %}
{{ dump ( data |it. collapse ) }}

Сопровождающий(и)

Расширять
Дополнительная информация
Связанные приложения
Рекомендуем вам
Связанные новости Все