itertools php

Itertools -PHP迭代工具为您的循环供电

受Python的启发 – 设计用于PHP。

特征

Itertools通过提供两种类型的工具来使您成为迭代超级巨星：

• 循环迭代工具
• 流迭代工具

循环迭代工具示例

 foreach (Multi:: zip ([ \' a \' , \' b \' ], [ 1 , 2 ]) as [ $ letter , $ number ]) {
    print ( $ letter . $ number );  // a1, b2
}

流迭代工具示例

 $ result = Stream:: of ([ 1 , 1 , 2 , 2 , 3 , 4 , 5 ])
    -> distinct ()                 // [1, 2, 3, 4, 5]
    -> map ( fn ( $ x ) => $ x ** 2 )      // [1, 4, 9, 16, 25]
    -> filter ( fn ( $ x ) => $ x < 10 ) // [1, 4, 9]
    -> toSum ();                   // 14

所有功能都可以在iterable收藏中工作：

• array （类型）
• Generator （类型）
• Iterator （接口）
• Traversable （接口）

读书文档以其他语言翻译：

• n

快速参考

循环迭代工具

多迭代

单个迭代

无限迭代

随机迭代

数学迭代

设置和多局迭代

排序迭代

文件迭代

转换迭代

概括

减少

流迭代工具

流源

流操作

流终端操作

摘要终端操作

还原终端操作

转换终端操作

副作用终端操作

流调试操作

设置

将库添加到您的composer.json文件中：

{
  \"require\" : {
      \"markrogoyski/itertools-php\" : \" 1.* \"
  }
}

使用作曲家安装库：

$ php composer.phar install

作曲家将在供应商文件夹中安装Itertools。然后，您可以将以下内容添加到.php文件中以使用自动加载的库。

 require_once __DIR__ . \' /vendor/autoload.php \' ;

另外，请在命令行上使用作曲家来要求并安装Itertools：

 $ php composer.phar require markrogoyski/itertools-php:1.*

最低要求

• PHP 7.4

用法

所有功能都可以在iterable收藏中工作：

• array （类型）
• Generator （类型）
• Iterator （接口）
• Traversable （接口）

多迭代

链

将多个迭代链链分为单个连续序列。

Multi::chain(iterable ...$iterables)

 use IterTools \\ Multi ;

$ prequels  = [ \' Phantom Menace \' , \' Attack of the Clones \' , \' Revenge of the Sith \' ];
$ originals = [ \' A New Hope \' , \' Empire Strikes Back \' , \' Return of the Jedi \' ];

foreach (Multi:: chain ( $ prequels , $ originals ) as $ movie ) {
    print ( $ movie );
}
// \'Phantom Menace\', \'Attack of the Clones\', \'Revenge of the Sith\', \'A New Hope\', \'Empire Strikes Back\', \'Return of the Jedi\'

拉链

同时迭代多个迭代集合。

Multi::zip(iterable ...$iterables)

 use IterTools \\ Multi ;

$ languages = [ \' PHP \' , \' Python \' , \' Java \' , \' Go \' ];
$ mascots   = [ \' elephant \' , \' snake \' , \' bean \' , \' gopher \' ];

foreach (Multi:: zip ( $ languages , $ mascots ) as [ $ language , $ mascot ]) {
    print ( \" The { $ language } language mascot is an { $ mascot } . \" );
}
// The PHP language mascot is an elephant.
// ...

ZIP可以使用多个迭代输入 – 仅限于两个。

 $ names          = [ \' Ryu \' , \' Ken \' , \' Chun Li \' , \' Guile \' ];
$ countries      = [ \' Japan \' , \' USA \' , \' China \' , \' USA \' ];
$ signatureMoves = [ \' hadouken \' , \' shoryuken \' , \' spinning bird kick \' , \' sonic boom \' ];

foreach (Multi:: zip ( $ names , $ countries , $ signatureMoves ) as [ $ name , $ country , $ signatureMove ]) {
    $ streetFighter = new StreetFighter ( $ name , $ country , $ signatureMove );
}

注意：对于不均匀的长度，当最短的峰值耗尽时，迭代会停止。

Zipequal

同时迭代多个具有相等长度的迭代集合。

如果长度不相等，则投掷\\LengthException ，这意味着至少一个迭代器在另一个迭代器之前结束。

Multi::zipEqual(iterable ...$iterables)

 use IterTools \\ Multi ;

$ letters = [ \' A \' , \' B \' , \' C \' ];
$ numbers = [ 1 , 2 , 3 ];

foreach (Multi:: zipEqual ( $ letters , $ numbers ) as [ $ letter , $ number ]) {
    // [\'A\', 1], [\'B\', 2], [\'C\', 3]
}

拉链

如果长度不相等，则同时使用默认填充值同时迭代多个迭代集合。

Multi::zipFilled(mixed $filler, iterable ...$iterables)

 use IterTools \\ Multi ;

$ default = \' ? \' ;
$ letters = [ \' A \' , \' B \' ];
$ numbers = [ 1 , 2 , 3 ];

foreach (Multi:: zipFilled ( $ default , $ letters , $ numbers ) as [ $ letter , $ number ]) {
    // [\'A\', 1], [\'B\', 2], [\'?\', 3]
}

ziplongest

同时迭代多个迭代集合。

Multi::zipLongest(iterable ...$iterables)

对于不均匀的长度，疲惫的迭代将产生null的迭代效果。

 use IterTools \\ Multi ;

$ letters = [ \' A \' , \' B \' , \' C \' ];
$ numbers = [ 1 , 2 ];

foreach (Multi:: zipLongest ( $ letters , $ numbers ) as [ $ letter , $ number ]) {
    // [\'A\', 1], [\'B\', 2], [\'C\', null]
}

单个迭代

小块

返回一定尺寸的元素。

Single::chunkwise(iterable $data, int $chunkSize)

块大小必须至少1。

 use IterTools \\ Single ;

$ movies = [
    \' Phantom Menace \' , \' Attack of the Clones \' , \' Revenge of the Sith \' ,
    \' A New Hope \' , \' Empire Strikes Back \' , \' Return of the Jedi \' ,
    \' The Force Awakens \' , \' The Last Jedi \' , \' The Rise of Skywalker \'
];

foreach (Single:: chunkwise ( $ movies , 3 ) as $ trilogy ) {
    $ trilogies [] = $ trilogy ;
}
// [
//     [\'Phantom Menace\', \'Attack of the Clones\', \'Revenge of the Sith\'],
//     [\'A New Hope\', \'Empire Strikes Back\', \'Return of the Jedi\'],
//     [\'The Force Awakens\', \'The Last Jedi\', \'The Rise of Skywalker]\'
// ]

块状重叠

返回重叠的元素。

Single::chunkwiseOverlap(iterable $data, int $chunkSize, int $overlapSize, bool $includeIncompleteTail = true)

• 块大小必须至少1。
• 重叠尺寸必须小于块大小。

 use IterTools \\ Single ;

$ numbers = [ 1 , 2 , 3 , 4 , 5 , 6 , 7 , 8 , 9 , 10 ];

foreach (Single:: chunkwiseOverlap ( $ numbers , 3 , 1 ) as $ chunk ) {
    // [1, 2, 3], [3, 4, 5], [5, 6, 7], [7, 8, 9], [9, 10]
}

压缩

通过过滤未选择的数据来压缩一个峰值。

Single::compress(string $data, $selectors)

 use IterTools \\ Single ;

$ movies = [
    \' Phantom Menace \' , \' Attack of the Clones \' , \' Revenge of the Sith \' ,
    \' A New Hope \' , \' Empire Strikes Back \' , \' Return of the Jedi \' ,
    \' The Force Awakens \' , \' The Last Jedi \' , \' The Rise of Skywalker \'
];
$ goodMovies = [ 0 , 0 , 0 , 1 , 1 , 1 , 1 , 0 , 0 ];

foreach (Single:: compress ( $ movies , $ goodMovies ) as $ goodMovie ) {
    print ( $ goodMovie );
}
// \'A New Hope\', \'Empire Strikes Back\', \'Return of the Jedi\', \'The Force Awakens\'

压缩关联

通过过滤未选择的键来压缩一个峰值。

Single::compressAssociative(string $data, array $selectorKeys)

• 仅标准PHP数组/迭代器键（字符串，整数）。

 use IterTools \\ Single ;

$ starWarsEpisodes = [
    \' I \'    => \' The Phantom Menace \' ,
    \' II \'   => \' Attack of the Clones \' ,
    \' III \'  => \' Revenge of the Sith \' ,
    \' IV \'   => \' A New Hope \' ,
    \' V \'    => \' The Empire Strikes Back \' ,
    \' VI \'   => \' Return of the Jedi \' ,
    \' VII \'  => \' The Force Awakens \' ,
    \' VIII \' => \' The Last Jedi \' ,
    \' IX \'   => \' The Rise of Skywalker \' ,
];
$ originalTrilogyNumbers = [ \' IV \' , \' V \' , \' VI \' ];

foreach (Single:: compressAssociative ( $ starWarsEpisodes , $ originalTrilogyNumbers ) as $ episode => $ title ) {
    print ( \" $ episode : $ title \" . \\ PHP_EOL );
}
// IV: A New Hope
// V: The Empire Strikes Back
// VI: Return of the Jedi

掉线

在谓词函数为真时，从峰值中删除元素。

一旦谓词函数返回false一次，将返回所有剩余元素。

Single::dropWhile(iterable $data, callable $predicate)

 use IterTools \\ Single ;

$ scores    = [ 50 , 60 , 70 , 85 , 65 , 90 ];
$ predicate = fn ( $ x ) => $ x < 70 ;

foreach (Single:: dropWhile ( $ scores , $ predicate ) as $ score ) {
    print ( $ score );
}
// 70, 85, 65, 90

筛选

过滤掉距离谓词函数为真的仅返回元素的元素。

Single::filter(iterable $data, callable $predicate)

 use IterTools \\ Single ;

$ starWarsEpisodes   = [ 1 , 2 , 3 , 4 , 5 , 6 , 7 , 8 , 9 ];
$ goodMoviePredicate = fn ( $ episode ) => $ episode > 3 && $ episode < 8 ;

foreach (Single:: filter ( $ starWarsEpisodes , $ goodMoviePredicate ) as $ goodMovie ) {
    print ( $ goodMovie );
}
// 4, 5, 6, 7

过滤器true

过滤掉从峰值的元素中删除元素，仅返回的元素。

Single::filterTrue(iterable $data)

 use IterTools \\ Single ;

$ reportCardGrades = [ 100 , 0 , 95 , 85 , 0 , 94 , 0 ];

foreach (Single:: filterTrue ( $ reportCardGrades ) as $ goodGrade ) {
    print ( $ goodGrade );
}
// 100, 95, 85, 94

过滤器false

过滤掉从峰值返回元素为false的元素中滤除元素。

如果没有提供谓词，则使用数据的布尔值。

Single::filterFalse(iterable $data, callable $predicate)

下载源码

从 GitHub 克隆

通过命令行克隆项目:

git clone https://github.com/markrogoyski/itertools-php.git