lodash php
0.1.0
Lodash-PHP ist eine Portierung der Lodash JS-Bibliothek auf PHP. Es handelt sich um eine Reihe benutzerfreundlicher Hilfsfunktionen für alltägliche PHP-Projekte.
Lodash-PHP versucht, lodash.js so nah wie möglich nachzuahmen
Lodash-PHP erfordert mindestens PHP 7.2+, aber die neueste Version von PHP wird immer empfohlen.
Installieren Sie Lodash-PHP über Composer:
$ composer require lodash-php/lodash-phpJede Methode in Lodash-PHP ist eine separate Funktion, die einzeln importiert und verwendet werden kann.
<?php
use function _ each ;
each ([ 1 , 2 , 3 ], function ( int $ item ) {
var_dump ( $ item );
}); Lodash-PHP verfügt außerdem über eine globale _ Klasse, die global verwendet werden kann.
<?php
_:: each ([ 1 , 2 , 3 ], function ( int $ item ) {
var_dump ( $ item );
}); Erstellt ein Array von Elementen, aufgeteilt in Gruppen mit der Länge size . Wenn array nicht gleichmäßig aufgeteilt werden kann, besteht der letzte Teil aus den verbleibenden Elementen.
Argumente:
@param array $array array Das zu verarbeitende Array.
@param int $number [size=1] Die Länge jedes Blocks
Zurückkehren:
@return array Gibt das neue Array von Chunks zurück.
Beispiel:
<?php
use function _ chunk ;
chunk ([ ' a ' , ' b ' , ' c ' , ' d ' ], 2 )
// => [['a', 'b'], ['c', 'd']]
chunk ([ ' a ' , ' b ' , ' c ' , ' d ' ], 3 )
// => [['a', 'b', 'c'], ['d']] Erstellt ein Array, aus dem alle falschen Werte entfernt werden. Die Werte false , null , 0 , "" , undefined und NaN sind falsch.
Argumente:
@param array $array Das zu komprimierende Array.
Zurückkehren:
@return array Gibt das neue Array gefilterter Werte zurück.
Beispiel:
<?php
use function _ compact ;
compact ([ 0 , 1 , false , 2 , '' , 3 ])
// => [1, 2, 3] Erstellt ein neues Array, das array mit allen zusätzlichen Arrays und/oder Werten verkettet.
Argumente:
@param array $array Das zu verkettende Array.
@param array<int, Mixed> $values Die zu verkettenden Werte.
Zurückkehren:
@return array Gibt das neue verkettete Array zurück.
Beispiel:
<?php
use function _ concat ;
$ array = [ 1 ];
$ other = concat ( $ array , 2 , [ 3 ], [[ 4 ]]);
var_dump ( $ other )
// => [1, 2, 3, [4]]
var_dump ( $ array )
// => [1] Erstellt ein Array von array -Werten, die nicht in den anderen angegebenen Arrays enthalten sind, und verwendet SameValueZero für Gleichheitsvergleiche. Die Reihenfolge und Referenzen der Ergebniswerte werden durch das erste Array bestimmt.
Hinweis: Im Gegensatz zu pullAll gibt diese Methode ein neues Array zurück.
Argumente:
@param array $array Das zu prüfende Array.
@param-Array ...$values Die auszuschließenden Werte.
Zurückkehren:
@return array Gibt das neue Array gefilterter Werte zurück.
Beispiel:
<?php
use function _ difference ;
difference ([ 2 , 1 ], [ 2 , 3 ])
// => [1] Diese Methode ähnelt difference , außer dass sie iteratee akzeptiert, das für jedes Element des array und values aufgerufen wird, um das Kriterium zu generieren, anhand dessen sie verglichen werden. Die Reihenfolge und Referenzen der Ergebniswerte werden durch das erste Array bestimmt. Der Iteratee wird mit einem Argument aufgerufen: (Wert).
Hinweis: Im Gegensatz zu pullAllBy gibt diese Methode ein neues Array zurück.
Argumente:
@param array $array Das zu prüfende Array.
@param array<int, Mixed> ...$values Die auszuschließenden Werte.
@param callable $iteratee Der pro Element aufgerufene Iteratee.
Zurückkehren:
@return array Gibt das neue Array gefilterter Werte zurück.
Beispiel:
<?php
use function _ differenceBy ;
differenceBy ([ 2.1 , 1.2 ], [ 2.3 , 3.4 ], ' floor ' )
// => [1.2] Diese Methode ähnelt difference , außer dass sie comparator akzeptiert, der aufgerufen wird, um Elemente eines array mit values zu vergleichen. Die Reihenfolge und Referenzen der Ergebniswerte werden durch das erste Array bestimmt. Der Komparator wird mit zwei Argumenten aufgerufen: (arrVal, othVal).
Hinweis: Im Gegensatz zu pullAllWith gibt diese Methode ein neues Array zurück.
Argumente:
@param array<int, Mixed> $array Das zu prüfende Array.
@param-Array ...$values Die auszuschließenden Werte.
@param callable $comparator Der pro Element aufgerufene Komparator.
Zurückkehren:
@return array Gibt das neue Array gefilterter Werte zurück.
Beispiel:
<?php
use function _ differenceWith ;
$ objects = [[ ' x ' => 1 , ' y ' => 2 ], [ ' x ' => 2 , ' y ' => 1 ]]
differenceWith ( $ objects , [[ ' x ' => 1 , ' y ' => 2 ]], ' _::isEqual ' )
// => [[ 'x' => 2, 'y' => 1 ]] Erstellt einen array -Slice mit n Elementen, die vom Anfang entfernt wurden.
HINWEIS: Diese Funktion ordnet die Array-Indizes neu und setzt sie zurück
Argumente:
@param array $array Das abzufragende Array.
@param int $n Die Anzahl der zu löschenden Elemente.
Zurückkehren:
@return array das Segment des array .
Beispiel:
<?php
use function _ drop ;
drop ([ 1 , 2 , 3 ])
// => [2, 3]
drop ([ 1 , 2 , 3 ], 2 )
// => [3]
drop ([ 1 , 2 , 3 ], 5 )
// => []
drop ([ 1 , 2 , 3 ], 0 )
// => [1, 2, 3] Erstellt einen array -Slice mit n Elementen, die am Ende entfernt werden. HINWEIS: Diese Funktion ordnet die Array-Indizes neu und setzt sie zurück
Argumente:
@param array $array Das abzufragende Array.
@param int $n Die Anzahl der zu löschenden Elemente.
Zurückkehren:
@return array das Segment des array .
Beispiel:
<?php
use function _ dropRight ;
dropRight ([ 1 , 2 , 3 ])
// => [1, 2]
dropRight ([ 1 , 2 , 3 ], 2 )
// => [1]
dropRight ([ 1 , 2 , 3 ], 5 )
// => []
dropRight ([ 1 , 2 , 3 ], 0 )
// => [1, 2, 3] Erstellt einen array -Slice ohne die am Ende entfernten Elemente. Elemente werden gelöscht, bis predicate falsey zurückgibt. Das Prädikat wird mit drei Argumenten aufgerufen: (Wert, Index, Array).
Argumente:
@param array $array Das abzufragende Array.
@param callable $predicate Die pro Iteration aufgerufene Funktion.
Zurückkehren:
@return array das Segment des array .
Beispiel:
<?php
use function _ dropRightWhile ;
$ users = [
[ ' user ' => ' barney ' , ' active ' => false ],
[ ' user ' => ' fred ' , ' active ' => true ],
[ ' user ' => ' pebbles ' , ' active ' => true ]
]
dropRightWhile ( $ users , function ( $ user ) { return $ user [ ' active ' ]; })
// => objects for ['barney'] Erstellt einen array -Slice ohne Elemente, die am Anfang entfernt wurden. Elemente werden gelöscht, bis predicate falsey zurückgibt. Das Prädikat wird mit drei Argumenten aufgerufen: (Wert, Index, Array).
Argumente:
@param array $array Das abzufragende Array.
@param callable $predicate Die pro Iteration aufgerufene Funktion.
Zurückkehren:
@return array das Segment des array .
Beispiel:
<?php
use function _ dropWhile ;
$ users = [
[ ' user ' => ' barney ' , ' active ' => true ],
[ ' user ' => ' fred ' , ' active ' => true ],
[ ' user ' => ' pebbles ' , ' active ' => false ]
]
dropWhile ( $ users , function ( $ user ) { return $ user [ ' active ' ]; } )
// => objects for ['pebbles'] Überprüft, ob predicate für alle Elemente des array die Wahrheit zurückgibt. Die Iteration wird gestoppt, sobald predicate falsey zurückgibt. Das Prädikat wird mit drei Argumenten aufgerufen: (Wert, Index, Array).
Hinweis: Diese Methode gibt für leere Arrays true zurück, da für Elemente leerer Arrays alles wahr ist.
Argumente:
@param iterable $collection Das Array, über das iteriert werden soll.
@param callable $predicate Die pro Iteration aufgerufene Funktion.
Zurückkehren:
@return bool true , wenn alle Elemente die Prädikatprüfung bestehen, andernfalls false .
Beispiel:
<?php
use function _ every ;
every ([ true , 1 , null , ' yes ' ], function ( $ value ) { return is_bool ( $ value );})
// => false
$ users = [
[ ' user ' => ' barney ' , ' age ' => 36 , ' active ' => false ],
[ ' user ' => ' fred ' , ' age ' => 40 , ' active ' => false ],
];
// The `matches` iteratee shorthand.
$ this -> assertFalse ( every ( $ users , [ ' user ' => ' barney ' , ' active ' => false ]));
// false
// The `matchesProperty` iteratee shorthand.
$ this -> assertTrue ( every ( $ users , [ ' active ' , false ]));
// true
// The `property` iteratee shorthand.
$ this -> assertFalse ( every ( $ users , ' active ' ));
//false
Diese Methode ähnelt find , außer dass sie den Index des ersten Elements zurückgibt. Das Prädikat gibt truey for anstelle des Elements selbst zurück.
Argumente:
@param array $array Das zu prüfende Array.
@param callable $predicate Die pro Iteration aufgerufene Funktion.
@param int $fromIndex Der Index, ab dem gesucht werden soll.
Zurückkehren:
@return int der Index des gefundenen Elements, sonst -1 .
Beispiel:
<?php
use function _ findIndex ;
$ users = [
[ ' user ' => ' barney ' , ' active ' => false ],
[ ' user ' => ' fred ' , ' active ' => false ],
[ ' user ' => ' pebbles ' , ' active ' => true ],
];
findIndex ( $ users , function ( $ o ) { return $ o [ ' user ' ] s== ' barney ' ; });
// => 0
// The `matches` iteratee shorthand.
findIndex ( $ users , [ ' user ' => ' fred ' , ' active ' => false ]);
// => 1
// The `matchesProperty` iteratee shorthand.
findIndex ( $ users , [ ' active ' , false ]);
// => 0
// The `property` iteratee shorthand.
findIndex ( $ users , ' active ' );
// => 2 Diese Methode ähnelt findIndex außer dass sie Elemente der collection von rechts nach links durchläuft.
Argumente:
@param array $array Das zu prüfende Array.
@param gemischt $predicate Die pro Iteration aufgerufene Funktion.
@param int $fromIndex Der Index, ab dem gesucht werden soll.
Zurückkehren:
@return int der Index des gefundenen Elements, sonst -1 .
Beispiel:
<?php
use function _ findLastIndex ;
$ users = [
[ ' user ' => ' barney ' , ' active ' => true ],
[ ' user ' => ' fred ' , ' active ' => false ],
[ ' user ' => ' pebbles ' , ' active ' => false ]
]
findLastIndex ( $ users , function ( $ user ) { return $ user [ ' user ' ] === ' pebbles ' ; })
// => 2 Reduziert array um eine Ebene tiefer.
Argumente:
@param array $array Das zu reduzierende Array.
Zurückkehren:
@return array das neue abgeflachte Array.
Beispiel:
<?php
use function _ flatten ;
flatten ([ 1 , [ 2 , [ 3 , [ 4 ]], 5 ]])
// => [1, 2, [3, [4]], 5] Reduziert array rekursiv.
Argumente:
@param array $array Das zu reduzierende Array.
Zurückkehren:
@return array Gibt das neue abgeflachte Array zurück.
Beispiel:
<?php
use function _ flattenDeep ;
flattenDeep ([ 1 , [ 2 , [ 3 , [ 4 ]], 5 ]]);
// => [1, 2, 3, 4, 5] Rekursives Reduzieren array auf depth .
Argumente:
@param array $array Das zu reduzierende Array.
@param int $ Depth Die maximale Rekursionstiefe.
Zurückkehren:
@return array das neue abgeflachte Array.
Beispiel:
<?php
use function _ flattenDepth ;
$ array = [ 1 , [ 2 , [ 3 , [ 4 ]], 5 ]]
flattenDepth ( $ array , 1 )
// => [1, 2, [3, [4]], 5]
flattenDepth ( $ array , 2 )
// => [1, 2, 3, [4], 5] Diese Methode ist die Umkehrung von toPairs und gibt ein Objekt zurück, das aus Schlüssel-Wert pairs besteht.
Argumente:
@param-Array $pairs Die Schlüssel-Wert-Paare.
Zurückkehren:
@return stdClass das neue Objekt.
Beispiel:
<?php
use function _ fromPairs ;
fromPairs ([[ ' a ' , 1 ], [ ' b ' , 2 ]])
// => stdClass(
// 'a' => 1,
//'b' => 2,
// ) Ruft das erste Element des array ab.
Argumente:
@param array $array Das abzufragende Array.
Zurückkehren:
@return Mixed Gibt das erste Element des array zurück.
Beispiel:
<?php
use function _ head ;
head ([ 1 , 2 , 3 ])
// => 1
head ([])
// => null Ruft mithilfe von SameValueZero für Gleichheitsvergleiche den Index ab, an dem das erste Vorkommen eines value im array gefunden wird. Wenn fromIndex negativ ist, wird er als Offset vom Ende des array verwendet.
Argumente:
@param array $array Das zu prüfende Array.
@param gemischt $value Der Wert, nach dem gesucht werden soll.
@param int $fromIndex Der Index, ab dem gesucht werden soll.
Zurückkehren:
@return int der Index des übereinstimmenden Werts, sonst -1 .
Beispiel:
<?php
use function _ indexOf ;
indexOf ([ 1 , 2 , 1 , 2 ], 2 )
// => 1
// Search from the `fromIndex`.
indexOf ([ 1 , 2 , 1 , 2 ], 2 , 2 )
// => 3 Ruft alle bis auf das letzte Element des array ab.
Argumente:
@param array $array Das abzufragende Array.
Zurückkehren:
@return array das Segment des array .
Beispiel:
<?php
use function _ initial ;
initial ([ 1 , 2 , 3 ])
// => [1, 2] Erstellt ein Array eindeutiger Werte, die in allen angegebenen Arrays enthalten sind, wobei SameValueZero für Gleichheitsvergleiche verwendet wird. Die Reihenfolge und Referenzen der Ergebniswerte werden durch das erste Array bestimmt.
Argumente:
@param-Array ...$arrays
Zurückkehren:
@return array das neue Array sich überschneidender Werte.
Beispiel:
<?php
use function _ intersection ;
intersection ([ 2 , 1 ], [ 2 , 3 ])
// => [2] Diese Methode ähnelt intersection , außer dass sie iteratee akzeptiert, das für jedes Element jedes arrays aufgerufen wird, um das Kriterium zu generieren, anhand dessen sie verglichen werden. Die Reihenfolge und Referenzen der Ergebniswerte werden durch das erste Array bestimmt. Der Iteratee wird mit einem Argument aufgerufen: (Wert).
Argumente:
@param array<int, Mixed> ...$arrays
@param callable $iteratee Der pro Element aufgerufene Iteratee.
Zurückkehren:
@return array das neue Array sich überschneidender Werte.
Beispiel:
<?php
use function _ intersectionBy ;
intersectionBy ([ 2.1 , 1.2 ], [ 2.3 , 3.4 ], Math.floor)
// => [2.1]
// The `property` iteratee shorthand.
intersectionBy ([[ ' x ' => 1 ]], [[ ' x ' => 2 ], [ ' x ' => 1 ]], ' x ' );
// => [[ 'x' => 1 ]] Diese Methode ähnelt intersection , außer dass sie comparator akzeptiert, der aufgerufen wird, um Elemente von arrays zu vergleichen. Die Reihenfolge und Referenzen der Ergebniswerte werden durch das erste Array bestimmt. Der Komparator wird mit zwei Argumenten aufgerufen: (arrVal, othVal).
Argumente:
@param-Array ...$arrays
@param callable $comparator Der pro Element aufgerufene Komparator.
Zurückkehren:
@return array das neue Array sich überschneidender Werte.
Beispiel:
<?php
use function _ intersectionWith ;
$ objects = [[ ' x ' => 1 , ' y ' => 2 ], [ ' x ' => 2 , ' y ' => 1 ]]
$ others = [[ ' x ' => 1 , ' y ' => 1 ], [ ' x ' => 1 , ' y ' => 2 ]]
intersectionWith ( $ objects , $ others , ' _::isEqual ' )
// => [[ 'x' => 1, 'y' => 2 ]] Ruft das letzte Element des array ab.
Argumente:
@param array $array Das abzufragende Array.
Zurückkehren:
@return Mixed Gibt das letzte Element des array zurück.
Beispiel:
<?php
use function _ last ;
last ([ 1 , 2 , 3 ])
// => 3 Diese Methode ähnelt indexOf , außer dass sie von rechts nach links über Elemente des array iteriert.
Argumente:
@param array $array Das zu prüfende Array.
@param gemischt $value Der Wert, nach dem gesucht werden soll.
@param int $fromIndex Der Index, ab dem gesucht werden soll.
Zurückkehren:
@return int der Index des übereinstimmenden Werts, sonst -1 .
Beispiel:
<?php
use function _ lastIndexOf ;
lastIndexOf ([ 1 , 2 , 1 , 2 ], 2 )
// => 3
// Search from the `fromIndex`.
lastIndexOf ([ 1 , 2 , 1 , 2 ], 2 , 2 )
// => 1 Ruft das Element am Index n des array ab. Wenn n negativ ist, wird das n-te Element vom Ende zurückgegeben.
Argumente:
@param array $array Das abzufragende Array.
@param int $n Der Index des zurückzugebenden Elements.
Zurückkehren:
@return Mixed Gibt das n-te Element des array zurück.
Beispiel:
<?php
use function _ nth ;
$ array = [ ' a ' , ' b ' , ' c ' , ' d ' ]
nth ( $ array , 1 )
// => 'b'
nth ( $ array , - 2 )
// => 'c' Entfernt alle angegebenen Werte aus array mithilfe von SameValueZero für Gleichheitsvergleiche.
Hinweis: Im Gegensatz zu without mutiert diese Methode array . Verwenden Sie remove um Elemente anhand eines Prädikats aus einem Array zu entfernen.
Argumente:
@param array $array Das zu ändernde Array.
@param array<int, string> $values Die zu entfernenden Werte.
Zurückkehren:
@return-Array
Beispiel:
<?php
use function _ pull ;
$ array = [ ' a ' , ' b ' , ' c ' , ' a ' , ' b ' , ' c ' ]
pull ( $ array , ' a ' , ' c ' )
var_dump ( $ array )
// => ['b', 'b'] Diese Methode ähnelt pull , außer dass sie ein Array von Werten zum Entfernen akzeptiert.
Hinweis: Im Gegensatz zu difference verändert diese Methode array .
Argumente:
@param array $array Das zu ändernde Array.
@param-Array $values Die zu entfernenden Werte.
Zurückkehren:
@return array array .
Beispiel:
<?php
use function _ pullAll ;
$ array = [ ' a ' , ' b ' , ' c ' , ' a ' , ' b ' , ' c ' ]
pullAll ( $ array , [ ' a ' , ' c ' ])
var_dump ( $ array )
// => ['b', 'b'] Diese Methode ähnelt pullAll , außer dass sie iteratee akzeptiert, das für jedes array -Element und values aufgerufen wird, um das Kriterium zu generieren, anhand dessen sie verglichen werden. Der Iteratee wird mit einem Argument aufgerufen: (Wert).
Hinweis: Im Gegensatz zu differenceBy verändert diese Methode array .
Argumente:
@param array $array Das zu ändernde Array.
@param-Array $values Die zu entfernenden Werte.
@param callable $iteratee Der pro Element aufgerufene Iteratee.
Zurückkehren:
@return array array .
Beispiel:
<?php
use function _ pullAllBy ;
$ array = [[ ' x ' => 1 ], [ ' x ' => 2 ], [ ' x ' => 3 ], [ ' x ' => 1 ]]
pullAllBy ( $ array , [[ ' x ' => 1 ], [ ' x ' => 3 ]], ' x ' )
var_dump ( $ array )
// => [[ 'x' => 2 ]] Diese Methode ähnelt pullAll , außer dass sie comparator akzeptiert, der aufgerufen wird, um Elemente eines array mit values zu vergleichen. Der Komparator wird mit zwei Argumenten aufgerufen: (arrVal, othVal).
Hinweis: Im Gegensatz zu differenceWith verändert diese Methode array .
Argumente:
@param array $array Das zu ändernde Array.
@param-Array $values Die zu entfernenden Werte.
@param callable $comparator Der pro Element aufgerufene Komparator.
Zurückkehren:
@return array array .
Beispiel:
<?php
use function _ pullAllWith ;
$ array = [[ ' x ' => 1 , ' y ' => 2 ], [ ' x ' => 3 , ' y ' => 4 ], [ ' x ' => 5 , ' y ' => 6 ]]
pullAllWith ( $ array , [[ ' x ' => 3 , ' y ' => 4 ]], ' _isEqual ' )
var_dump ( $ array )
// => [[ 'x' => 1, 'y' => 2 ], [ 'x' => 5, 'y' => 6 ]] Entfernt Elemente aus array die den indexes entsprechen, und gibt ein Array entfernter Elemente zurück.
Hinweis: Im Gegensatz zu at verändert diese Methode array .
Argumente:
@param array $array Das zu ändernde Array.
@param (int | int[]) $indexes Die Indizes der zu entfernenden Elemente.
Zurückkehren:
@return array das neue Array der entfernten Elemente.
Beispiel:
<?php
use function _ pullAt ;
$ array = [ ' a ' , ' b ' , ' c ' , ' d ' ]
$ pulled = pullAt ( $ array , [ 1 , 3 ])
var_dump ( $ array )
// => ['a', 'c']
var_dump ( $ pulled )
// => ['b', 'd'] Entfernt alle Elemente aus array , für die predicate die Wahrheit zurückgibt, und gibt ein Array der entfernten Elemente zurück. Das Prädikat wird mit drei Argumenten aufgerufen: (Wert, Index, Array).
Hinweis: Im Gegensatz zu filter mutiert diese Methode array . Verwenden Sie pull , um Elemente nach Wert aus einem Array abzurufen.
Argumente:
@param array $array Das zu ändernde Array.
@param callable $predicate Die pro Iteration aufgerufene Funktion.
Zurückkehren:
@return array das neue Array der entfernten Elemente.
Beispiel:
<?php
use function _ remove ;
$ array = [ 1 , 2 , 3 , 4 ]
$ evens = remove ( $ array , function ( $ n ) { return $ n % 2 === 0 ; })
var_dump ( $ array )
// => [1, 3]
var_dump ( $ evens )
// => [2, 4] Ruft ein zufälliges Element aus array ab.
Argumente:
@param array $array Das abzutastende Array.
Zurückkehren:
@return Mixed Gibt das Zufallselement zurück.
Beispiel:
<?php
use function _ sample ;
sample ([ 1 , 2 , 3 , 4 ])
// => 2 Ruft n zufällige Elemente mit eindeutigen Schlüsseln vom array bis zur Größe des array ab.
Argumente:
@param array $array Das abzutastende Array.
@param int $n Die Anzahl der abzutastenden Elemente.
Zurückkehren:
@return Array der zufälligen Elemente.
Beispiel:
<?php
use function _ sampleSize ;
sampleSize ([ 1 , 2 , 3 ], 2 )
// => [3, 1]
sampleSize ([ 1 , 2 , 3 ], 4 )
// => [2, 3, 1]Erstellt ein Array gemischter Werte
Argumente:
@param array $array Das zu mischende Array.
Zurückkehren:
@return array das neue gemischte Array.
Beispiel:
<?php
use function _ shuffle ;
shuffle ([ 1 , 2 , 3 , 4 ])
// => [4, 1, 3, 2] Erstellt einen array -Slice von start bis end , jedoch nicht einschließlich.
Argumente:
@param array $array Das aufzuteilende Array.
@param int $start Die Startposition.
@param int $end Die Endposition.
Zurückkehren:
@return array das Segment des array .
Ruft alle bis auf das erste Element des array ab.
Argumente:
@param array $array Das abzufragende Array.
Zurückkehren:
@return array das Segment des array .
Beispiel:
<?php
use function _ tail ;
tail ([ 1 , 2 , 3 ])
// => [2, 3] Erstellt einen array -Slice mit n Elementen vom Anfang an.
Argumente:
@param array $array Das abzufragende Array.
@param int $n Die Anzahl der zu übernehmenden Elemente.
Zurückkehren:
@return array das Segment des array .
Beispiel:
<?php
use function _ take ;
take ([ 1 , 2 , 3 ])
// => [1]
take ([ 1 , 2 , 3 ], 2 )
// => [1, 2]
take ([ 1 , 2 , 3 ], 5 )
// => [1, 2, 3]
take ([ 1 , 2 , 3 ], 0 )
// => [] Erstellt einen array -Slice mit n Elementen vom Ende.
Argumente:
@param array $array Das abzufragende Array.
@param int $n Die Anzahl der zu übernehmenden Elemente.
Zurückkehren:
@return array das Segment des array .
Beispiel:
<?php
use function _ takeRight ;
takeRight ([ 1 , 2 , 3 ])
// => [3]
takeRight ([ 1 , 2 , 3 ], 2 )
// => [2, 3]
takeRight ([ 1 , 2 , 3 ], 5 )
// => [1, 2, 3]
takeRight ([ 1 , 2 , 3 ], 0 )
// => [] Erstellt einen array -Slice mit Elementen vom Ende. Elemente werden übernommen, bis predicate falsey zurückgibt. Das Prädikat wird mit drei Argumenten aufgerufen: (Wert, Index, Array).
Argumente:
@param array $array Das abzufragende Array.
@param callable $predicate Die pro Iteration aufgerufene Funktion.
Zurückkehren:
@return array das Segment des array .
Beispiel:
<?php
use function _ takeRightWhile ;
$ users = [
[ ' user ' => ' barney ' , ' active ' => false ],
[ ' user ' => ' fred ' , ' active ' => true ],
[ ' user ' => ' pebbles ' , ' active ' => true ]
];
takeRightWhile ( $ users , function ( $ value ) { return $ value [ ' active ' ]; })
// => objects for ['fred', 'pebbles'] Erstellt einen array -Slice mit Elementen vom Anfang. Elemente werden übernommen, bis predicate falsey zurückgibt. Das Prädikat wird mit drei Argumenten aufgerufen: (Wert, Index, Array).
Argumente:
@param array $array Das abzufragende Array.
@param gemischt $predicate Die pro Iteration aufgerufene Funktion.
Zurückkehren:
@return array das Segment des array .
Beispiel:
<?php
use function _ takeWhile ;
$ users = [
[ ' user ' => ' barney ' , ' active ' => true ],
[ ' user ' => ' fred ' , ' active ' => true ],
[ ' user ' => ' pebbles ' , ' active ' => false ]
]
takeWhile ( $ users , function ( $ value ) { return $ value [ ' active ' ]; })
// => objects for ['barney', 'fred'] Erstellt aus allen angegebenen Arrays unter Verwendung von SameValueZero für Gleichheitsvergleiche ein Array eindeutiger Werte der Reihe nach.
Argumente:
@param array ...$arrays Die zu prüfenden Arrays.
Zurückkehren:
@return array das neue Array kombinierter Werte.
Beispiel:
<?php
use function _ union ;
union ([ 2 ], [ 1 , 2 ])
// => [2, 1] Diese Methode ähnelt union , außer dass sie iteratee akzeptiert, das für jedes Element jedes arrays aufgerufen wird, um das Kriterium zu generieren, anhand dessen die Eindeutigkeit berechnet wird. Ergebniswerte werden aus dem ersten Array ausgewählt, in dem der Wert vorkommt. Der Iteratee wird mit einem Argument aufgerufen: (Wert).
Argumente:
@param array<int, Mixed> ...$arrays Die zu prüfenden Arrays.
@param callable $iteratee Der pro Element aufgerufene Iteratee.
Zurückkehren:
@return array das neue Array kombinierter Werte.
Beispiel:
<?php
use function _ unionBy ;
unionBy ([ 2.1 ], [ 1.2 , 2.3 ], ' floor ' )
// => [2.1, 1.2]
// The `_::property` iteratee shorthand.
unionBy ([[ ' x ' => 1 ]], [[ ' x ' => 2 ], [ ' x ' => 1 ]], ' x ' );
// => [['x' => 1], ['x' => 2]] Diese Methode ähnelt union , außer dass sie comparator akzeptiert, der aufgerufen wird, um Elemente von arrays zu vergleichen. Ergebniswerte werden aus dem ersten Array ausgewählt, in dem der Wert vorkommt. Der Komparator wird mit zwei Argumenten aufgerufen: (arrVal, othVal).
Argumente:
@param array<int, Mixed> ...$arrays Die zu prüfenden Arrays.
@param callable $comparator Der pro Element aufgerufene Komparator.
Zurückkehren:
@return array das neue Array kombinierter Werte.
Beispiel:
<?php
use function _ unionWith ;
$ objects = [[ ' x ' => 1 , ' y ' => 2 ], [ ' x ' => 2 , ' y ' => 1 ]]
$ others = [[ ' x ' => 1 , ' y ' => 1 ], [ ' x ' => 1 , ' y ' => 2 ]]
unionWith ( $ objects , $ others , ' _::isEqual ' )
// => [['x' => 1, 'y' => 2], ['x' => 2, 'y' => 1], ['x' => 1, 'y' => 1]] Erstellt eine duplikatfreie Version eines Arrays unter Verwendung von SameValueZero für Gleichheitsvergleiche, in der nur das erste Vorkommen jedes Elements beibehalten wird. Die Reihenfolge der Ergebniswerte wird durch die Reihenfolge bestimmt, in der sie im Array auftreten.
Argumente:
@param array $array Das zu prüfende Array.
Zurückkehren:
@return array das neue duplizierte freie Array.
Beispiel:
<?php
use function _ uniq ;
uniq ([ 2 , 1 , 2 ])
// => [2, 1]s Diese Methode ähnelt uniq außer dass sie iteratee akzeptiert, das für jedes Element im array aufgerufen wird, um das Kriterium zu generieren, anhand dessen die Eindeutigkeit berechnet wird. Die Reihenfolge der Ergebniswerte wird durch die Reihenfolge bestimmt, in der sie im Array auftreten. Der Iteratee wird mit einem Argument aufgerufen: (Wert).
Argumente:
@param array $array Das zu prüfende Array.
@param gemischt $iteratee Der pro Element aufgerufene Iteratee.
Zurückkehren:
@return array das neue duplizierte freie Array.
Beispiel:
<?php
use function _ uniqBy ;
uniqBy ([ 2.1 , 1.2 , 2.3 ], ' floor ' )
// => [2.1, 1.2] Diese Methode ähnelt uniq außer dass sie comparator akzeptiert, der aufgerufen wird, um Elemente eines array zu vergleichen. Die Reihenfolge der Ergebniswerte wird durch die Reihenfolge bestimmt, in der sie im Array auftreten. Der Komparator wird mit zwei Argumenten aufgerufen: (arrVal, othVal).
Argumente:
@param array $array Das zu prüfende Array.
@param callable $comparator Der pro Element aufgerufene Komparator.
Zurückkehren:
@return array das neue duplizierte freie Array.
Beispiel:
<?php
use function _ uniqWith ;
$ objects = [[ ' x ' => 1 , ' y ' => 2 ], [ ' x ' => 2 , ' y ' => 1 ], [ ' x ' => 1 , ' y ' => 2 ]]
uniqWith ( $ objects , ' _::isEqual ' )
// => [['x' => 1, 'y' => 2], ['x' => 2, 'y' => 1]] Diese Methode ähnelt zip , außer dass sie ein Array gruppierter Elemente akzeptiert und ein Array erstellt, das die Elemente in ihrer Konfiguration vor dem ZIP neu gruppiert.
Argumente:
@param array $array Das Array der zu verarbeitenden gruppierten Elemente.
Zurückkehren:
@return array das neue Array neu gruppierter Elemente.
Beispiel:
<?php
use function _ unzip ;
$ zipped = zip ([ ' a ' , ' b ' ], [ 1 , 2 ], [ true , false ])
// => [['a', 1, true], ['b', 2, false]]
unzip ( $ zipped )
// => [['a', 'b'], [1, 2], [true, false]] Diese Methode ähnelt unzip außer dass sie iteratee akzeptiert, um anzugeben, wie neu gruppierte Werte kombiniert werden sollen. Der Iteratee wird mit den Elementen jeder Gruppe aufgerufen: (...group).
Argumente:
@param array $array Das Array der zu verarbeitenden gruppierten Elemente.
@param (aufrufbar | null) $iteratee Die Funktion zum Kombinieren neu gruppierter Werte.
Zurückkehren:
@return array das neue Array neu gruppierter Elemente.
Beispiel:
<?php
use function _ unzipWith ;
$ zipped = zip ([ 1 , 2 ], [ 10 , 20 ], [ 100 , 200 ])
// => [[1, 10, 100], [2, 20, 200]]
unzipWith (zipped, ' _::add ' )
// => [3, 30, 300] Erstellt ein Array, das alle angegebenen Werte ausschließt, wobei SameValueZero für Gleichheitsvergleiche verwendet wird.
Hinweis: Im Gegensatz zu pull gibt diese Methode ein neues Array zurück.
Argumente:
@param array $array Das zu prüfende Array.
@param array<int, Mixed> $values Die auszuschließenden Werte.
Zurückkehren:
@return array das neue Array gefilterter Werte.
Beispiel:
<?php
use function _ without ;
without ([ 2 , 1 , 2 , 3 ], 1 , 2 )
// => [3]Erstellt ein Array aus gruppierten Elementen, wobei das erste die ersten Elemente der angegebenen Arrays enthält, das zweite die zweiten Elemente der angegebenen Arrays usw. enthält.
Argumente:
@param array ...$arrays Die zu verarbeitenden Arrays.
Zurückkehren:
@return array das neue Array gruppierter Elemente.
Beispiel:
<?php
use function _ zip ;
zip ([ ' a ' , ' b ' ], [ 1 , 2 ], [ true , false ])
// => [['a', 1, true], ['b', 2, false]] Diese Methode ähnelt fromPairs außer dass sie zwei Arrays akzeptiert, eines mit Eigenschaftsbezeichnern und eines mit entsprechenden Werten.
Argumente:
@param-Array $props Die Eigenschaftsbezeichner.
@param-Array $values Die Eigenschaftswerte.
Zurückkehren:
@return object das neue Objekt.
Beispiel:
<?php
use function _ zipObject ;
zipObject ([ ' a ' , ' b ' ], [ 1 , 2 ])
/* => object(stdClass) #210 (2) {
[ " a " ] => int( 1 )
[ " b " ] => int( 2 )
}
*/ Diese Methode ähnelt zipObject , unterstützt jedoch Eigenschaftspfade.
Argumente:
@param-Array $props Die Eigenschaftsbezeichner.
@param-Array $values Die Eigenschaftswerte.
Zurückkehren:
@return stdClass das neue Objekt.
Beispiel:
<?php
use function _ zipObjectDeep ;
zipObjectDeep ([ ' a.b[0].c ' , ' a.b[1].d ' ], [ 1 , 2 ])
/* => class stdClass #20 (1) {
public $ a => class stdClass #19 (1) {
public $ b =>
array ( 2 ) {
[ 0 ] => class stdClass #17 (1) {
public $ c => int( 1 )
}
[ 1 ] => class stdClass #18 (1) {
public $ d => int( 2 )
}
}
}
}
*/ Diese Methode ähnelt zip , außer dass sie iteratee akzeptiert, um anzugeben, wie gruppierte Werte kombiniert werden sollen. Der Iteratee wird mit den Elementen jeder Gruppe aufgerufen: (...group).
Argumente:
@param array<int, (array | callable)> ...$arrays Die zu verarbeitenden Arrays.
@param aufrufbar $iteratee Die Funktion zum Kombinieren gruppierter Werte.
Zurückkehren:
@return array das neue Array gruppierter Elemente.
Beispiel:
<?php
use function _ zipWith ;
zipWith ([ 1 , 2 ], [ 10 , 20 ], [ 100 , 200 ], function ( $ a , $ b , $ c ) { return $ a + $ b + $ c ; })
// => [111, 222] Erstellt ein Array bestehend aus Schlüsseln, die aus den Ergebnissen der Ausführung jedes Elements der collection durch iteratee generiert werden. Der entsprechende Wert jedes Schlüssels gibt an, wie oft der Schlüssel von iteratee zurückgegeben wurde. Der Iteratee wird mit einem Argument aufgerufen: (Wert).
Argumente:
@param iterable $collection Die Sammlung, über die iteriert werden soll.
@param callable $iteratee Der Iteratee zum Transformieren von Schlüsseln.
Zurückkehren:
@return-Array Gibt das zusammengesetzte Aggregatobjekt zurück.
Beispiel:
<?php
use function _ countBy ;
countBy ([ 6.1 , 4.2 , 6.3 ], ' floor ' );
// => ['6' => 2, '4' => 1]
// The `property` iteratee shorthand.
countBy ([ ' one ' , ' two ' , ' three ' ], ' strlen ' );
// => ['3' => 2, '5' => 1] Iteriert über Elemente der collection und ruft iteratee für jedes Element auf. Der Iteratee wird mit drei Argumenten aufgerufen: (Wert, Index|Schlüssel, Sammlung). Iterierte Funktionen können die Iteration vorzeitig beenden, indem sie explizit false zurückgeben.
Hinweis: Wie bei anderen „Collections“-Methoden werden Objekte mit einer „length“-Eigenschaft wie Arrays iteriert. Um dieses Verhalten zu vermeiden, verwenden Sie forIn oder forOwn für die Objektiteration.
Argumente:
@param (array | iterable | object) $collection Die Sammlung, über die iteriert werden soll.
@param aufrufbar $iteratee Die pro Iteration aufgerufene Funktion.
Zurückkehren:
@return (Array | Objekt) Gibt collection zurück.
Beispiel:
<?php
use function _ each ;
each ([ 1 , 2 ], function ( $ value ) { echo $ value ; })
// => Echoes `1` then `2`.
each (( object ) [ ' a ' => 1 , ' b ' => 2 ], function ( $ value , $ key ) { echo $ key ; });
// => Echoes 'a' then 'b' (iteration order is not guaranteed). Diese Methode ähnelt each , außer dass sie von rechts nach links über Elemente der collection iteriert.
Argumente:
@param (array | iterable | object) $collection Die Sammlung, über die iteriert werden soll.
@param aufrufbar $iteratee Die pro Iteration aufgerufene Funktion.
Zurückkehren:
@return (Array | Objekt) Gibt collection zurück.
Beispiel:
<?php
use function _ eachRight ;
eachRight ([ 1 , 2 ], function ( $ value ) { echo $ value ; })
// => Echoes `2` then `1`. Iteriert über Elemente des array und gibt ein Array aller Elemente zurück. predicate gibt truey zurück. Das Prädikat wird mit drei Argumenten aufgerufen: (Wert, Index, Array).
Hinweis: Im Gegensatz zu remove gibt diese Methode ein neues Array zurück.
Argumente:
@param iterable $array Das Array, über das iteriert werden soll.
@param callable $predicate Die pro Iteration aufgerufene Funktion.
Zurückkehren:
@return array das neue gefilterte Array.
Beispiel:
<?php
use function _ filter ;
$ users = [
[ ' user ' => ' barney ' , ' age ' => 36 , ' active ' => true ],
[ ' user ' => ' fred ' , ' age ' => 40 , ' active ' => false ]
];
filter ( $ users , function ( $ o ) { return ! $ o [ ' active ' ]; });
// => objects for ['fred']
// The `matches` iteratee shorthand.
filter ( $ users , [ ' age ' => 36 , ' active ' => true ]);
// => objects for ['barney']
// The `matchesProperty` iteratee shorthand.
filter ( $ users , [ ' active ' , false ]);
// => objects for ['fred']
// The `property` iteratee shorthand.
filter ( $ users , ' active ' );
// => objects for ['barney'] Iteriert über Elemente der collection und gibt das predicate des ersten Elements als wahrheitsgemäß zurück. Das Prädikat wird mit drei Argumenten aufgerufen: (Wert, Index|Schlüssel, Sammlung).
Argumente:
@param iterable $collection Die zu überprüfende Sammlung.
@param callable $predicate Die pro Iteration aufgerufene Funktion.
@param int $fromIndex Der Index, ab dem gesucht werden soll.
Zurückkehren:
@return Mixed Gibt das übereinstimmende Element zurück, andernfalls null .
Beispiel:
<?php
use function _ find ;
$ users = [
[ ' user ' => ' barney ' , ' age ' => 36 , ' active ' => true ],
[ ' user ' => ' fred ' , ' age ' => 40 , ' active ' => false ],
[ ' user ' => ' pebbles ' , ' age ' => 1 , ' active ' => true ]
];
find ( $ users , function ( $ o ) { return $ o [ ' age ' ] < 40 ; });
// => object for 'barney'
// The `matches` iteratee shorthand.
find ( $ users , [ ' age ' => 1 , ' active ' => true ]);
// => object for 'pebbles'
// The `matchesProperty` iteratee shorthand.
find ( $ users , [ ' active ' , false ]);
// => object for 'fred'
// The `property` iteratee shorthand.
find ( $ users , ' active ' );
// => object for 'barney' Diese Methode ähnelt find , außer dass sie Elemente der collection von rechts nach links durchläuft.
Argumente:
@param iterable $collection Die zu überprüfende Sammlung.
@param callable $predicate Die pro Iteration aufgerufene Funktion.
@param int $fromIndex Der Index, ab dem gesucht werden soll.
Zurückkehren:
@return Mixed Gibt das übereinstimmende Element zurück, andernfalls undefined .
Beispiel:
<?php
use function _ findLast ;
findLast ([ 1 , 2 , 3 , 4 ], function ( $ n ) { return $ n % 2 == 1 ; })
// => 3 Erstellt ein abgeflachtes Array von Werten, indem jedes Element in collection durch iteratee ausgeführt wird und die zugeordneten Ergebnisse abgeflacht werden. Der Iteratee wird mit drei Argumenten aufgerufen: (Wert, Index|Schlüssel, Sammlung).
Argumente:
@param iterable $collection Die Sammlung, über die iteriert werden soll.
@param aufrufbar $iteratee Die pro Iteration aufgerufene Funktion.
Zurückkehren:
@return array das neue abgeflachte Array.
Beispiel:
<?php
use function _ flatMap ;
function duplicate ( $ n ) {
return [ $ n , $ n ]
}
flatMap ([ 1 , 2 ], ' duplicate ' )
// => [1, 1, 2, 2] Diese Methode ähnelt flatMap , außer dass sie die zugeordneten Ergebnisse rekursiv flacht.
Argumente:
@param iterable $collection Die Sammlung, über die iteriert werden soll.
@param aufrufbar $iteratee Die pro Iteration aufgerufene Funktion.
Zurückkehren:
@return array Gibt das neue abgeflachte Array zurück.
Beispiel:
<?php
use function _ flatMapDeep ;
function duplicate ( $ n ) {
return [[[ $ n , $ n ]]];
}
flatMapDeep ([ 1 , 2 ], ' duplicate ' );
// => [1, 1, 2, 2] Diese Methode ähnelt flatMap , außer dass sie die zugeordneten Ergebnisse rekursiv auf depth reduziert.
Argumente:
@param iterable $collection Die Sammlung, über die iteriert werden soll.
@param aufrufbar $iteratee Die pro Iteration aufgerufene Funktion.
@param int $ Depth Die maximale Rekursionstiefe.
Zurückkehren:
@return array das neue abgeflachte Array.
Beispiel:
<?php
use function _ flatMapDepth ;
function duplicate ( $ n ) {
return [[[ $ n , $ n ]]]
}
flatMapDepth ([ 1 , 2 ], ' duplicate ' , 2 )
// => [[1, 1], [2, 2]] Erstellt ein Array bestehend aus Schlüsseln, die aus den Ergebnissen der Ausführung jedes Elements der collection durch iteratee generiert werden. Die Reihenfolge der gruppierten Werte wird durch die Reihenfolge bestimmt, in der sie in collection auftreten. Der entsprechende Wert jedes Schlüssels ist ein Array von Elementen, die für die Generierung des Schlüssels verantwortlich sind. Der Iteratee wird mit einem Argument aufgerufen: (Wert).
Argumente:
@param iterable $collection Die Sammlung, über die iteriert werden soll.
@param callable $iteratee Der Iteratee zum Transformieren von Schlüsseln.
Zurückkehren:
@return-Array Gibt das zusammengesetzte Aggregatobjekt zurück.
Beispiel:
<?php
use function _ groupBy ;
groupBy ([ 6.1 , 4.2 , 6.3 ], ' floor ' );
// => ['6' => [6.1, 6.3], '4' => [4.2]]
groupBy ([ ' one ' , ' two ' , ' three ' ], ' strlen ' );
// => ['3' => ['one', 'two'], '5' => ['three']] Ruft die Methode im path jedes Elements in collection auf und gibt ein Array der Ergebnisse jeder aufgerufenen Methode zurück. Alle zusätzlichen Argumente werden für jede aufgerufene Methode bereitgestellt. Wenn path eine Funktion ist, wird sie für jedes Element in collection aufgerufen und an this gebunden.
Argumente:
@param iterable $collection Die Sammlung, über die iteriert werden soll.
@param (Array | Callable | String) $path Der Pfad der aufzurufenden Methode oder der pro Iteration aufgerufenen Funktion.
@param-Array $args Die Argumente, mit denen jede Methode aufgerufen werden soll.
Zurückkehren:
@return array das Array der Ergebnisse.
Beispiel:
<?php
use function _ invokeMap ;
invokeMap ([[ 5 , 1 , 7 ], [ 3 , 2 , 1 ]], function ( $ result ) { sort ( $ result ); return $ result ;})
// => [[1, 5, 7], [1, 2, 3]]
invokeMap ([ 123 , 456 ], ' str_split ' )
// => [['1', '2', '3'], ['4', '5', '6']] Erstellt ein Objekt, das aus Schlüsseln besteht, die aus den Ergebnissen der Ausführung jedes Elements der collection durch iteratee generiert werden. Der entsprechende Wert jedes Schlüssels ist das letzte Element, das für die Generierung des Schlüssels verantwortlich ist. Der Iteratee wird mit einem Argument aufgerufen: (Wert).
Argumente:
@param iterable $collection Die Sammlung, über die iteriert werden soll.
@param callable $iteratee Der Iteratee zum Transformieren von Schlüsseln.
Zurückkehren:
@return-Array das zusammengesetzte Aggregatobjekt.
Beispiel:
<?php
use function _ keyBy ;
$ array = [
[ ' direction ' => ' left ' , ' code ' => 97 ],
[ ' direction ' => ' right ' , ' code ' => 100 ],
];
keyBy ( $ array , function ( $ o ) { return chr ( $ o [ ' code ' ]); })
// => ['a' => ['direction' => 'left', 'code' => 97], 'd' => ['direction' => 'right', 'code' => 100]]
keyBy ( $ array , ' direction ' );
// => ['left' => ['direction' => 'left', 'code' => 97], 'right' => ['direction' => 'right', 'code' => 100]] Erstellt ein Wertearray, indem jedes Element in collection über iteratee ausgeführt wird. Der Iteratee wird mit drei Argumenten aufgerufen: (Wert, Index|Schlüssel, Sammlung).
Viele lodash-php-Methoden sind geschützt, um als Iteratoren für Methoden wie _::every , _::filter , _::map , _::mapValues , _::reject und _::some zu arbeiten.
Die geschützten Methoden sind: ary , chunk , curry , curryRight , drop , dropRight , every , fill , invert , parseInt , random , range , rangeRight , repeat , sampleSize , slice , some , sortBy , split , take , takeRight , template , trim , trimEnd , trimStart und words
Argumente:
@param (Array | Objekt) $collection Die Sammlung, über die iteriert werden soll.
@param (aufrufbar | String | Array) $iteratee Die pro Iteration aufgerufene Funktion.
Zurückkehren:
@return array Gibt das neue zugeordnete Array zurück.
Beispiel:
<?php
use function _ map ;
function square ( int $ n ) {
return $ n * $ n ;
}
map ([ 4 , 8 ], $ square );
// => [16, 64]
map (( object ) [ ' a ' => 4 , ' b ' => 8 ], $ square );
// => [16, 64] (iteration order is not guaranteed)
$ users = [
[ ' user ' => ' barney ' ],
[ ' user ' => ' fred ' ]
];
// The `property` iteratee shorthand.
map ( $ users , ' user ' );
// => ['barney', 'fred'] Diese Methode ähnelt sortBy , außer dass sie die Angabe der Sortierreihenfolge der zu sortierenden Iterationen ermöglicht. Wenn orders nicht angegeben ist, werden alle Werte in aufsteigender Reihenfolge sortiert. Geben Sie andernfalls eine Reihenfolge von „desc“ für absteigende oder „asc“ für aufsteigende Sortierreihenfolge der entsprechenden Werte an.
Argumente:
@param (iterable | null) $collection Die Sammlung, über die iteriert werden soll.
@param (array[] | callable[] | string[]) $iteratee Die Iteratee(s), nach denen sortiert werden soll.
@param string[] $orders Die Sortierreihenfolgen der iteratees .
Zurückkehren:
@return array das neue sortierte Array.
Beispiel:
<?php
use function _ orderBy ;
$ users = [
[ ' user ' => ' fred ' , ' age ' => 48 ],
[ ' user ' => ' barney ' , ' age ' => 34 ],
[ ' user ' => ' fred ' , ' age ' => 40 ],
[ ' user ' => ' barney ' , ' age ' => 36 ]
]
// Sort by `user` in ascending order and by `age` in descending order.
orderBy ( $ users , [ ' user ' , ' age ' ], [ ' asc ' , ' desc ' ])
// => [['user' => 'barney', 'age' => 36], ['user' => 'barney', 'age' => 34], ['user' => 'fred', 'age' => 48], ['user' => 'fred', 'age' => 40]] Erstellt ein Array von Elementen, die in zwei Gruppen aufgeteilt sind. Die erste Gruppe enthält Elemente, für die predicate wahr“ zurückgibt, und die zweite Gruppe enthält Elemente, für die predicate falsch“ zurückgibt. Das Prädikat wird mit einem Argument aufgerufen: (Wert).
Argumente:
@param iterable $collection Die Sammlung, über die iteriert werden soll.
@param callable $predicate Die pro Iteration aufgerufene Funktion.
Zurückkehren:
@return array das Array gruppierter Elemente.
Beispiel:
<?php
use function _ partition ;
$ users = [
[ ' user ' => ' barney ' , ' age ' => 36 , ' active ' => false ],
[ ' user ' => ' fred ' , ' age ' => 40 , ' active ' => true ],
[ ' user ' => ' pebbles ' , ' age ' => 1 , ' active ' => false ]
];
partition ( $ users , function ( $ user ) { return $ user [ ' active ' ]; })
// => objects for [['fred'], ['barney', 'pebbles']] Reduziert collection auf einen Wert, der das akkumulierte Ergebnis der Ausführung jedes Elements in collection durch iteratee ist, wobei jedem nachfolgenden Aufruf der Rückgabewert des vorherigen bereitgestellt wird. Wenn kein accumulator angegeben ist, wird das erste Element der collection als Anfangswert verwendet. Der Iteratee wird mit vier Argumenten aufgerufen: (Akkumulator, Wert, Index|Schlüssel, Sammlung).
Viele Lodash-Methoden sind so geschützt, dass sie als Iterationen für Methoden wie reduce , reduceRight und transform funktionieren.
Die geschützten Methoden sind: assign “, defaults “, defaultsDeep , „ includes “, merge , orderBy “ und sortBy “.
Argumente:
@param iterable $collection Die Sammlung, über die iteriert werden soll.
@param gemischt $iteratee Die pro Iteration aufgerufene Funktion.
@param gemischt $accumulator Der Anfangswert.
Zurückkehren:
@return Mixed Gibt den akkumulierten Wert zurück.
Beispiel:
<?php
use function _ reduce ;
reduce ([ 1 , 2 ], function ( $ sum , $ n ) { return $ sum + $ n ; }, 0 )
// => 3
reduce ([ ' a ' => 1 , ' b ' => 2 , ' c ' => 1 ], function ( $ result , $ value , $ key ) {
if (! isset ( $ result [ $ value ])) {
$ result [ $ value ] = [];
}
$ result [ $ value ][] = $ key ;
return $ result ;
}, [])
// => ['1' => ['a', 'c'], '2' => ['b']] (iteration order is not guaranteed) Diese Methode ähnelt reduce , außer dass sie Elemente der collection von rechts nach links durchläuft.
Argumente:
@param iterable $collection Die Sammlung, über die iteriert werden soll.
@param gemischt $iteratee Die pro Iteration aufgerufene Funktion.
@param gemischt $accumulator Der Anfangswert.
Zurückkehren:
@return Mixed Gibt den akkumulierten Wert zurück.
Beispiel:
<?php
use function _ reduceRight ;
$ array = [[ 0 , 1 ], [ 2 , 3 ], [ 4 , 5 ]];
reduceRight ( array , (flattened, other) => flattened. concat (other), [])
// => [4, 5, 2, 3, 0, 1] Im Gegensatz zum filter gibt diese Methode die Elemente der collection zurück, für die predicate keine Wahrheit zurückgibt.
Argumente:
@param iterable $collection Die Sammlung, über die iteriert werden soll.
@param callable $predicate Die pro Iteration aufgerufene Funktion.
Zurückkehren:
@return array das neue gefilterte Array.
Beispiel:
<?php
use function _ reject ;
$ users = [
[ ' user ' => ' barney ' , ' active ' => true ],
[ ' user ' => ' fred ' , ' active ' => false ]
]
reject ( $ users , ' active ' )
// => objects for ['fred'] Ruft die Größe der collection ab, indem ihre Länge für Array-Werte oder die Anzahl öffentlicher Eigenschaften für Objekte zurückgegeben wird.
Argumente:
@param (Array | Objekt | String) $collection Die zu überprüfende Sammlung.
Zurückkehren:
@return int Gibt die Sammlungsgröße zurück.
Beispiel:
<?php
use function _ size ;
size ([ 1 , 2 , 3 ]);
// => 3
size ( new class { public $ a = 1 ; public $ b = 2 ; private $ c = 3 ; });
// => 2
size ( ' pebbles ' );
// => 7 Überprüft, ob predicate für jedes Element der collection wahr ist. Die Iteration wird gestoppt, sobald predicate die Wahrheit zurückgibt. Das Prädikat wird mit drei Argumenten aufgerufen: (Wert, Index|Schlüssel, Sammlung).
Argumente:
@param iterable $collection Die Sammlung, über die iteriert werden soll.
@param (callable | string | array) $predicate Die pro Iteration aufgerufene Funktion.
Zurückkehren:
@return boolean Gibt true zurück, wenn ein Element die Prädikatprüfung besteht, andernfalls false .
Beispiel:
<?php
use function _ some ;
some ([ null , 0 , ' yes ' , false ], , function ( $ value ) { return is_bool ( $ value ); }));
// => true
$ users = [
[ ' user ' => ' barney ' , ' active ' => true ],
[ ' user ' => ' fred ' , ' active ' => false ]
];
// The `matches` iteratee shorthand.
some ( $ users , [ ' user ' => ' barney ' , ' active ' => false ]);
// => false
// The `matchesProperty` iteratee shorthand.
some ( $ users , [ ' active ' , false ]);
// => true
// The `property` iteratee shorthand.
some ( $ users , ' active ' );
// => trueErstellt ein Array von Elementen, sortiert in aufsteigender Reihenfolge nach den Ergebnissen der Ausführung jedes Elements in einer Sammlung durch jeden Iterierten. Diese Methode führt eine stabile Sortierung durch, d. h. sie behält die ursprüngliche Sortierreihenfolge gleicher Elemente bei. Die Iterationen werden mit einem Argument aufgerufen: (Wert).
Argumente:
@param (array | object | null) $collection Die Sammlung, über die iteriert werden soll.
@param (callable | callable[]) $iteratees Die Iteratees, nach denen sortiert werden soll.
Zurückkehren:
@return array Gibt das neue sortierte Array zurück.
Beispiel:
<?php
use function _ sortBy ;
$ users = [
[ ' user ' => ' fred ' , ' age ' => 48 ],
[ ' user ' => ' barney ' , ' age ' => 36 ],
[ ' user ' => ' fred ' , ' age ' => 40 ],
[ ' user ' => ' barney ' , ' age ' => 34 ],
];
sortBy ( $ users , [ function ( $ o ) { return $ o [ ' user ' ]; }]);
// => [['user' => 'barney', 'age' => 36], ['user' => 'barney', 'age' => 34], ['user' => 'fred', 'age' => 48], ['user' => 'fred', 'age' => 40]]
sortBy ( $ users , [ ' user ' , ' age ' ]);
// => [['user' => 'barney', 'age' => 34], ['user' => 'barney', 'age' => 36], ['user' => 'fred', 'age' => 40], ['user' => 'fred', 'age' => 48]] Ruft den Zeitstempel der Anzahl der Millisekunden ab, die seit der Unix-Epoche (1. Januar 1970, 00:00:00 UTC) vergangen sind.
Argumente:
Zurückkehren:
@return int Gibt den Zeitstempel zurück.
Beispiel:
<?php
use function _ now ;
now ();
// => 1511180325735 Das Gegenteil von before ; Diese Methode erstellt eine Funktion, die func aufruft, sobald sie n oder öfter aufgerufen wird.
Argumente:
@param int $n Die Anzahl der Aufrufe, bevor func aufgerufen wird.
@param Callable $func Die einzuschränkende Funktion.
Zurückkehren:
@return Callable Gibt die neue eingeschränkte Funktion zurück.
Beispiel:
<?php
use function _ after ;
$ saves = [ ' profile ' , ' settings ' ];
$ done = after ( count ( $ saves ), function () {
echo ' done saving! ' ;
});
forEach ( $ saves , function ( $ type ) use ( $ done ) {
asyncSave ([ ' type ' => $ type , ' complete ' => $ done ]);
});
// => Prints 'done saving!' after the two async saves have completed. Erstellt eine Funktion, die func mit bis zu n Argumenten aufruft und alle zusätzlichen Argumente ignoriert.
Argumente:
@param callable $func Die Funktion, für die Argumente begrenzt werden sollen.
@param int $n Die Aritätsobergrenze.
Zurückkehren:
@return Callable Gibt die neue begrenzte Funktion zurück.
Beispiel:
<?php
use function _ ary ;
map ([ ' 6 ' , ' 8 ' , ' 10 ' ], ary ( ' intval ' , 1 ));
// => [6, 8, 10] Erstellt eine Funktion, die func mit den Argumenten der erstellten Funktion aufruft, während sie weniger als n -mal aufgerufen wird. Nachfolgende Aufrufe der erstellten Funktion geben das Ergebnis des letzten func zurück.
Argumente:
@param int $n Die Anzahl der Aufrufe, bei denen func nicht mehr aufgerufen wird.
@param callable $func Die einzuschränkende Funktion.
Zurückkehren:
@return callable Gibt die neue eingeschränkte Funktion zurück.
Beispiel:
<?php
use function _ before ;
$ users = [ 1 , 2 , 3 , 4 , 5 , 6 , 7 , 8 , 9 , 10 ];
$ result = uniqBy ( map ( $ users , before ( 5 , [ $ repository , ' find ' ])), ' id ' )
// => Fetch up to 4 results. Erstellt eine Funktion, die func mit this Bindung von object und partials aufruft, die den empfangenen Argumenten vorangestellt werden.
Argumente:
@param aufrufbar $function Die zu bindende Funktion.
@param (object | Mixed) $object Die object von func .
@param array<int, Mixed> $partials Die Argumente, die teilweise angewendet werden sollen.
Zurückkehren:
@return callable Gibt die neue gebundene Funktion zurück.
Beispiel:
<?php
use function _ bind ;
function greet ( $ greeting , $ punctuation ) {
return $ greeting . ' ' . $ this -> user . $ punctuation ;
}
$ object = $ object = new class {
public $ user = ' fred ' ;
};
$ bound = bind ( ' greet ' , $ object , ' hi ' );
$ bound ( ' ! ' );
// => 'hi fred!' Erstellt eine Funktion, die die Methode $function von $object aufruft, wobei den empfangenen Argumenten $partials vorangestellt werden.
Diese Methode unterscheidet sich von bind dadurch, dass gebundene Funktionen auf Methoden verweisen können, die möglicherweise neu definiert werden oder noch nicht vorhanden sind
Argumente:
@param object $object Das Objekt, für das die Methode aufgerufen werden soll.
@param string $function Der Name der Methode.
@param array<int, Mixed> $partials Die Argumente, die teilweise angewendet werden sollen.
Zurückkehren:
@return callable Gibt die neue gebundene Funktion zurück.
Beispiel:
<?php
use function _ bindKey ;
$ object = new class {
private $ user = ' fred ' ;
function greet ( $ greeting , $ punctuation ) {
return $ greeting . ' ' . $ this -> user . $ punctuation ;
}
};
$ bound = bindKey ( $ object , ' greet ' , ' hi ' );
$ bound ( ' ! ' );
// => 'hi fred!' Erstellt eine Funktion, die Argumente von func akzeptiert, und ruft entweder func auf und gibt ihr Ergebnis zurück, wenn mindestens arity an Argumenten bereitgestellt wurde, oder gibt eine Funktion zurück, die die verbleibenden func -Argumente akzeptiert, und so weiter. Die Arität von func kann angegeben werden, wenn func.length nicht ausreicht.
Der _.curry.placeholder Wert, der in monolithischen Builds standardmäßig _ ist, kann als Platzhalter für bereitgestellte Argumente verwendet werden.
Hinweis: Diese Methode legt nicht die Eigenschaft „Länge“ von Curry-Funktionen fest.
Argumente:
@param callable $func Die Funktion zum Curry.
@param (int | null) $arity Die Arität von func .
Zurückkehren:
@return callable Gibt die neue Curry-Funktion zurück.
Beispiel:
<?php
use function _ curry ;
$ abc = function ( $ a , $ b , $ c ) {
return [ $ a , $ b , $ c ];
};
$ curried = curry ( $ abc );
$ curried ( 1 )( 2 )( 3 );
// => [1, 2, 3]
$ curried ( 1 , 2 )( 3 );
// => [1, 2, 3]
$ curried ( 1 , 2 , 3 );
// => [1, 2, 3]
// Curried with placeholders.
$ curried ( 1 )(_, 3 )( 2 );
// => [1, 2, 3] Ruft func nach wait von Millisekunden auf. Alle zusätzlichen Argumente werden für func bereitgestellt, wenn es aufgerufen wird.
Argumente:
@param callable $func Die zu verzögernde Funktion.
@param int $wait Die Anzahl der Millisekunden, um die der Aufruf verzögert wird.
@param array<int, gemischt> $args
Zurückkehren:
@return int die Timer-ID.
Beispiel:
<?php
use function _ delay ;
delay ( function ( $ text ) {
echo $ text ;
}, 1000 , ' later ' );
// => Echo 'later' after one second. Erstellt eine Funktion, die func mit umgekehrten Argumenten aufruft.
Argumente:
@param callable $func Die Funktion, für die Argumente umgedreht werden sollen.
Zurückkehren:
@return callable Gibt die neue umgedrehte Funktion zurück.
Beispiel:
<?php
use function _ flip ;
$ flipped = flip ( function () {
return func_get_args ();
});
flipped ( ' a ' , ' b ' , ' c ' , ' d ' );
// => ['d', 'c', 'b', 'a'] Erstellt eine Funktion, die das Ergebnis von func speichert. Wenn resolver bereitgestellt wird, bestimmt er den Cache-Schlüssel zum Speichern des Ergebnisses basierend auf den Argumenten, die der gespeicherten Funktion bereitgestellt werden. Standardmäßig wird das erste der gespeicherten Funktion bereitgestellte Argument als Karten-Cache-Schlüssel verwendet
Hinweis: Der Cache wird als cache Eigenschaft der gespeicherten Funktion verfügbar gemacht. Seine Erstellung kann angepasst werden, indem der _.memoize.Cache Konstruktor durch einen ersetzt wird, dessen Instanzen die Map Methodenschnittstelle von clear , delete , get , has und set implementieren.
Argumente:
@param callable $func Die Funktion, deren Ausgabe gespeichert werden soll.
@param (callable | null) $resolver Die Funktion zum Auflösen des Cache-Schlüssels.
Zurückkehren:
@return callable Gibt die neue gespeicherte Funktion zurück.
Beispiel:
<?php
use function _ memoize ;
$ object = [ ' a ' => 1 , ' b ' => 2 ];
$ other = [ ' c ' => 3 , ' d ' => 4 ];
$ values = memoize ( ' _values ' );
$ values ( $ object );
// => [1, 2]
$ values ( $ other );
// => [3, 4]
$ object [ ' a ' ] = 2 ;
$ values ( $ object );
// => [1, 2]
// Modify the result cache.
$ values -> cache -> set ( $ object , [ ' a ' , ' b ' ]);
$ values ( $ object );
// => ['a', 'b'] Erstellt eine Funktion, die das Ergebnis des Prädikats func negiert
Argumente:
@param callable $predicate Das zu negierende Prädikat.
Zurückkehren:
@return callable Gibt die neue negierte Funktion zurück.
Beispiel:
<?php
use function _ negate ;
function isEven ( $ n ) {
return $ n % 2 == 0 ;
}
filter ([ 1 , 2 , 3 , 4 , 5 , 6 ], negate ( $ isEven ));
// => [1, 3, 5] Erstellt eine Funktion, die auf den einmaligen Aufruf func beschränkt ist. Wiederholte Aufrufe der Funktion geben den Wert des ersten Aufrufs zurück. Die func wird mit den Argumenten der erstellten Funktion aufgerufen.
Argumente:
@param callable $func Die einzuschränkende Funktion.
Zurückkehren:
@return ruft die neue eingeschränkte Funktion auf.
Beispiel:
<?php
use function _ once ;
$ initialize = once ( ' createApplication ' );
$ initialize ();
$ initialize ();
// => `createApplication` is invoked once Erstellt eine Funktion, die func mit transformierten Argumenten aufruft.
Argumente:
@param callable $func Die Funktion, die umbrochen werden soll.
@param callable[] $transforms Das Argument transformiert.
Zurückkehren:
@return ruft die neue Funktion auf.
Beispiel:
<?php
use function _ overArgs ;
function doubled ( $ n ) {
return $ n * 2 ;
}
function square ( $ n ) {
return $ n * $ n ;
}
$ func = overArgs ( function ( $ x , $ y ) {
return [ $ x , $ y ];
}, [ ' square ' , ' doubled ' ]);
$ func ( 9 , 3 );
// => [81, 6]
$ func ( 10 , 5 );
// => [100, 10] Erstellt eine Funktion, die func aufruft, wobei den empfangenen Argumenten partials vorangestellt werden.
Argumente:
@param aufrufbar $func Die Funktion, auf die Argumente teilweise angewendet werden sollen.
@param array<int, Mixed> $partials Die Argumente, die teilweise angewendet werden sollen.
Zurückkehren:
@return callable Gibt die neue teilweise angewendete Funktion zurück.
Beispiel:
<?php
use function _ partial ;
function greet ( $ greeting , $ name ) {
return $ greeting . ' ' . $ name ;
}
$ sayHelloTo = partial ( ' greet ' , ' hello ' );
$ sayHelloTo ( ' fred ' );
// => 'hello fred' Erstellt eine Funktion, die func mit this Bindung der erstellten Funktion und Argumente von start und darüber hinaus als Array aufruft.
Argumente:
@param Callable $ func Die Funktion zum Anwenden eines REST -Parameters auf.
@param (int | null) $ Start Die Startposition des Restparameters.
Zurückkehren:
@Return Callable gibt die neue Funktion zurück.
Beispiel:
<?php
use function _ rest ;
$ say = rest ( function ( $ what , $ names ) {
return $ what . ' ' . implode ( ' , ' , initial ( $ names )) .
( size ( $ names ) > 1 ? ' , & ' : '' ) . last ( $ names );
});
$ say ( ' hello ' , ' fred ' , ' barney ' , ' pebbles ' );
// => 'hello fred, barney, & pebbles' Erstellt eine Funktion, die func mit der Bindung der this der Funktion erstellen und eine Argumente von Argumenten ähnlich wie Function#apply .
Hinweis: Diese Methode basiert auf dem Spread -Operator.
Argumente:
@param Callable $ func die Funktion, um Argumente zu verbreiten.
@param int $ starten Sie die Startposition des Spread.
Zurückkehren:
@Return Callable gibt die neue Funktion zurück.
Beispiel:
<?php
use function _ spread ;
$ say = spread ( function ( $ who , $ what ) {
return $ who . ' says ' . $ what ;
});
$ say ([ ' fred ' , ' hello ' ]);
// => 'fred says hello'Erstellt eine Funktion, die bis zu einem Argument akzeptiert und zusätzliche Argumente ignoriert.
Argumente:
@Param Callable $ func Die Funktion, für die Argumente begrenzt werden.
Zurückkehren:
@Return Callable Die neue Kapitalfunktion.
Beispiel:
<?php
use function _ unary ;
map ([ ' 6 ' , ' 8 ' , ' 10 ' ], unary ( ' intval ' ));
// => [6, 8, 10] Erstellt eine Funktion, die als erstes Argument value für wrapper bietet. Alle zusätzlichen Argumente, die der Funktion vorgelegt werden, werden an diejenigen angehängt, die der wrapper zur Verfügung gestellt werden.
Argumente:
@param gemischt $ Wert Der Wert für Wrap.
@param Callable $ Wrapper Die Wrapper -Funktion.
Zurückkehren:
@RETURN CALLABLE Die neue Funktion.
Beispiel:
<?php
use function _ wrap ;
$ p = wrap ( ' _escape ' , function ( $ func , $ text ) {
return ' <p> ' . $ func ( $ text ) . ' </p> ' ;
});
$ p ( ' fred, barney, & pebbles ' );
// => '<p>fred, barney, & pebbles</p>' Führt einen Vergleich zwischen zwei Werten durch, um festzustellen, ob sie gleichwertig sind.
Argumente:
@param gemischt $ Wert Der zu vergleichen.
@param mischte $ Other den anderen Wert zu vergleichen.
Zurückkehren:
@return boolean gibt true zurück, wenn die Werte äquivalent, sonst false sind.
Beispiel:
<?php
use function _ eq ;
$ object = ( object ) [ ' a ' => 1 ];
$ other = ( object ) [ ' a ' => 1 ];
eq ( $ object , $ object );
// => true
eq ( $ object , $ other );
// => false
eq ( ' a ' , ' a ' );
// => true
eq ([ ' a ' ], ( object ) [ ' a ' ]);
// => false
eq ( INF , INF );
// => trueFührt einen tiefen Vergleich zwischen zwei Werten durch, um festzustellen, ob sie gleichwertig sind.
Hinweis: Diese Methode unterstützt den Vergleich von Arrays, Booleschen, DateTime -Objekten, Ausnahmebobjekten, SprubjectStorage, Zahlen, Zeichenfolgen, typisierten Arrays, Ressourcen und DOM -Knoten. Objekte werden von ihren eigenen, nicht ererbten, aufzählbaren Eigenschaften verglichen.
Argumente:
@param gemischt $ Wert Der zu vergleichen.
@param mischte $ Other den anderen Wert zu vergleichen.
Zurückkehren:
@return bool gibt true zurück, wenn die Werte äquivalent, sonst false sind.
Beispiel:
<?php
use function _ isEqual ;
$ object = [ ' a ' => 1 ]
$ other = [ ' a ' => ' 1 ' ]
isEqual ( $ object , $ other )
// => true
$ object === $ other
// => false Überprüft, ob value eine Exception ist, ParseError , Fehler , Throwable , soaPfault , DOMException , pdoException`, Objekt.
Argumente:
@param gemischt $ Wert Der Wert, der überprüft wird.
Zurückkehren:
@return boolean gibt true zurück, wenn value ein Fehlerobjekt ist, sonst false .
Beispiel:
<?php
use function _ isError ;
isError ( new Exception ())
// => true
isError (Exception::Class)
// => false Fügt zwei Zahlen hinzu.
Argumente:
@param (int | float | String) $ Augend Die erste Nummer in einem Zusatz.
@param (int | float | string) $ fördern Sie die zweite Nummer in einer Addition.
Zurückkehren:
@Return (int | float) gibt die Gesamtsumme zurück.
Beispiel:
<?php
use function _ add ;
add ( 6 , 4 );
// => 10 Berechnet den Maximalwert des array . Wenn array leer oder falsch ist, wird Null zurückgegeben.
Argumente:
@Param (Array | null) $ Array Das Array zum ITRAGE.
Zurückkehren:
@Return (int | null) gibt den Maximalwert zurück.
Beispiel:
<?php
use function _ max ;
max ([ 4 , 2 , 8 , 6 ]);
// => 8
max ([]);
// => null Diese Methode ist wie max , außer dass sie iteratee akzeptiert, das für jedes Element in array aufgerufen wird, um das Kriterium zu erzeugen, nach dem der Wert eingestuft wird. Der Iteratee wird mit einem Argument angerufen: (Wert).
Argumente:
@Param Array $ Array das Array zum ITRAD.
@param (Callable
Zurückkehren:
@Return Mixed gibt den Maximalwert zurück.
Beispiel:
<?php
use function _ maxBy ;
$ objects = [[ ' n ' => 1 ], [ ' n ' => 2 ]];
maxBy ( $ objects , function ( $ o ) { return $ o [ ' n ' ]; });
// => ['n' => 2]
// The `property` iteratee shorthand.
maxBy ( $ objects , ' n ' );
// => ['n' => 2] number innerhalb der inklusiven lower und upper Grenzen.
Argumente:
@param int $ number die nummer an klemm.
@Param int $ niedriger die untere Grenze.
@param int $ obere der oberen Grenze.
Zurückkehren:
@Return Int gibt die geklemmte Nummer zurück.
Beispiel:
<?php
use function _ clamp ;
clamp (- 10 , - 5 , 5 )
// => -5
clamp ( 10 , - 5 , 5 )
// => 5 Überprüft, ob number zwischen start und bis zu, aber nicht einbezogen ist, end . Wenn end nicht angegeben ist, ist es so eingestellt, dass es mit start start und dann auf 0 gesetzt wird. Wenn start größer ist als end werden die Parameter ausgetauscht, um negative Bereiche zu unterstützen.
Argumente:
@param float $ nummer die zu prüfende Nummer.
@param float $ starten Sie den Start des Bereichs.
@param float $ End am Ende des Bereichs.
Zurückkehren:
@return boolean kehrt true zurück, wenn number im Bereich liegt, sonst false .
Beispiel:
<?php
use function _ inRange ;
inRange ( 3 , 2 , 4 )
// => true
inRange ( 4 , 8 )
// => true
inRange ( 4 , 2 )
// => false
inRange ( 2 , 2 )
// => false
inRange ( 1.2 , 2 )
// => true
inRange ( 5.2 , 4 )
// => false
inRange (- 3 , - 2 , - 6 )
// => true Erzeugt eine zufällige Zahl zwischen den inklusiven lower und upper Grenzen. Wenn nur ein Argument zwischen 0 und die angegebene Zahl zurückgegeben wird. Wenn floating true ist oder lower oder upper Schwimmkörper sind, wird eine Schwimmpunktzahl anstelle einer Ganzzahl zurückgegeben.
Argumente:
@Param (int | float | bool) $ niedriger die untere Grenze.
@param (int | float | bool) $ obere der oberen Grenze.
@param (bool | null) $ floating angeben, um eine schwimmende Punktnummer zurückzugeben.
Zurückkehren:
@Return (int | float) gibt die Zufallszahl zurück.
Beispiel:
<?php
use function _ random ;
random ( 0 , 5 )
// => an integer between 0 and 5
random ( 5 )
// => also an integer between 0 and 5
random ( 5 , true )
// => a floating-point number between 0 and 5
random ( 1.2 , 5.2 )
// => a floating-point number between 1.2 and 5.2 Ruft den Wert auf Pfad des Objekts ab. Wenn der aufgelöste Wert null ist, wird der Standardwert an seiner Stelle zurückgegeben.
Argumente:
@param gemischt $ Objekt Das assoziative Array oder Objekt, um den Wert aus zu holen
@param (Array | String) $ Path Dot getrennt oder Array der Zeichenfolge
@param gemischt $ defaultValue (optional) Der Wert für ungelöste oder Nullwerte.
Zurückkehren:
@Return Mixed gibt den gelösten Wert zurück.
Beispiel:
<?php
use function _ get ;
$ sampleArray = [ " key1 " => [ " key2 " => [ " key3 " => " val1 " , " key4 " => "" ]]];
get ( $ sampleArray , ' key1.key2.key3 ' );
// => "val1"
get ( $ sampleArray , ' key1.key2.key5 ' , " default " );
// => "default"
get ( $ sampleArray , ' key1.key2.key4 ' , " default " );
// => "" Erstellt ein Objekt, das aus den ausgewählten object besteht.
Argumente:
@param Object $ Objekt Das Quellobjekt.
@Param (String | String []) $ $ PATHS Die Eigenschaftspfade zu wählen.
Zurückkehren:
@Return stdClass gibt das neue Objekt zurück.
Beispiel:
<?php
use function _ pick ;
$ object = ( object ) [ ' a ' => 1 , ' b ' => ' 2 ' , ' c ' => 3 ];
pick ( $ object , [ ' a ' , ' c ' ]);
// => (object) ['a' => 1, 'c' => 3] Erstellt ein Objekt, das aus den object besteht, predicate Returns Returyy für. Das Prädikat wird mit zwei Argumenten aufgerufen: (Wert, Schlüssel).
Argumente:
@param (Objekt | null) $ Objekt Das Quellobjekt.
@param Callable $ Predicate Die pro Eigenschaft aufgerufene Funktion.
Zurückkehren:
@Return stdClass gibt das neue Objekt zurück.
Beispiel:
<?php
use function _ pickBy ;
$ object = ( object ) [ ' a ' => 1 , ' b ' => ' abc ' , ' c ' => 3 ];
pickBy (object, ' is_numeric ' );
// => (object) ['a' => 1, 'c' => 3] Erstellt eine lodash -Wrapper -Instanz, die value mit expliziten Methodenkettensequenzen verzieht. Das Ergebnis solcher Sequenzen muss mit ->value() ausgepackt werden.
Argumente:
@param gemischt $ Wert Der Wert für Wrap.
Zurückkehren:
@Return _ Gibt die neue lodash -Wrapper -Instanz zurück.
Beispiel:
<?php
use function _ chain ;
$ users = [
[ ' user ' => ' barney ' , ' age ' => 36 ],
[ ' user ' => ' fred ' , ' age ' => 40 ],
[ ' user ' => ' pebbles ' , ' age ' => 1 ],
];
$ youngest = chain ( $ users )
-> sortBy ( ' age ' )
-> map ( function ( $ o ) {
return $ o [ ' user ' ] . ' is ' . $ o [ ' age ' ];
})
-> head ()
-> value ();
// => 'pebbles is 1' Konvertiert string in Kamelkoffer.
Argumente:
@Param String $ String Die String, die konvertiert werden soll.
Zurückkehren:
@Return String gibt die Kamel -Gehäuse -Zeichenfolge zurück.
Beispiel:
<?php
use function _ camelCase ;
camelCase ( ' Foo Bar ' )
// => 'fooBar'
camelCase ( ' --foo-bar-- ' )
// => 'fooBar'
camelCase ( ' __FOO_BAR__ ' )
// => 'fooBar' Konvertiert das erste Zeichen der string in den oberen Fall und den verbleibenden Fall in den unteren Fall.
Argumente:
@Param String $ String Die Zeichenfolge, die zum Kapitalisieren ist.
Zurückkehren:
@Return String gibt die kapitalisierte Zeichenfolge zurück.
Beispiel:
<?php
use function _ capitalize ;
capitalize ( ' FRED ' )
// => 'Fred' Deburrs string durch Konvertieren [Latin-1-Supplement] (https => // en.wikipedia.org/wiki/latin-1_supplement_(unicode_block)#character_table) und [latein Extended-A] (https => // en.wikipedia. org/wiki/latin_extended-a) Buchstaben an grundlegende lateinische Buchstaben und Entfernen von [kombinierten diakritischen Markierungen] (https => // en.wikipedia.org/wiki/combining_diacritical_marks).
Argumente:
@param String $ String den String zu Deburr.
Zurückkehren:
@Return String gibt den Deburred String zurück.
Beispiel:
<?php
use function _ deburr ;
deburr ( ' déjà vu ' )
// => 'deja vu' Überprüft, ob string mit der angegebenen Zielzeichenfolge endet.
Argumente:
@param String $ String Die Zeichenfolge, die inspiziert wird.
@Param String $ $ zielen Sie auf den String ab, nach dem Sie suchen sollen.
@Param int $ Die Position zu suchen.
Zurückkehren:
@return boolean kehrt true zurück, wenn string mit target endet, sonst false .
Beispiel:
<?php
use function _ endsWith ;
endsWith ( ' abc ' , ' c ' )
// => true
endsWith ( ' abc ' , ' b ' )
// => false
endsWith ( ' abc ' , ' b ' , 2 )
// => true Konvertiert die Zeichen "&", "<", ">", "" und "" in string in ihre entsprechenden HTML -Entitäten.
Obwohl der ">" -Scharakter für Symmetrie entkommen ist, müssen Zeichen wie ">" und "/" nicht in HTML entkommen und haben keine besondere Bedeutung, es sei denn, sie sind Teil eines Tags oder einem nicht zahlreichen Attributwert. Weitere Informationen finden Sie unter den Artikel von Mathias Bynens (unter "Semi-bezogene Fakten").
Bei der Arbeit mit HTML sollten Sie immer Attributwerte zitieren, um XSS -Vektoren zu reduzieren.
Argumente:
@param String $ String Die String, um zu entkommen.
Zurückkehren:
@Return String gibt die entkommene Zeichenfolge zurück.
Beispiel:
<?php
use function _ escape ;
escape ( ' fred, barney, & pebbles ' )
// => 'fred, barney, & pebbles' Entgeht den RegExp -Sonderzeichen "^", "$", ",", ".", "*", "+", "?", "(", ")", "[", "]", "{ ","} "und" | " in string .
Argumente:
@param String $ String Die String, um zu entkommen.
Zurückkehren:
@Return String gibt die entkommene Zeichenfolge zurück.
Beispiel:
<?php
use function _ escapeRegExp ;
escapeRegExp ( ' [lodash](https://lodash.com/) ' )
// => '[lodash](https://lodash.com/)' Konvertiert string in Kebab Case.
Argumente:
@Param String $ String Die String, die konvertiert werden soll.
Zurückkehren:
@Return String gibt die Kebab -Kabinen -Zeichenfolge zurück.
Beispiel:
<?php
use function _ kebabCase ;
kebabCase ( ' Foo Bar ' )
// => 'foo-bar'
kebabCase ( ' fooBar ' )
// => 'foo-bar'
kebabCase ( ' __FOO_BAR__ ' )
// => 'foo-bar' Konvertiert string , als Raum trennte Wörter in den Fall.
Argumente:
@Param String $ String Die String, die konvertiert werden soll.
Zurückkehren:
@Return String gibt die Zeichenfolge mit unterer Gehäuse zurück.
Beispiel:
<?php
use function _ lowerCase ;
lowerCase ( ' --Foo-Bar-- ' )
// => 'foo bar'
lowerCase ( ' fooBar ' )
// => 'foo bar'
lowerCase ( ' __FOO_BAR__ ' )
// => 'foo bar' Konvertiert das erste Zeichen der string in den niedrigeren Fall.
Argumente:
@Param String $ String Die String, die konvertiert werden soll.
Zurückkehren:
@Return String gibt die konvertierte Zeichenfolge zurück.
Beispiel:
<?php
use function _ lowerFirst ;
lowerFirst ( ' Fred ' )
// => 'fred'
lowerFirst ( ' FRED ' )
// => 'fRED' Pads string auf der linken und rechten Seite, wenn es kürzer als length ist. Padding -Charaktere werden abgeschnitten, wenn sie nicht gleichmäßig durch length geteilt werden können.
Argumente:
@param String $ String Die Zeichenfolge zu Pad.
@param int $ Länge die Polsterlänge.
@param String $ chars Die als Polster verwendete Zeichenfolge.
Zurückkehren:
@Return String gibt die gepolsterte Zeichenfolge zurück.
Beispiel:
<?php
use function _ pad ;
pad ( ' abc ' , 8 )
// => ' abc '
pad ( ' abc ' , 8 , ' _- ' )
// => '_-abc_-_'
pad ( ' abc ' , 2 )
// => 'abc' Pads string auf der rechten Seite, wenn es kürzer als length ist. Padding -Zeichen werden abgeschnitten, wenn sie length überschreiten.
Argumente:
@param String $ String Die Zeichenfolge zu Pad.
@param int $ Länge die Polsterlänge.
@param String $ chars Die als Polster verwendete Zeichenfolge.
Zurückkehren:
@Return String gibt die gepolsterte Zeichenfolge zurück.
Beispiel:
<?php
use function _ padEnd ;
padEnd ( ' abc ' , 6 )
// => 'abc '
padEnd ( ' abc ' , 6 , ' _- ' )
// => 'abc_-_'
padEnd ( ' abc ' , 2 )
// => 'abc' Pads string auf der linken Seite, wenn es kürzer als length ist. Padding -Zeichen werden abgeschnitten, wenn sie length überschreiten.
s Argumente:
@param String $ String = '' Die Zeichenfolge zu Pad.
@param int $ Länge die Polsterlänge.
@param String $ chars Die als Polster verwendete Zeichenfolge.
Zurückkehren:
@Return String gibt die gepolsterte Zeichenfolge zurück.
Beispiel:
<?php
use function _ padStart ;
padStart ( ' abc ' , 6 )
// => ' abc'
padStart ( ' abc ' , 6 , ' _- ' )
// => '_-_abc'
padStart ( ' abc ' , 2 )
// => 'abc' Konvertiert string in eine Ganzzahl des angegebenen Radix. Wenn radix undefined oder 0 ist, wird ein radix von 10 verwendet, es sei denn, string ist ein Hexadezimal. In diesem Fall wird ein radix von 16 verwendet.
HINWEIS: Diese Methode verwendet das integrierte Ganzzahl-Casting von PHP, was nicht unbedingt mit der ES5-Implementierung von parseInt übereinstimmt.
Argumente:
@param (int | float | String) $ String Die zu konvertige Zeichenfolge.
@param int $ radix Der Radix zu interpretieren string von.
Zurückkehren:
@Return Int gibt die konvertierte Ganzzahl zurück.
Beispiel:
<?php
use function _ parseInt ;
parseInt ( ' 08 ' )
// => 8 Wiederholt die angegebene Zeichenfolge n mal.
Argumente:
@param String $ String Die zu wiederholende Zeichenfolge.
@param int $ n Die Anzahl der Male, um die Zeichenfolge zu wiederholen.
Zurückkehren:
@Return String gibt die wiederholte Zeichenfolge zurück.
Beispiel:
<?php
use function _ repeat ;
repeat ( ' * ' , 3 )
// => '***'
repeat ( ' abc ' , 2 )
// => 'abcabc'
repeat ( ' abc ' , 0 )
// => '' Ersetzt Übereinstimmungen für pattern in string durch replacement .
Hinweis: Diese Methode basiert auf String#replace .
Argumente:
@param String $ String Die zu ändernde Zeichenfolge.
@param String $ Muster Das zu ersetzende Muster.
@param (Callable | String) $ Ersatz Der Ersatz für Übereinstimmungen.
Zurückkehren:
@Return String gibt die modifizierte Zeichenfolge zurück.
Beispiel:
<?php
use function _ replace ;
replace ( ' Hi Fred ' , ' Fred ' , ' Barney ' )
// => 'Hi Barney' Konvertiert string in Schlangenkoffer.
Argumente:
@Param String $ String Die String, die konvertiert werden soll.
Zurückkehren:
@Return String gibt die Saite mit Schlangenhülle zurück.
Beispiel:
<?php
use function _ snakeCase ;
snakeCase ( ' Foo Bar ' )
// => 'foo_bar'
snakeCase ( ' fooBar ' )
// => 'foo_bar'
snakeCase ( ' --FOO-BAR-- ' )
// => 'foo_bar' string durch separator .
Hinweis: Diese Methode basiert auf String#split .
Argumente:
@Param String $ String Die String zu teilen.
@Param String $ Separator Das Trennzeichen -Muster zu teilen.
@param int $ begrenzen die Länge, um die Ergebnisse abzuschneiden.
Zurückkehren:
@Return Array gibt die String -Segmente zurück.
Beispiel:
<?php
use function _ split ;
split ( ' a-b-c ' , ' - ' , 2 )
// => ['a', 'b'] Konvertiert string , um den Fall zu starten.
Argumente:
@Param String $ String Die String, die konvertiert werden soll.
Zurückkehren:
@Return String gibt die Startscheide -Zeichenfolge zurück.
Beispiel:
<?php
use function _ startCase ;
startCase ( ' --foo-bar-- ' )
// => 'Foo Bar'
startCase ( ' fooBar ' )
// => 'Foo Bar'
startCase ( ' __FOO_BAR__ ' )
// => 'FOO BAR' Überprüft, ob string mit der angegebenen Zielzeichenfolge beginnt.
Argumente:
@param String $ String Die Zeichenfolge, die inspiziert wird.
@Param String $ $ zielen Sie auf den String ab, nach dem Sie suchen sollen.
@Param int $ Die Position zu suchen.
Zurückkehren:
@return boolean kehrt true zurück, wenn string mit target beginnt, sonst false .
Beispiel:
<?php
use function _ startsWith ;
startsWith ( ' abc ' , ' a ' )
// => true
startsWith ( ' abc ' , ' b ' )
// => false
startsWith ( ' abc ' , ' b ' , 1 )
// => true Erstellt eine kompilierte Template-Funktion, die Dateneigenschaften in "Interpolieren" -Ergrenzwerte, html-Eskape-interpolierte Dateneigenschaften in "Escape" -Ergrenzwerten interpolieren und PHP in "Evaluieren" -Delimitern ausführen kann. Dateneigenschaften können als kostenlose Variablen in der Vorlage zugegriffen werden. Wenn ein Einstellungsobjekt angegeben wird, hat es Vorrang vor $templateSettings .
Regexp $ options ['Escape'] = _ :: $ templatesettings ['Escape'] Die html "Escape" -Kräfte. Regexp $ options ['evaluate'] = _ :: $ templatesettings ['evaluate'] Der Abgrenzer "evaluate". Array $ options ['Imports'] = _ :: $ templatesettings ['Imports'] Ein Objekt, das als freie Variablen in die Vorlage importiert werden kann. Regexp $ options ['interpolieren'] = _ :: $ templatesettings ['interpolieren'] Der Trennzeichen "Interpolat".
Argumente:
@param String $ String Die Vorlagenzeichenfolge.
@param Array $ option Das Options -Array.
Zurückkehren:
@Return Callable gibt die kompilierte Vorlagenfunktion zurück.
Beispiel:
<?php
use function _ template ;
// Use the "interpolate" delimiter to create a compiled template.
$ compiled = template ( ' hello <%= user %>! ' )
$ compiled ([ ' user ' => ' fred ' ])
// => 'hello fred!'
// Use the HTML "escape" delimiter to escape data property values.
$ compiled = template ( ' <b><%- value %></b> ' )
$ compiled ([ ' value ' => ' <script> ' ])
// => '<b><script></b>'
// Use the "evaluate" delimiter to execute JavaScript and generate HTML.
$ compiled = template ( ' <% foreach($users as $user) { %><li><%- user %></li><% }%> ' )
$ compiled ([ ' users ' => [ ' fred ' , ' barney ' ] ])
// => '<li>fred</li><li>barney</li>'
// Use the internal `print` function in "evaluate" delimiters.
$ compiled = template ( ' <% print("hello " + $user)%>! ' )
$ compiled ([ ' user ' => ' barney ' ])
// => 'hello barney!'
// Use backslashes to treat delimiters as plain text.
$ compiled = template ( ' <%= " \ <%- value % \ >" %> ' )
$ compiled ([ ' value ' => ' ignored ' ])
// => '<%- value %>'
// Use the `imports` option to import functions or classes with aliases.
$ text = ' <% all($users, function($user) { %><li><%- user %></li><% })%> '
$ compiled = template( $ text , { ' imports ' : { ' _each ' : ' all ' } })
$ compiled ([ ' users ' => [ ' fred ' , ' barney ' ] ])
// => '<li>fred</li><li>barney</li>'
// Use custom template delimiters.
_:: $ templateSettings [ ' interpolate ' ] = ' {{([sS]+?)}} '
$ compiled = template ( ' hello {{ user }}! ' )
$ compiled ([ ' user ' => ' mustache ' ])
// => 'hello mustache!'
// Use the `source` property to access the compiled source of the template
template ( $ mainText )-> source ; Konvertiert string als Ganzes in den Fall
Argumente:
@Param String $ String Die String, die konvertiert werden soll.
Zurückkehren:
@Return String gibt die Zeichenfolge mit unterer Gehäuse zurück.
Beispiel:
<?php
use function _ toLower ;
toLower ( ' --Foo-Bar-- ' )
// => '--foo-bar--'
toLower ( ' fooBar ' )
// => 'foobar'
toLower ( ' __FOO_BAR__ ' )
// => '__foo_bar__' Konvertiert string als Ganzes in den oberen Fall
Argumente:
@Param String $ String Die String, die konvertiert werden soll.
Zurückkehren:
@Return String gibt die String der oberen Gehäuse zurück.
Beispiel:
<?php
use function _ toUpper ;
toUpper ( ' --foo-bar-- ' )
// => '--FOO-BAR--'
toUpper ( ' fooBar ' )
// => 'FOOBAR'
toUpper ( ' __foo_bar__ ' )
// => '__FOO_BAR__' Entfernt die Führung und Verlauf von Whitespace oder angegebenen Zeichen aus string .
Argumente:
@param String $ String Die Zeichenfolge, die zu trimmen ist.
@Param String $ chars die Zeichen zum Trimmen.
Zurückkehren:
@Return String gibt die abgeschnittene Zeichenfolge zurück.
Beispiel:
<?php
use function _ trim ;
trim ( ' abc ' )
// => 'abc'
trim ( ' -_-abc-_- ' , ' _- ' )
// => 'abc' Entfernt nachverfolgung mit Whitespace oder angegebenen Zeichen aus string .
Argumente:
@param String $ String Die Zeichenfolge, die zu trimmen ist.
@Param String $ chars die Zeichen zum Trimmen.
Zurückkehren:
@Return String gibt die abgeschnittene Zeichenfolge zurück.
Beispiel:
<?php
use function _ trimEnd ;
trimEnd ( ' abc ' )
// => ' abc'
trimEnd ( ' -_-abc-_- ' , ' _- ' )
// => '-_-abc' Entfernt führende Weiße oder angegebene Zeichen aus string .
Argumente:
@param String $ String Die Zeichenfolge, die zu trimmen ist.
@Param String $ chars die Zeichen zum Trimmen.
Zurückkehren:
@Return String gibt die abgeschnittene Zeichenfolge zurück.
Beispiel:
<?php
use function _ trimStart ;
trimStart ( ' abc ' )
// => 'abc '
trimStart ( ' -_-abc-_- ' , ' _- ' )
// => 'abc-_-' String string wenn sie länger als die angegebene maximale Zeichenfolgelänge ist. Die letzten Zeichen der abgeschnittenen Zeichenfolge werden durch die Auslassungszeichenfolge ersetzt, die standardmäßig "..." standhält.
Länge = 30 Die maximale Saitenlänge. OMIENDE = '...' Die Zeichenfolge, um den Text anzuzeigen, wird weggelassen. Separator das Trennmuster zum Abschneiden.
Argumente:
@Param String $ String Die Zeichenfolge, die abschneidet.
@param Array $ option Das Optionsobjekt.
Zurückkehren:
@Return String gibt die verkürzte Zeichenfolge zurück.
Beispiel:
<?php
use function _ truncate ;
truncate ( ' hi-diddly-ho there, neighborino ' )
// => 'hi-diddly-ho there, neighbo...'
truncate ( ' hi-diddly-ho there, neighborino ' , [
' length ' => 24 ,
' separator ' => ' '
])
// => 'hi-diddly-ho there,...'
truncate ( ' hi-diddly-ho there, neighborino ' , [
' length ' => 24 ,
' separator ' => ' /,? +/ '
])
// => 'hi-diddly-ho there...'
truncate ( ' hi-diddly-ho there, neighborino ' , [
' omission ' => ' [...] '
])
// => 'hi-diddly-ho there, neig [...]' Die escape dieser Methode wandelt die HTML -Entitäten & , < , > , " und ' in string zu ihren entsprechenden Zeichen.
Argumente:
@Param String $ String die Zeichenfolge zu Undecape.
Zurückkehren:
@Return String gibt die nicht entzündete Zeichenfolge zurück.
Beispiel:
<?php
use function _ unescape ;
unescape ( ' fred, barney, & pebbles ' )
// => 'fred, barney, & pebbles' Konvertiert string als Raum, als der Raum getrennte Wörter in den oberen Fall.
Argumente:
@Param String $ String Die String, die konvertiert werden soll.
Zurückkehren:
@Return String gibt die String der oberen Gehäuse zurück.
Beispiel:
<?php
use function _ upperCase ;
upperCase ( ' --foo-bar ' )
// => 'FOO BAR'
upperCase ( ' fooBar ' )
// => 'FOO BAR'
upperCase ( ' __foo_bar__ ' )
// => 'FOO BAR' Konvertiert das erste Zeichen der string in den oberen Fall.
Argumente:
@Param String $ String Die String, die konvertiert werden soll.
Zurückkehren:
@Return String gibt die konvertierte Zeichenfolge zurück.
Beispiel:
<?php
use function _ upperFirst ;
upperFirst ( ' fred ' )
// => 'Fred'
upperFirst ( ' FRED ' )
// => 'FRED' string in ein Array seiner Worte.
Argumente:
@param String $ String Die Zeichenfolge, die inspiziert wird.
@Param String $ Muster Das Muster für die Übereinstimmung mit Wörtern.
Zurückkehren:
@Return Array gibt die Zeichenfolge der string zurück.
Beispiel:
<?php
use function _ words ;
words ( ' fred, barney, & pebbles ' )
// => ['fred', 'barney', 'pebbles']
words ( ' fred, barney, & pebbles ' , ' /[^, ]+/g ' )
// => ['fred', 'barney', '&', 'pebbles'] Versuche, func aufzurufen und entweder das Ergebnis oder das gefangene Fehlerobjekt zurückzugeben. Alle zusätzlichen Argumente werden dem func zur Verfügung gestellt, wenn es aufgerufen wird.
s Argumente:
@Param Callable $ func Die Funktion zu versuchen.
@Param Array <int, gemischt> $ args die Argumente, mit denen func aufzurufen habe.
Zurückkehren:
@Return (gemischt | Throwable) Gibt das func -Ergebnis- oder Fehlerobjekt zurück.
Beispiel:
<?php
use function _ attempt ;
// Avoid throwing errors for invalid PDO data source.
$ elements = attempt ( function () {
new PDO ( null );
});
if ( isError ( $ elements )) {
$ elements = [];
}Überprüft den Wert, um festzustellen, ob ein Standardwert an seiner Stelle zurückgegeben werden sollte. Der Standardwert wird zurückgegeben, wenn Wert Nan oder Null ist.
Argumente:
@param gemischt $ Wert beliebiger Wert.
@param gemischt $ defaultValue -Wert zur Rückgabe, wenn $ value null oder nan ist
Zurückkehren:
@return gemischt zurückgegebener value .
Beispiel:
<?php
use function _ defaultTo ;
$ a = null ;
defaultTo ( $ a , " default " );
// => "default"
$ a = " x " ;
defaultTo ( $ a , " default " );
// => "x"Diese Methode gibt das erste Argument zurück, das es empfängt.
Argumente:
@param gemischt $ Wert beliebiger Wert.
Zurückkehren:
@return gemischt zurückgegebener value .
Beispiel:
<?php
use function _ identity ;
$ object = [ ' a ' => 1 ];
identity ( $ object ) === $ object ;
// => true Erstellt eine Funktion, die den Wert am path eines bestimmten Objekts zurückgibt.
Argumente:
@param (Array | String) $ Pfad Der Pfad der Eigenschaft zu erhalten.
Zurückkehren:
@Return Callable gibt die neue Accessor -Funktion zurück.
Beispiel:
<?php
use function _ property ;
$ objects = [
[ ' a ' => [ ' b ' => 2 ] ],
[ ' a ' => [ ' b ' => 1 ] ]
];
map ( $ objects , property ( ' a.b ' ));
// => [2, 1]
map ( sortBy ( $ objects , property ([ ' a ' , ' b ' ])), ' a.b ' );
// => [1, 2]
