idles

空闲 - PHP功能库

PHP功能库库，JavaScript Lodash/fp的港口和ramda库的PHP。

所有功能都是无副作用的，并且自动咖喱，数据是不可变的。

通常提供的含量收集参数是使咖喱方便的。

功能管道中支持懒惰 /延迟评估。

有关更多详细信息，文档和示例，请访问https://idlephp.tech 。

要求

PHP 7.4或更高

安装

composer require miroshnikov/idles

路线图

笔记

IDLE目前正在积极发展。路线图将添加来自Lodash和Ramda库中的所有方法以及一些功能工具。

文档

大批

concat

concat(?iterable $ array, $ value ): iterable

将$array与其他迭代/值串联

数数

count(callable $ predicate , ?iterable $ collection ): int

计算与$ $predicate $collection中的项目数

Countby

countBy(callable $ iteratee , ?iterable $ collection ): array

返回一个数组：[ $iteratee($value) => $iteratee($value)次数在$collection中找到]

降低

drop(int $ n , ?iterable $ collection ): iterable

跳过第一个$n Elemens，然后返回其余的东西

滴定

dropRight(int $ n , ?iterable $ collection ): iterable

跳过最后的$n元素

FindIndex

findIndex(callable $ predicate , ?iterable $ collection ): int

像find但返回第一个元素谓词的索引返回真相， -1如果找不到的话

FindlastIndex

findLastIndex(callable $ predicate , ?iterable $ collection ): int

像find但返回最后一个元素谓词的索引返回真相， -1如果找不到的话

扁平

flatten(?iterable $ collection ): iterable

使一个层次的深度扁平化。

Flattendeep

flattenDeep(?iterable $ collection ): iterable

递归使具有凹陷的效果。

Flattendepth

flattenDepth(int $ depth , ?iterable $ collection ): iterable

递归使阵列直至深度时间。

从脚下

fromPairs(?iterable $ collection ): array

从列表键值对创建新记录。 toPairs的倒数。

头

head(?iterable $ collecton )

获取峰值的第一个元素

索引

indexOf( $ value , ?iterable $ collection ): int

返回第一次出现$value $collection的索引，else -1。

路口

intersection(?iterable $ record1 , ?iterable $ record2 ): array

返回两个记录中包含的唯一值

交叉点

intersectionBy(callable $ iteratee , ?iterable $ record1 , ?iterable $ record2 ): array

像intersection一样，但在比较之前为每个元素调用$iteratee 。

交点与

intersectionWith(callable $ comparator , ?iterable $ record1 , ?iterable $ record2 ): array

像intersection一样，但调用$comparator比较元素。

加入

join(string $ separator , ?iterable $ collection ): string

加入由$separator分隔的迭代元素

最后的

last(?iterable $ collecton )

获取峰值的最后一个元素

nth

 nth (int $ offset , ?iterable $ collection )

返回$offset元素。如果$offset为负，则返回索引长度 + $offset元素。

消除

remove(int $ start , int $ count , ?iterable $ iterable ): array

从$start开始并包含$count元素中删除$iterable的项目。

片

slice(int $ start , int ? $ end , ?iterable $ collection ): iterable

从$start到但不包括$end的$iterable itoser来重新返回。

拿

take(int $ n , ?iterable $ collection ): iterable

从Itable中获取n个第一元素

百货

takeRight(int $ n , ?iterable $ collection ): array

返回一小部分，其中n个元素从末尾取。

uniq

uniq(?iterable $ collection ): array

使用===删除重复项

唯一

uniqBy(callable $ iteratee , ?iterable $ collection ): array

像uniq一样，但施加$iteratee拳头

UNIQWITH

uniqWith(callable $ predicate , ?iterable $ collection ): array

像uniq一样，但使用$predicate比较元素

没有

without(array $ values , ?iterable $ collection ): iterable

返回$iterable没有$values

拉链

 zip (iterable $ a , iterable $ b ): iterable

创建一个分组元素的尤其是其中的第一个元素，其中包含给定迭代的第一个元素，其中第二个包含第二个元素，依此类推。

Zipwith

 zipWith (callable $ iteratee , iterable $ a , iterable $ b ): iterable

像zip一样，除了它接受$iteratee以指定应如何组合分组值。

收藏

全部

all(?callable $ predicate , ?iterable $ collection ): bool

