idles

アイドル-PHP機能ライブラリ

PHP機能ユーティリティライブラリ、JavaScript Lodashポート/FP、RAMDAライブラリへのPHPへ。

すべての機能は副作用がなく、自動的にカレーであり、データは不可能です。

通常、反復可能なコレクションパラメーターは、カリーを便利にするために最後に提供されます。

怠zy /遅延評価は、機能パイプラインでサポートされています。

詳細、ドキュメント、および例については、 https：//idlephp.techにアクセスしてください。

要件

PHP 7.4以上

インストール

composer require miroshnikov/idles

ロードマップ

注記

IDLEは現在、アクティブな開発中です。ロードマップは、LodashおよびRamdaライブラリといくつかの機能ツールからすべてのメソッドを追加することです。

ドキュメント

配列

concat

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

追加のiterables/valuesで$arrayを連結します

カウント

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

$ $predicateに一致する$collectionのアイテムの数をカウントします

カウントビー

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

配列を返します：[ $iteratee($value) => $iteratee($value) $collectionで見つかった回数]

落とす

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

最初の$nエレメンスをスキップし、反復可能な残りの部分を返します

ドロップライト

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

最後の$n要素をスキップします

findindex

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

findのように、最初の要素のインデックスを返すPredicateはTruthyを返します-1

findlastindex

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

findのように、最後の要素のインデックスを返すPredicateはTruthyを返します-1

平らに

flatten(?iterable $ collection ): iterable

1つのレベルの深さを繰り返します。

flattendeep

flattenDeep(?iterable $ collection ): iterable

再帰的に平らになります反復性。

flattendepth

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

深さまでアレイを再帰的に平らにします。

frompairs

fromPairs(?iterable $ collection ): array

リストキー値ペアから新しいレコードを作成します。 toPairsの逆。

頭

head(?iterable $ collecton )

反復可能な最初の要素を取得します

indexof

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

$collection 、else -1の$valueの最初の発生のインデックスを返します。

交差点

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起動から$iterableのスライスを再実行しますが、 $endを含めません。

取る

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

NecerableからNの最初の要素を取ります

テッカライト

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

最後から採取したn要素で反復可能なスライスを返します。

uniq

uniq(?iterable $ collection ): array

===を使用して複製を削除します

uniqueby

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

uniqのように、 $iteratee fistを適用します

uniqwith

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

uniqのように、しかし$predicateを使用して要素を比較します

それなし

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

$valuesなしで$iterableを返します

ジップ

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

グループ化された要素の反復可能な要素を作成します。最初の要素には、指定された反復可能性の最初の要素が含まれ、その2番目には2番目の要素などが含まれます。

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の要素に対してTruthyを返すかどうかを確認します。最初に見つかった停止。

それぞれ

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

$collectionの要素を繰り返します。 Iterateeは、 falseを返すことにより、早期に反復を終了する場合があります。

フィルター

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

要素を返す$predicate Truthyを返します。

探す

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

最初の要素を返します$predicate Truthyを返します。

フラットマップ

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(callable $ iteratee , ?iterable $ collection ): array

$iterateeを介して各値を実行することから生成されたキーで構成される配列を作成します。

含まれています

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

$value $collectionであるかどうかを確認します。

Indexby

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

$iterateeを介して$collectionの各要素を実行した結果から生成されたキーで構成されるレコードを作成します。

地図

 map (callable $ iteratee , ?iterable $ collection )

各要素を$ $iteratee $collectionで実行します。

Orderby

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

sortByようなものですが、ソートオーダーを指定できます

パーティション

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

$collection 2つのグループに分割します。最初のグループには要素が含まれています$predicate Truthyを返します。2番目には$predicate Falseyを返します。

減らす

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

$iterateeを介してコレクションで各要素を実行することの蓄積された結果である$collection値に減らします

解決する

 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(array $ comparators , ?iterable $ collection ): array

比較の配列（ $a <=> $b ）関数に従って$collectionを並べ替えます

値

values(?iterable $ collection ): iterable

$collectionの値のインデックス付き反復を返します。

関数

いつも

 always ( $ value )

常に指定された値を返す関数を返します。

適用します

 applyTo ( $ value , callable $ interceptor )

$interceptor($value)を返します。

アリー

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

追加の引数を無視して、最大$n引数で$fnを呼び出す関数を作成します。

上昇します

 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

最初の2つの引数が逆になって新しいカレー機能を返します

並置

 juxt (array $ funcs ): callable

関数のリストを値のリストに適用します。

メモ

 memoize (callable $ func ): callable

