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