检查$predicate是否返回$collection的所有元素的truthy 。一旦返回falsey

任何

any(callable $ predicate , ?iterable $ collection ): bool

检查$predicate是否返回$collection的任何元素。首先找到。

每个

each(callable $ iteratee , ?iterable $ collection ): iterable

迭代$collection的元素。 ITEMERE可以通过返回false提早退出迭代。

筛选

filter(callable $ predicate , ?iterable $ collection ): iterable

返回元素$predicate返回真相。

寻找

find(?callable $ predicate , ?iterable $ collection )

返回第一个元素$predicate返回真相。

flatmap

flatMap(callable $ iteratee , ?iterable $ collection ): iterable

然后地图变平

Flatmapdeep

flatMapDeep(callable $ iteratee , ?iterable $ collection ): iterable

像flatMap一样，但会递归地弄平结果。

flatmapdepth

flatMapDepth(callable $ iteratee , int $ depth , ?iterable $ collection ): iterable

像flatMap一样，但使映射结果达到$depth时间

Groupby

groupBy(callable $ iteratee , ?iterable $ collection ): array

创建一个由从运行每个值通过$iteratee生成的键组成的数组。

包括

includes( $ value , ?iterable $ collection ): bool

检查$value是否在$collection中。

索引比

indexBy(callable $ iteratee , ?iterable $ collection ): iterable

创建一个由通过$iteratee运行$collection的每个元素的结果生成的键组成的记录。

地图

 map (callable $ iteratee , ?iterable $ collection )

通过$iteratee将每个元素运行$collection中的每个元素。

订单

 orderBy (array $ iteratees , array $ orders , ?iterable $ collection )

像sortBy ，但允许指定排序订单

分割

partition(callable $ predicate , ?iterable $ collection ): array

将$collection分为两个组，其中第一个包含元素$predicate返回真相，其中第二个包含元素$predicate返回false。

减少

 reduce (callable $ iteratee , $ accumulator , ?iterable $ collection )

将$collection降低为一个值，这是通过$iteratee运行每个元素的累积结果

解决

 resolve (array $ resolvers , array $ record ): array

使用$resolvers将新属性添加到$record 。

种类

sort(array $ comparator , ?iterable $ collection ): array

使用$comparator比较（ $a <=> $b ）功能的$collection

排序方式

sortBy(array $ comparators , ?iterable $ collection ): array

根据$comparators按升级顺序排列$collection 。

sortwith

sortWith(array $ comparators , ?iterable $ collection ): array

根据一系列比较（ $a <=> $b ）功能进行$collection

值

values(?iterable $ collection ): iterable

返回$collection中值的索引值。

功能

总是

 always ( $ value )

返回一个始终返回给定值的函数。

申请

 applyTo ( $ value , callable $ interceptor )

返回$interceptor($value) 。

ary

 ary (int $ n , callable $ fn ): callable

创建一个调用$fn的函数，最多$n参数，忽略任何其他参数。

上升

 ascend (callable $ func , $ a , $ b ): callable

从一个返回可以与<=>进行比较的值的函数中，使升级比较器函数从

试图

 attempt (callable $ fn )

调用$fn ，返回结果或捕获的例外。

撰写

 compose (callable . . . $ funcs ): callable

像pipe一样，但可以调用从右到左的功能。

咖喱

 curry (callable $ f ): callable

Idles_ const可以用作占位符。

咖喱

 curryRight (callable $ f ): callable

像curry一样，但曾经培养论点。

下降

 descend (callable $ func , $ a , $ b ): callable

从返回可以与<=>进行比较的值的函数中，使降序比较器函数脱离了函数。

翻动

 flip (callable $ fn ): callable

返回一个新的咖喱功能，前两个参数反向

juxt

 juxt (array $ funcs ): callable

将功能列表应用于值列表。

回忆

 memoize (callable $ func ): callable

创建一个记忆$func结果的函数。 $resolver返回地图高速缓存键，默认情况下，args [0]。

否定

 negate (callable $ predicate ): callable

创建一个否定$predicate函数结果的函数。

一次

 once (callable $ fn ): callable

$fn仅被调用一次，在后续调用中返回第一个值。

部分的

 partial (callable $ fn , array $ partials ): callable

创建一个用$partials调用$fn的函数。 Idles_ const可以用作占位符。

偏见

 partialRight (callable $ fn , array $ partials ): callable