$funcの結果をメモ化する関数を作成します。 $resolver 、マップキャッシュキーを返します。

否定します

 negate (callable $ predicate ): callable

$predicate関数の結果を無効にする関数を作成します。

一度

 once (callable $ fn ): callable

$fn 1回のみ呼び出され、最初の値はその後の呼び出しで返されます。

部分的

 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 (array $ predicates ): callable

引数がすべての$predicatesを渡すかどうかをチェックする関数を返します。

任意のパス

 anyPass (array $ predicates ): callable

引数が$predicatesのいずれかを渡すかどうかをチェックする関数を返します。

両方

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

結果の関数は、それがfalsyまたは$ func2 $func1(...$args)の場合、$ func1 $func2(...$args)を返します。

cond

 cond (array $ pairs ): callable

$pairsを繰り返し、最初の述語の対応する関数を呼び出して真実を返します。

デフォルト

 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) Truthyまたは$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

12月

 dec (int $ number ): int

$ number -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

 lt ( $ a , $ b ): bool

$ a <$ b

lte

 lte ( $ a , $ b ): bool

$ a <= $ b

モジュロ

 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

指定された$precisionに$numberを丸めます

減算します

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

$ a -$ b

和

sum(?iterable $ collection ): int|float

反復可能な要素を合計します

サンビー

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

同様のsumでありますが、 $iteratee 、合計する値を生成するために、反復可能な各要素に対して呼び出されます。

記録

assightdeep

 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(string|int|array $ path , ?iterable $ record ): bool

$recordに$pathが存在するかどうかを確認します

反転

invert(?iterable $ collection ): array

キーを値に置き換えます。重複キーが上書きされます。

キー

keys(?iterable $ record ): iterable

$recordのキーのインデックス付き反復を返します。

マージ

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

プロパティをマージし、数値キーが追加されます。

合併

 mergeDeep (array $ iterables ): array

プロパティを再帰的にマージし、数値キーが追加されます。

mergeleft

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

merge($right, $left)

mergewith

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

mergeのように、しかし両方のレコードにキーが存在する場合、 $customizerキーに関連付けられた値に呼び出されます

modifypath

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

指定された$pathで値に$updater関数を適用することにより、新しいレコードを作成します。

objof

 objOf (string $ key , $ value ): array

単一のキー=>値ペアを含むarrayを作成します。

省略します

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

pickの反対。 $keysなしでレコードを返します。

omitby

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

pickByの反対。 $predicate FALSELYを返すという$recordのプロパティを返します。

パス

 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 Truthyを返します。

摘み取る

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

提供された配列内のすべてのレコードから同じ名前付きプロパティを摘み取って、新しい配列を返します。

小道具

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

指定されたプロパティを返します。

propeq

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

$ records [$ key] == $ valueを返します

SetPath

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

$pathを$valueで設定してコピー$recordを返します

トップ

toPairs(?iterable $ record ): iterable

レコードを[$key, $value]の配列に変換します

どこ

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

$record $recordの対応するプロパティを使用して$specプロパティを呼び出すことにより、仕様を満たすかどうかを確認します。

どこが

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

$record $recordの対応するプロパティを使用して$specプロパティを呼び出すことにより、仕様を満たすかどうかを確認します。予測のうち少なくとも1つが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

文字列を小文字に変換します

トゥッパー

 toUpper (string $ s ): string

文字列を上品に変換します

言葉

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

文字列をその単語の配列に分割します。

活動

集める

collect(?iterable $ iterable ): array

繰り返し可能な任意のarrayを収集します

Eq

 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

たぶん/オプションモナド（コンテナ）は、非ヌル値を含む場合と含まない場合があります。方法があります：

isPresent(): bool空ではない場合はtrue
isEmpty(): bool空の場合はtrue
get(): mixed値を返し、空の場合は例外をスローします
orElse(mixed $default): mixedオプションが非空白または$default場合、含まれる値を返します
orElseThrow(Exception $e) - 存在する場合は含まれる値を返し、それ以外の場合は例外をスローします
map(callable $f): Optional - 値が存在する場合は、 $fを適用し、結果が非​​ヌルの場合は、結果を説明するオプションを返します
flatMap(callable $f): Optional - $fオプションを返す場合はmapの代わりに使用します
filter(callable $predicate): Optional - 値が存在し、 $predicateと一致する場合は、値でオプションを返します。

サイズ

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

関数の可算のサイズ、パラメーターの数、文字列の長さ、またはオブジェクトのプロパティの数を返します

t

 T (... $ args ): bool

常にtrueを返します