像partial但$partials一样。

管道

 pipe (callable . . . $ funcs ): callable

从左到右功能组成。第一个论点可能具有任何障碍。其余的论点必须是一致的。

轻敲

 tap (callable $ interceptor , $ value )

调用$interceptor($value)然后返回原始$value

时代

 times (callable $ iteratee , int $ n ): array

调用IterateE $n次，返回每个调用结果的数组。

TryCatch

 tryCatch (callable $ tryer , callable $ catcher , $ value )

调用$tryer ，如果扔了，请调用$catcher

一般

 unary (callable $ fn ): callable

ary(1, $fn)

逻辑

allpass

 allPass (array $ predicates ): callable

返回一个函数，该函数是否检查其参数是否通过所有$predicates 。

Anypass

 anyPass (array $ predicates ): callable

返回一个函数，该函数检查其参数是否通过$predicates 。

两个都

 both (callable $ func1 , callable $ func2 ): callable

结果功能返回$func1(...$args)如果是虚假的或$func2(...$args) ，否则，短路

cond

 cond (array $ pairs ): callable

迭代超过$pairs ，并调用第一个谓词的相应功能以返回真相。

defaultto

 defaultTo ( $ default )( $ value )

返回$value ?? $default

任何一个

 either (callable $ func1 , callable $ func2 ): callable

结果功能返回$func1(...$args)如果是真实的或$func2(...$args) ，否则，短路。

ifelse

 ifElse (callable $ predicate , callable $ onTrue , callable $ onFalse ): callable

结果函数返回$onTrue(...$args)如果$predicate(...$args)是真实的或$onFalse(...$args)否则。

不是

 not ( $ a ): bool

返回!$a

除非

 unless (callable $ predicate , callable $ whenFalse , mixed $ value )

返回$predicate($value) ? $value : $whenFalse($value)

什么时候

 when (callable $ predicate , callable $ whenTrue , mixed $ value )

返回$predicate($value) ? $whenTrue($value) : $value

数学

添加

 add (int|float $ a , int|float $ b ): int|float

$ a + $ b

十二月

 dec (int $ number ): int

返回$数字-1

划分

 divide (int|float $ a , int|float $ b ): int|float

$ a / $ b

GT

 gt ( $ a , $ b ): bool

$ a> $ b

GTE

 gte ( $ a , $ b ): bool

$ a> = $ b

Inc

 inc (int $ number ): int

返回$数字 + 1

上尉

 lt ( $ a , $ b ): bool

$ a <$ b

LTE

 lte ( $ a , $ b ): bool

$ a <= $ b

Modulo

 modulo (int|float $ a , int|float $ b ): int

$ a％$ b

乘

 multiply (int|float $ a , int|float $ b ): int|float

$ a * $ b

圆形的

 round (int $ precision , int|float $ number ): float

$number指定的$precision

减去

 subtract (int|float $ a , int|float $ b ): int|float

$ a -$ b

和

sum(?iterable $ collection ): int|float

概括元素中的元素

Shumby

sumBy(?callable $ iteratee , ?iterable $ collection ): int|float

就像sum一样，但$iteratee在估计中都被调用，以生成要求和的值。

记录

分配Deep

 assignDeep (array $ iterables ): array

递归合并属性，数字密钥被覆盖。

默认值

defaults(?iterable $ record1 , ?iterable $ record2 ): array

合并属性从右到左，数字键被覆盖。

发展

evolve(array $ transformations , ?iterable $ record ): array

通过递归调用具有$record属性的转换功能来创建新记录。

延长

extend(?iterable $ source1 , ?iterable $ source2 ): array

合并属性，数字密钥被覆盖。

有

has(string|int $ key , ?iterable $ record ): bool

检查$record是否有$key

haspath

hasPath(string|int|array $ path , ?iterable $ record ): bool

检查$path是否存在于$record中

倒置

invert(?iterable $ collection ): array

用值代替键。重复的键被覆盖。

钥匙

keys(?iterable $ record ): iterable

在$record中返回键的索引。

合并

merge(?iterable $ source1 , ?iterable $ source2 ): array

合并属性，数字密钥附加。

合并ep

 mergeDeep (array $ iterables ): array

递归合并属性，附加数字密钥。

Mergeleft

mergeLeft(?iterable $ left , ?iterable $ right ): array

呼叫merge($right, $left)

合并

mergeWith(callable $ customizer , ?iterable $ left , ?iterable $ right ): array

像merge $customizer

modifypath

 modifyPath (array|string|int $ path , callable $ updater , ?iterable $ record )

通过将$updater功能应用于给定$path的值来创建新记录。

objof

 objOf (string $ key , $ value ): array

创建一个包含一个键=>值对的array 。

忽略

omit(array $ keys , ?iterable $ collection ): iterable

pick的对立面。返回记录没有$keys 。

省略

omitBy(callable $ predicate , ?iterable $ record ): iterable

pickBy的对立面。返回$record $predicate返回虚假的属性。

小路

 path (array|string $ path , ?iterable $ collection )

在给定路径上检索值。

路径

paths(array $ paths , ?iterable $ collection ): array

键输入，值。保留订单。

挑选

pick(array $ keys , ?iterable $ collection ): iterable

仅包含$keys返回记录

皮克比

pickBy(callable $ predicate , ?iterable $ record ): iterable

返回记录仅包含键$predicate返回真相。

采摘

 pluck (string|int $ key , ?iterable $ collection )

通过从所提供的阵列中的所有记录中摘下相同的命名属性来返回一个新数组。

支柱

 prop (string|int $ key , ?iterable $ record )

返回指定的属性。

PROPEQ

propEq(string|int $ key , $ value , ?iterable $ record ): bool

返回$记录[$ key] == $ value

SetPath

 setPath ( $ path , $ value , ?iterable $ record )

返回复制$record ，带有$value的$path设置

桌子

toPairs(?iterable $ record ): iterable

将记录转换为[$key, $value]的数组

在哪里

where(array $ spec , ?iterable $ record ): bool

检查$record是否通过使用$spec $record规格属性来满足规格。

whereany

whereAny(array $ spec , ?iterable $ record ): bool

检查$record是否通过使用$spec $record规格属性来满足规格。如果至少一个谓词返回true ，则返回true 。

whereeq

whereEq(array $ spec , ?iterable $ test ): bool

检查$test是否满足$spec

细绳

逃脱

 escape (string $ s ): string

将字符“＆”，“”，“”，“'，'”和“”转换为其相应的HTML实体。

ESCAPEREGEXP

 escapeRegExp (string $ regexp ): string

逃脱正则表达

分裂

 split (string $ separator , string $ s ): array

通过$separator拆分字符串。

Startswith

 startsWith (string $ target , string $ s ): bool

如果字符串以$target开头。

tolower

 toLower (string $ s ): string

将字符串转换为较低的情况

touper

 toUpper (string $ s ): string

将字符串转换为上情况

字

 words (string $ pattern , string $ string ): array

将字符串分成多种单词。

util

收集

collect(?iterable $ iterable ): array

将任何值会收集到array中

等式

 eq ( $ a , $ b ): bool

$a == $b

平等

 equals ( $ a , $ b ): bool

$a === $b

f

 F (... $ args ): bool

总是返回false

身份

 identity ( $ value )

返回其收到的第一个参数。

迭代

 iterate (callable $ f , $ value ): iterable

返回$value ， $f($value) ， $f($f($value))等的生成器。

只是

 just ( $ value ): Optional

返回带有指定的非零值的可选

没有什么

nothing(): Optional

返回空的可选

现在

 now (): int

返回秒数的时间戳

选修的

 just (mixed $ value ): Optional

也许/选项monad（容器）可能包含或不包含非零值。有方法：

isPresent(): bool是true如果不是空的
isEmpty(): bool true如果是空的
get(): mixed - 返回价值，如果空，请抛出异常
orElse(mixed $default): mixed - 如果可选的是非空或$default则返回包含的值
orElseThrow(Exception $e) - 返回包含的值，如果有的话，否则会引发异常
map(callable $f): Optional - 如果存在值，请将$f应用于其，如果结果不为无效，请返回一个可选的描述结果
flatmap（可map flatMap(callable $f): Optional - 如果$f返回可选
filter(callable $predicate): Optional - 如果存在一个值并与$predicate匹配，请返回带有该值的可选，否则为空的可选。

尺寸

 size (array|Countable|object|string|callable $ value ): int

返回一个可数的函数参数数量，字符串的lenght或对象属性数量的大小

t

 T (... $ args ): bool

总是返回true