lodash php

لوداش-PHP

Lodash-PHP هو منفذ لمكتبة Lodash JS إلى PHP. إنها مجموعة من الوظائف المساعدة سهلة الاستخدام لمشاريع PHP اليومية.

يحاول Lodash-PHP تقليد lodash.js في أقرب وقت ممكن

متطلبات

يتطلب Lodash-PHP الحد الأدنى من PHP 7.2+، ولكن يوصى دائمًا باستخدام أحدث إصدار من PHP.

تثبيت

قم بتثبيت Lodash-PHP من خلال الملحن:

$ composer require lodash-php/lodash-php

الاستخدام

كل طريقة في Lodash-PHP هي وظيفة منفصلة يمكن استيرادها واستخدامها بمفردها.

 <?php

use function _  each ;

each ([ 1 , 2 , 3 ], function ( int $ item ) {
    var_dump ( $ item );
});

يأتي Lodash-PHP أيضًا مع فئة _ عالمية يمكن استخدامها عالميًا.

 <?php

_:: each ([ 1 , 2 , 3 ], function ( int $ item ) {
    var_dump ( $ item );
});

طُرق

• صفيف
• مجموعة
• تاريخ
• وظيفة
• لانج
• الرياضيات
• رقم
• هدف
• تسلسل
• خيط
• فائدة

صفيف

قطعة

ينشئ مجموعة من العناصر مقسمة إلى مجموعات بطول size . إذا لم يكن من الممكن تقسيم array بالتساوي، فستكون القطعة الأخيرة هي العناصر المتبقية.

الحجج:

@param array $array array المصفوفة المراد معالجتها.

@param int $number [size=1] طول كل قطعة

يعود:

@return array يُرجع المصفوفة الجديدة من القطع.

مثال:

 <?php
 use function _  chunk ;

chunk ([ ' a ' , ' b ' , ' c ' , ' d ' ], 2 )
// => [['a', 'b'], ['c', 'd']]

chunk ([ ' a ' , ' b ' , ' c ' , ' d ' ], 3 )
// => [['a', 'b', 'c'], ['d']]

مدمج

إنشاء مصفوفة مع إزالة جميع القيم الزائفة. القيم false و null و 0 و "" و undefined و NaN هي قيم خاطئة.

الحجج:

@param array $array المصفوفة المراد ضغطها.

يعود:

@return array يُرجع المصفوفة الجديدة من القيم التي تمت تصفيتها.

مثال:

 <?php
 use function _  compact ;

compact ([ 0 , 1 , false , 2 , '' , 3 ])
// => [1, 2, 3]

com.concat

إنشاء array متسلسلة جديدة مع أي صفائف و/أو قيم إضافية.

الحجج:

@param array $array المصفوفة المراد تسلسلها.

@param array<int, mixed> $values ​​القيم المراد ربطها.

يعود:

@return array يُرجع المصفوفة المتسلسلة الجديدة.

مثال:

 <?php
 use function _  concat ;

$ array = [ 1 ];
$ other = concat ( $ array , 2 , [ 3 ], [[ 4 ]]);

var_dump ( $ other )
// => [1, 2, 3, [4]]

var_dump ( $ array )
// => [1]

اختلاف

ينشئ مصفوفة من قيم array غير المضمنة في المصفوفات الأخرى المحددة باستخدام SameValueZero لمقارنات المساواة. يتم تحديد ترتيب ومراجع قيم النتائج بواسطة المصفوفة الأولى.

ملحوظة: على عكس pullAll ، تقوم هذه الطريقة بإرجاع مصفوفة جديدة.

الحجج:

@param array $array المصفوفة المطلوب فحصها.

@param array ...$values ​​القيم المطلوب استبعادها.

يعود:

@return array يُرجع المصفوفة الجديدة من القيم التي تمت تصفيتها.

مثال:

 <?php
 use function _  difference ;

difference ([ 2 , 1 ], [ 2 , 3 ])
// => [1]

الفرق بواسطة

تشبه هذه الطريقة difference إلا أنها تقبل iteratee الذي يتم استدعاؤه لكل عنصر من عناصر array values لإنشاء المعيار الذي تتم مقارنتها به. يتم تحديد ترتيب ومراجع قيم النتائج بواسطة المصفوفة الأولى. يتم استدعاء التكرار باستخدام وسيطة واحدة: (القيمة).

ملاحظة: على عكس pullAllBy ، تقوم هذه الطريقة بإرجاع مصفوفة جديدة.

الحجج:

@param array $array المصفوفة المطلوب فحصها.

@param array<int, mixed> ...$values ​​القيم المطلوب استبعادها.

@param callable $iteratee التكرار الذي تم استدعاؤه لكل عنصر.

يعود:

@return array يُرجع المصفوفة الجديدة من القيم التي تمت تصفيتها.

مثال:

 <?php
 use function _  differenceBy ;

differenceBy ([ 2.1 , 1.2 ], [ 2.3 , 3.4 ], ' floor ' )
// => [1.2]

الفرق مع

تشبه هذه الطريقة difference إلا أنها تقبل comparator التي يتم استدعاؤها لمقارنة عناصر array values . يتم تحديد ترتيب ومراجع قيم النتائج بواسطة المصفوفة الأولى. يتم استدعاء المقارنة باستخدام وسيطتين: (arrVal، othVal).

ملاحظة: على عكس pullAllWith ، تقوم هذه الطريقة بإرجاع مصفوفة جديدة.

الحجج:

@param array<int, mixed> $array المصفوفة المطلوب فحصها.

@param array ...$values ​​القيم المطلوب استبعادها.

@param callable $comparator يتم استدعاء المقارنة لكل عنصر.

يعود:

@return array يُرجع المصفوفة الجديدة من القيم التي تمت تصفيتها.

مثال:

 <?php
 use function _  differenceWith ;

$ objects = [[ ' x ' => 1 , ' y ' => 2 ], [ ' x ' => 2 , ' y ' => 1 ]]

differenceWith ( $ objects , [[ ' x ' => 1 , ' y ' => 2 ]], ' _::isEqual ' )
// => [[ 'x' => 2, 'y' => 1 ]]

يسقط

ينشئ شريحة من array تحتوي على عناصر n تم إسقاطها من البداية.

ملاحظة: ستقوم هذه الوظيفة بإعادة ترتيب وإعادة تعيين مؤشرات الصفيف

الحجج:

@param array $array المصفوفة المطلوب الاستعلام عنها.

@param int $n عدد العناصر التي سيتم إسقاطها.

يعود:

@return array شريحة array .

مثال:

 <?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]

dropRight

ينشئ شريحة من array تحتوي على عناصر n تم إسقاطها من النهاية. ملاحظة: ستقوم هذه الوظيفة بإعادة ترتيب وإعادة تعيين مؤشرات الصفيف

الحجج:

@param array $array المصفوفة المطلوب الاستعلام عنها.

@param int $n عدد العناصر التي سيتم إسقاطها.

يعود:

@return array شريحة array .

مثال:

 <?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]

dropRightWhile

ينشئ شريحة من array باستثناء العناصر المسقطة من النهاية. يتم إسقاط العناصر حتى يعود predicate بشكل خاطئ. يتم استدعاء المسند بثلاث وسائط: (القيمة، الفهرس، المصفوفة).

الحجج:

@param array $array المصفوفة المطلوب الاستعلام عنها.

@param callable $predicate الوظيفة التي يتم استدعاؤها لكل تكرار.

يعود:

@return array شريحة array .

مثال:

 <?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']

dropWhile

ينشئ شريحة من array باستثناء العناصر المسقطة من البداية. يتم إسقاط العناصر حتى يعود predicate بشكل خاطئ. يتم استدعاء المسند بثلاث وسائط: (القيمة، الفهرس، المصفوفة).

الحجج:

@param array $array المصفوفة المطلوب الاستعلام عنها.

@param callable $predicate الوظيفة التي يتم استدعاؤها لكل تكرار.

يعود:

@return array شريحة array .

مثال:

 <?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']

كل

يتحقق مما إذا كان predicate يُرجع الصدق لجميع عناصر array . يتم إيقاف التكرار بمجرد إرجاع predicate بشكل خاطئ. يتم استدعاء المسند بثلاث وسائط: (القيمة، الفهرس، المصفوفة).

ملاحظة: تُرجع هذه الطريقة true للمصفوفات الفارغة لأن كل شيء ينطبق على عناصر المصفوفات الفارغة.

الحجج:

@param iterable $collection المصفوفة المراد التكرار عليها.

@param callable $predicate الوظيفة التي يتم استدعاؤها لكل تكرار.

يعود:

@return bool true إذا اجتازت جميع العناصر اختبار المسند، وإلا false .

مثال:

 <?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

findIndex

تشبه هذه الطريقة find إلا أنها تُرجع فهرس العنصر الأول المسند الذي يُرجع الصدق بدلاً من العنصر نفسه.

الحجج:

@param array $array المصفوفة المطلوب فحصها.

@param callable $predicate الوظيفة التي يتم استدعاؤها لكل تكرار.

@param int $fromIndex الفهرس الذي سيتم البحث منه.

يعود:

@return int فهرس العنصر الموجود، else -1 .

مثال:

 <?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

findLastIndex

تشبه هذه الطريقة findIndex إلا أنها تتكرر على عناصر collection من اليمين إلى اليسار.

الحجج:

@param array $array المصفوفة المطلوب فحصها.

@param مختلط المسند $ الوظيفة التي يتم استدعاؤها لكل تكرار.

@param int $fromIndex الفهرس الذي سيتم البحث منه.

يعود:

@return int فهرس العنصر الموجود، else -1 .

مثال:

 <?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

تتسطح

تتسطح array مستوى واحد عميق.

الحجج:

@param array $array المصفوفة المراد تسطيحها.

يعود:

@return array المصفوفة المسطحة الجديدة.

مثال:

 <?php
 use function _  flatten ;

flatten ([ 1 , [ 2 , [ 3 , [ 4 ]], 5 ]])
// => [1, 2, [3, [4]], 5]

com.flattenDeep

يسطح array بشكل متكرر.

الحجج:

@param array $array المصفوفة المراد تسطيحها.

يعود:

@return array يُرجع المصفوفة المسطحة الجديدة.

مثال:

 <?php
 use function _  flattenDeep ;

flattenDeep ([ 1 , [ 2 , [ 3 , [ 4 ]], 5 ]]);
// => [1, 2, 3, 4, 5]

com.flattenDepth

تسطيح array بشكل متكرر حتى أوقات depth .

الحجج:

@param array $array المصفوفة المراد تسطيحها.

param int $عمق الحد الأقصى لعمق العودية.

يعود:

@return array المصفوفة المسطحة الجديدة.

مثال:

 <?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]

منأزواج

على عكس toPairs ، تقوم هذه الطريقة بإرجاع كائن مكون من pairs قيمة المفتاح.

الحجج:

@param array $pairs أزواج القيمة الرئيسية.

يعود:

@return stdClass الكائن الجديد.

مثال:

 <?php
 use function _  fromPairs ;

fromPairs ([[ ' a ' , 1 ], [ ' b ' , 2 ]])
// => stdClass(
// 'a' => 1,
//'b' => 2,
// )

رأس

يحصل على العنصر الأول من array .

الحجج:

@param array $array المصفوفة المطلوب الاستعلام عنها.

يعود:

@return مختلط يُرجع العنصر الأول من array .

مثال:

 <?php
 use function _  head ;

head ([ 1 , 2 , 3 ])
// => 1

head ([])
// => null

مؤشر

الحصول على الفهرس الذي تم العثور فيه على التواجد الأول value في array باستخدام SameValueZero لمقارنات المساواة. إذا كانت fromIndex سالبة، فسيتم استخدامها كإزاحة من نهاية array .

الحجج:

@param array $array المصفوفة المطلوب فحصها.

@param مختلط بقيمة $ القيمة التي يجب البحث عنها.

@param int $fromIndex الفهرس الذي سيتم البحث منه.

يعود:

@return int فهرس القيمة المطابقة، else -1 .

مثال:

 <?php
 use function _  indexOf ;

indexOf ([ 1 , 2 , 1 , 2 ], 2 )
// => 1

// Search from the `fromIndex`.
indexOf ([ 1 , 2 , 1 , 2 ], 2 , 2 )
// => 3

أولي

يحصل على كل العناصر باستثناء العنصر الأخير من array .

الحجج:

@param array $array المصفوفة المطلوب الاستعلام عنها.

يعود:

@return array شريحة array .

مثال:

 <?php
 use function _  initial ;

initial ([ 1 , 2 , 3 ])
// => [1, 2]

تقاطع

ينشئ مصفوفة من القيم الفريدة المضمنة في جميع المصفوفات المحددة باستخدام SameValueZero لمقارنات المساواة. يتم تحديد ترتيب ومراجع قيم النتائج بواسطة المصفوفة الأولى.

الحجج:

@param array ...$arrays

يعود:

@return array المصفوفة الجديدة من القيم المتقاطعة.

مثال:

 <?php
 use function _  intersection ;

intersection ([ 2 , 1 ], [ 2 , 3 ])
// => [2]

تقاطع بواسطة

تشبه هذه الطريقة intersection إلا أنها تقبل iteratee الذي يتم استدعاؤه لكل عنصر في كل arrays لإنشاء المعيار الذي يتم من خلاله مقارنتها. يتم تحديد ترتيب ومراجع قيم النتائج بواسطة المصفوفة الأولى. يتم استدعاء التكرار باستخدام وسيطة واحدة: (القيمة).

الحجج:

@param array<int, mix> ...$arrays

@param callable $iteratee التكرار الذي تم استدعاؤه لكل عنصر.

يعود:

@return array المصفوفة الجديدة من القيم المتقاطعة.

مثال:

 <?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 ]]

intersectionWith

تشبه هذه الطريقة intersection إلا أنها تقبل comparator التي يتم استدعاؤها لمقارنة عناصر arrays . يتم تحديد ترتيب ومراجع قيم النتائج بواسطة المصفوفة الأولى. يتم استدعاء المقارنة باستخدام وسيطتين: (arrVal، othVal).

الحجج:

@param array ...$arrays

@param callable $comparator يتم استدعاء المقارنة لكل عنصر.

يعود:

@return array المصفوفة الجديدة من القيم المتقاطعة.

مثال:

 <?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 ]]

آخر

يحصل على العنصر الأخير من array .

الحجج:

@param array $array المصفوفة المطلوب الاستعلام عنها.

يعود:

@return مختلط يُرجع العنصر الأخير من array .

مثال:

 <?php
 use function _  last ;

last ([ 1 , 2 , 3 ])
// => 3

lastIndexOf

تشبه هذه الطريقة indexOf باستثناء أنها تتكرر على عناصر array من اليمين إلى اليسار.

الحجج:

@param array $array المصفوفة المطلوب فحصها.

@param مختلط بقيمة $ القيمة التي يجب البحث عنها.

@param int $fromIndex الفهرس الذي سيتم البحث منه.

يعود:

@return int فهرس القيمة المطابقة، else -1 .

مثال:

 <?php
 use function _  lastIndexOf ;

lastIndexOf ([ 1 , 2 , 1 , 2 ], 2 )
// => 3

// Search from the `fromIndex`.
lastIndexOf ([ 1 , 2 , 1 , 2 ], 2 , 2 )
// => 1

ن

يحصل على العنصر في فهرس n من array . إذا كانت n سالبة، فسيتم إرجاع العنصر n من النهاية.

الحجج:

@param array $array المصفوفة المطلوب الاستعلام عنها.

@param int $n فهرس العنصر المراد إرجاعه.

يعود:

@return مختلط يُرجع العنصر n من array .

مثال:

 <?php
 use function _  nth ;

$ array = [ ' a ' , ' b ' , ' c ' , ' d ' ]

nth ( $ array , 1 )
// => 'b'

nth ( $ array , - 2 )
// => 'c'

يحذب

إزالة جميع القيم المعطاة من array باستخدام SameValueZero لمقارنات المساواة.

ملحوظة: على عكس without ، تقوم هذه الطريقة بتغيير array . استخدم remove لإزالة العناصر من صفيف حسب المسند.

الحجج:

@param array $array المصفوفة المراد تعديلها.

@param array<int, string> $values ​​القيم المراد إزالتها.

يعود:

@مصفوفة العودة

مثال:

 <?php
 use function _  pull ;

$ array = [ ' a ' , ' b ' , ' c ' , ' a ' , ' b ' , ' c ' ]

pull ( $ array , ' a ' , ' c ' )
var_dump ( $ array )
// => ['b', 'b']

pullAll

تشبه هذه الطريقة pull إلا أنها تقبل مجموعة من القيم المراد إزالتها.

ملحوظة: على عكس difference ، تقوم هذه الطريقة بتغيير array .

الحجج:

@param array $array المصفوفة المراد تعديلها.

param array $values ​​​​القيم المراد إزالتها.

يعود:

@return array المصفوفة .

مثال:

 <?php
 use function _  pullAll ;

$ array = [ ' a ' , ' b ' , ' c ' , ' a ' , ' b ' , ' c ' ]

pullAll ( $ array , [ ' a ' , ' c ' ])
var_dump ( $ array )
// => ['b', 'b']

pullAllBy

تشبه هذه الطريقة pullAll إلا أنها تقبل iteratee الذي يتم استدعاؤه لكل عنصر من عناصر array values لإنشاء المعيار الذي تتم مقارنتها به. يتم استدعاء التكرار باستخدام وسيطة واحدة: (القيمة).

ملاحظة: على عكس differenceBy ، تقوم هذه الطريقة بتغيير array .

الحجج:

@param array $array المصفوفة المراد تعديلها.

param array $values ​​​​القيم المراد إزالتها.

@param callable $iteratee التكرار الذي تم استدعاؤه لكل عنصر.

يعود:

@return array المصفوفة .

مثال:

 <?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 ]]

pullAllWith

تشبه هذه الطريقة pullAll إلا أنها تقبل comparator التي يتم استدعاؤها لمقارنة عناصر array values . يتم استدعاء المقارنة باستخدام وسيطتين: (arrVal، othVal).

ملاحظة: على عكس differenceWith ، تقوم هذه الطريقة بتغيير array .

الحجج:

@param array $array المصفوفة المراد تعديلها.

@param array $values ​​​​القيم المراد إزالتها.

@param callable $comparator يتم استدعاء المقارنة لكل عنصر.

يعود:

@return array المصفوفة .

مثال:

 <?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 ]]

pullAt

يزيل العناصر من array المقابلة indexes ويعيد مصفوفة من العناصر المحذوفة.

ملاحظة: على عكس at ، تقوم هذه الطريقة بتغيير array .

الحجج:

@param array $array المصفوفة المراد تعديلها.

@param (int | int[]) $indexes فهارس العناصر المطلوب إزالتها.

يعود:

@return array المصفوفة الجديدة من العناصر التي تمت إزالتها.

مثال:

 <?php
 use function _  pullAt ;

$ array = [ ' a ' , ' b ' , ' c ' , ' d ' ]
$ pulled = pullAt ( $ array , [ 1 , 3 ])

var_dump ( $ array )
// => ['a', 'c']

var_dump ( $ pulled )
// => ['b', 'd']

يزيل

يزيل كافة العناصر من array التي predicate إرجاع صحيح لـ وتعيد مصفوفة من العناصر التي تمت إزالتها. يتم استدعاء المسند بثلاث وسائط: (القيمة، الفهرس، المصفوفة).

ملاحظة: على عكس filter ، تعمل هذه الطريقة على تغيير array . استخدم pull لسحب العناصر من المصفوفة حسب القيمة.

الحجج:

@param array $array المصفوفة المراد تعديلها.

@param callable $predicate الوظيفة التي يتم استدعاؤها لكل تكرار.

يعود:

@return array المصفوفة الجديدة من العناصر التي تمت إزالتها.

مثال:

 <?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]

عينة

يحصل على عنصر عشوائي من array .

الحجج:

@param array $array المصفوفة المراد أخذ عينات منها.

يعود:

@return مختلط يقوم بإرجاع العنصر العشوائي.

مثال:

 <?php
 use function _  sample ;

sample ([ 1 , 2 , 3 , 4 ])
// => 2

حجم العينة

يحصل على عناصر عشوائية n في مفاتيح فريدة من array حتى حجم array .

الحجج:

@param array $array المصفوفة المراد أخذ عينات منها.

@param int $n عدد العناصر المراد أخذ عينات منها.

يعود:

@return صفيف العناصر العشوائية.

مثال:

 <?php
 use function _  sampleSize ;

sampleSize ([ 1 , 2 , 3 ], 2 )
// => [3, 1]

sampleSize ([ 1 , 2 , 3 ], 4 )
// => [2, 3, 1]

خلط

إنشاء مجموعة من القيم المختلطة

الحجج:

@param array $array المصفوفة المراد خلطها.

يعود:

@return array المصفوفة المختلطة الجديدة.

مثال:

 <?php
 use function _  shuffle ;

shuffle ([ 1 , 2 , 3 , 4 ])
// => [4, 1, 3, 2]

شريحة

ينشئ شريحة من array من start إلى end ، ولكن ليس بما في ذلك.

الحجج:

@param array $array المصفوفة المراد تقطيعها.

@param int $start موضع البداية.

@param int $end الموضع النهائي.

يعود:

@return array شريحة array .

ذيل

يحصل على كل العناصر باستثناء العنصر الأول من array .

الحجج:

@param array $array المصفوفة المطلوب الاستعلام عنها.

يعود:

@return array شريحة array .

مثال:

 <?php
 use function _  tail ;

tail ([ 1 , 2 , 3 ])
// => [2, 3]

يأخذ

ينشئ شريحة من array تحتوي على عناصر n مأخوذة من البداية.

الحجج:

@param array $array المصفوفة المطلوب الاستعلام عنها.

@param int $n عدد العناصر المطلوب أخذها.

يعود:

@return array شريحة array .

مثال:

 <?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 )
// => []

com.takeRight

ينشئ شريحة من array تحتوي على عناصر n مأخوذة من النهاية.

الحجج:

@param array $array المصفوفة المطلوب الاستعلام عنها.

@param int $n عدد العناصر المطلوب أخذها.

يعود:

@return array شريحة array .

مثال:

 <?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 )
// => []

takeRightWhile

ينشئ شريحة من array بعناصر مأخوذة من النهاية. يتم أخذ العناصر حتى يعود predicate بشكل خاطئ. يتم استدعاء المسند بثلاث وسائط: (القيمة، الفهرس، المصفوفة).

الحجج:

@param array $array المصفوفة المطلوب الاستعلام عنها.

@param callable $predicate الوظيفة التي يتم استدعاؤها لكل تكرار.

يعود:

@return array شريحة array .

مثال:

 <?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']

takeWhile

ينشئ شريحة من array بعناصر مأخوذة من البداية. يتم أخذ العناصر حتى يعود predicate بشكل خاطئ. يتم استدعاء المسند بثلاث وسائط: (القيمة، الفهرس، المصفوفة).

الحجج:

@param array $array المصفوفة المطلوب الاستعلام عنها.

@param مختلط المسند $ الوظيفة التي يتم استدعاؤها لكل تكرار.

يعود:

@return array شريحة array .

مثال:

 <?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']

الاتحاد

ينشئ مصفوفة من القيم الفريدة، بالترتيب، من جميع المصفوفات المحددة باستخدام SameValueZero لمقارنات المساواة.

الحجج:

@param array ...$arrays المصفوفات المطلوب فحصها.

يعود:

@return array المصفوفة الجديدة من القيم المدمجة.

مثال:

 <?php
 use function _  union ;

union ([ 2 ], [ 1 , 2 ])
// => [2, 1]

unionBy

تشبه هذه الطريقة طريقة union إلا أنها تقبل iteratee الذي يتم استدعاؤه لكل عنصر في كل arrays لإنشاء المعيار الذي يتم من خلاله حساب التفرد. يتم اختيار القيم الناتجة من المصفوفة الأولى التي تحدث فيها القيمة. يتم استدعاء التكرار باستخدام وسيطة واحدة: (القيمة).

الحجج:

@param array<int, mix> ...$arrays المصفوفات المراد فحصها.

@param callable $iteratee التكرار الذي تم استدعاؤه لكل عنصر.

يعود:

@return array المصفوفة الجديدة من القيم المدمجة.

مثال:

 <?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]]

unionWith

هذه الطريقة تشبه union إلا أنها تقبل comparator التي يتم استدعاؤها لمقارنة عناصر arrays . يتم اختيار القيم الناتجة من المصفوفة الأولى التي تحدث فيها القيمة. يتم استدعاء المقارنة باستخدام وسيطتين: (arrVal، othVal).

الحجج:

@param array<int, mix> ...$arrays المصفوفات المطلوب فحصها.

@param callable $comparator يتم استدعاء المقارنة لكل عنصر.

يعود:

@return array المصفوفة الجديدة من القيم المدمجة.

مثال:

 <?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]]

uniq

ينشئ نسخة خالية من التكرارات من المصفوفة، باستخدام SameValueZero لمقارنات المساواة، حيث يتم الاحتفاظ فقط بالتواجد الأول لكل عنصر. يتم تحديد ترتيب قيم النتائج حسب ترتيب ظهورها في المصفوفة.

الحجج:

@param array $array المصفوفة المطلوب فحصها.

يعود:

@return array المصفوفة الحرة المكررة الجديدة.

مثال:

 <?php
 use function _  uniq ;

uniq ([ 2 , 1 , 2 ])
// => [2, 1]s

uniqBy

تشبه هذه الطريقة uniq إلا أنها تقبل iteratee الذي يتم استدعاؤه لكل عنصر في array لإنشاء المعيار الذي يتم من خلاله حساب التفرد. يتم تحديد ترتيب قيم النتائج حسب ترتيب ظهورها في المصفوفة. يتم استدعاء التكرار باستخدام وسيطة واحدة: (القيمة).

الحجج:

@param array $array المصفوفة المطلوب فحصها.

@param مختلط $iteratee التكرار الذي تم استدعاؤه لكل عنصر.

يعود:

@return array المصفوفة الحرة المكررة الجديدة.

مثال:

 <?php
 use function _  uniqBy ;

uniqBy ([ 2.1 , 1.2 , 2.3 ], ' floor ' )
// => [2.1, 1.2]

uniqWith

تشبه هذه الطريقة uniq إلا أنها تقبل comparator التي يتم استدعاؤها لمقارنة عناصر array . يتم تحديد ترتيب قيم النتائج حسب ترتيب حدوثها في المصفوفة. يتم استدعاء المقارنة باستخدام وسيطتين: (arrVal، othVal).

الحجج:

@param array $array المصفوفة المطلوب فحصها.

@param callable $comparator يتم استدعاء المقارنة لكل عنصر.

يعود:

@return array المصفوفة الحرة المكررة الجديدة.

مثال:

 <?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]]

فك الضغط

تشبه هذه الطريقة zip إلا أنها تقبل مصفوفة من العناصر المجمعة وتقوم بإنشاء مصفوفة تعيد تجميع العناصر إلى تكوينها المسبق للضغط.

الحجج:

@param array $array مصفوفة العناصر المجمعة المطلوب معالجتها.

يعود:

@return array المصفوفة الجديدة من العناصر المُعاد تجميعها.

مثال:

 <?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]]

unzipWith

تشبه هذه الطريقة unzip إلا أنها تقبل iteratee لتحديد كيفية دمج القيم المُعاد تجميعها. يتم استدعاء التكرار مع عناصر كل مجموعة: (...group).

الحجج:

@param array $array مصفوفة العناصر المجمعة المراد معالجتها.

@param (قابل للاستدعاء | null) $iteratee وظيفة دمج القيم المعاد تجميعها.

يعود:

@return array المصفوفة الجديدة من العناصر المُعاد تجميعها.

مثال:

 <?php
 use function _  unzipWith ;

$ zipped = zip ([ 1 , 2 ], [ 10 , 20 ], [ 100 , 200 ])
// => [[1, 10, 100], [2, 20, 200]]

unzipWith (zipped, ' _::add ' )
// => [3, 30, 300]

بدون

ينشئ مصفوفة باستثناء كافة القيم المحددة باستخدام SameValueZero لمقارنات المساواة.

ملاحظة: على عكس pull ، تُرجع هذه الطريقة مصفوفة جديدة.

الحجج:

@param array $array المصفوفة المطلوب فحصها.

@param array<int, mixed> $values ​​القيم المراد استبعادها.

يعود:

@return array المصفوفة الجديدة من القيم التي تمت تصفيتها.

مثال:

 <?php
 use function _  without ;

without ([ 2 , 1 , 2 , 3 ], 1 , 2 )
// => [3]

أَزِيز

إنشاء مصفوفة من العناصر المجمعة، يحتوي أولها على العناصر الأولى من المصفوفات المحددة، ويحتوي الثاني على العناصر الثانية من المصفوفات المحددة، وهكذا.

الحجج:

@param array ...$arrays المصفوفات المطلوب معالجتها.

يعود:

@return array المصفوفة الجديدة من العناصر المجمعة.

مثال:

 <?php
 use function _  zip ;

zip ([ ' a ' , ' b ' ], [ 1 , 2 ], [ true , false ])
// => [['a', 1, true], ['b', 2, false]]

zipObject

تشبه هذه الطريقة طريقة fromPairs إلا أنها تقبل صفيفين، أحدهما لمعرفات الخاصية والآخر للقيم المقابلة.

الحجج:

@param array $props معرفات الخاصية.

@param array $values ​​قيم الخاصية.

يعود:

@return الكائن الكائن الجديد.

مثال:

 <?php
 use function _  zipObject ;

zipObject ([ ' a ' , ' b ' ], [ 1 , 2 ])
/* => object(stdClass) #210 (2) {
[ " a " ] => int( 1 )
[ " b " ] => int( 2 )
}
*/

zipObjectDeep

تشبه هذه الطريقة zipObject إلا أنها تدعم مسارات الخصائص.

الحجج:

@param array $props معرفات الخاصية.

@param array $values ​​قيم الخاصية.

يعود:

@return stdClass الكائن الجديد.

مثال:

 <?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 )
}
}
}
}
*/

com.zipWith

تشبه هذه الطريقة zip باستثناء أنها تقبل iteratee لتحديد كيفية دمج القيم المجمعة. يتم استدعاء التكرار مع عناصر كل مجموعة: (...group).

الحجج:

@param array<int, (array | callable)> ...$arrays المصفوفات المطلوب معالجتها.

@param callable $iteratee وظيفة دمج القيم المجمعة.

يعود:

@return array المصفوفة الجديدة من العناصر المجمعة.

مثال:

 <?php
 use function _  zipWith ;

zipWith ([ 1 , 2 ], [ 10 , 20 ], [ 100 , 200 ], function ( $ a , $ b , $ c ) { return $ a + $ b + $ c ; })
// => [111, 222] 

مجموعة

العد بواسطة

ينشئ مصفوفة مكونة من مفاتيح تم إنشاؤها من نتائج تشغيل كل عنصر من عناصر collection من خلال iteratee . القيمة المقابلة لكل مفتاح هي عدد المرات التي تم فيها إرجاع المفتاح بواسطة iteratee . يتم استدعاء التكرار باستخدام وسيطة واحدة: (القيمة).

الحجج:

@param iterable $collection المجموعة المراد التكرار عليها.

@param callable $iteratee المكرر لتحويل المفاتيح.

يعود:

@return array يُرجع الكائن المجمع المُكوَّن.

مثال:

 <?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]

كل

يتكرر على عناصر collection ويستدعي iteratee لكل عنصر. يتم استدعاء التكرار بثلاث وسائط: (القيمة، الفهرس|المفتاح، المجموعة). قد تخرج دوال التكرار من التكرار مبكرًا عن طريق إرجاع false صراحةً.

ملاحظة: كما هو الحال مع أساليب "المجموعات" الأخرى، يتم تكرار الكائنات ذات خاصية "الطول" مثل المصفوفات. لتجنب هذا السلوك، استخدم forIn أو forOwn لتكرار الكائن.

الحجج:

@param (صفيف | قابل للتكرار | كائن) $collection المجموعة المراد التكرار عليها.

@param callable $iteratee الوظيفة التي يتم استدعاؤها لكل تكرار.

يعود:

@return (صفيف | كائن) يُرجع collection .

مثال:

 <?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).

لكل حق

تشبه هذه الطريقة each باستثناء أنها تتكرر على عناصر collection من اليمين إلى اليسار.

الحجج:

@param (صفيف | قابل للتكرار | كائن) $collection المجموعة المراد التكرار عليها.

@param callable $iteratee الوظيفة التي يتم استدعاؤها لكل تكرار.

يعود:

@return (صفيف | كائن) يُرجع collection .

مثال:

 <?php
 use function _  eachRight ;

eachRight ([ 1 , 2 ], function ( $ value ) { echo $ value ; })
// => Echoes `2` then `1`.

فلتر

يتكرر على عناصر array ، مما يؤدي إلى إرجاع مصفوفة من جميع العناصر predicate إلى الصدق. يتم استدعاء المسند بثلاث وسائط: (القيمة، الفهرس، المصفوفة).

ملاحظة: على عكس remove ، تقوم هذه الطريقة بإرجاع مصفوفة جديدة.

الحجج:

@param iterable $array المصفوفة التي سيتم التكرار عليها.

@param callable $predicate الوظيفة التي يتم استدعاؤها لكل تكرار.

يعود:

@return array المصفوفة الجديدة التي تمت تصفيتها.

مثال:

 <?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']

يجد

يتكرر على عناصر collection ، ويعيد إرجاع العنصر الأول predicate إلى الصدق. يتم استدعاء المسند بثلاث وسائط: (القيمة، الفهرس|المفتاح، المجموعة).

الحجج:

@param iterable $collection المجموعة المطلوب فحصها.

@param callable $predicate الوظيفة التي يتم استدعاؤها لكل تكرار.

@param int $fromIndex الفهرس الذي سيتم البحث منه.

يعود:

@return مختلط يُرجع العنصر المطابق، وإلا null .

مثال:

 <?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'

findLast

تشبه هذه الطريقة find إلا أنها تتكرر على عناصر collection من اليمين إلى اليسار.

الحجج:

@param iterable $collection المجموعة المطلوب فحصها.

@param callable $predicate الوظيفة التي يتم استدعاؤها لكل تكرار.

@param int $fromIndex الفهرس الذي سيتم البحث منه.

يعود:

@return مختلط يقوم بإرجاع العنصر المطابق، وإلا undefined .

مثال:

 <?php
 use function _  findLast ;

findLast ([ 1 , 2 , 3 , 4 ], function ( $ n ) { return $ n % 2 == 1 ; })
// => 3

flatMap

ينشئ مصفوفة مسطحة من القيم عن طريق تشغيل كل عنصر في collection من خلال iteratee وتسوية النتائج المعينة. يتم استدعاء التكرار بثلاث وسائط: (القيمة، الفهرس|المفتاح، المجموعة).

الحجج:

@param iterable $collection المجموعة المراد التكرار عليها.

@param callable $iteratee الوظيفة التي يتم استدعاؤها لكل تكرار.

يعود:

@return array المصفوفة المسطحة الجديدة.

مثال:

 <?php
 use function _  flatMap ;

function duplicate ( $ n ) {
return [ $ n , $ n ]
}

flatMap ([ 1 , 2 ], ' duplicate ' )
// => [1, 1, 2, 2]

flatMapDeep

تشبه هذه الطريقة flatMap إلا أنها تعمل على تسوية النتائج المعينة بشكل متكرر.

الحجج:

@param iterable $collection المجموعة المراد التكرار عليها.

@param callable $iteratee الوظيفة التي يتم استدعاؤها لكل تكرار.

يعود:

@return array يُرجع المصفوفة المسطحة الجديدة.

مثال:

 <?php
 use function _  flatMapDeep ;

function duplicate ( $ n ) {
return [[[ $ n , $ n ]]];
}

flatMapDeep ([ 1 , 2 ], ' duplicate ' );
// => [1, 1, 2, 2]

flatMapDepth

تشبه هذه الطريقة flatMap إلا أنها تقوم بتسوية النتائج المعينة بشكل متكرر حتى أوقات depth .

الحجج:

@param iterable $collection المجموعة المراد التكرار عليها.

@param callable $iteratee الوظيفة التي يتم استدعاؤها لكل تكرار.

@param int $عمق الحد الأقصى لعمق العودية.

يعود:

@return array المصفوفة المسطحة الجديدة.

مثال:

 <?php
 use function _  flatMapDepth ;

function duplicate ( $ n ) {
return [[[ $ n , $ n ]]]
}

flatMapDepth ([ 1 , 2 ], ' duplicate ' , 2 )
// => [[1, 1], [2, 2]]

groupBy

ينشئ مصفوفة مكونة من مفاتيح تم إنشاؤها من نتائج تشغيل كل عنصر من عناصر collection من خلال iteratee . يتم تحديد ترتيب القيم المجمعة حسب ترتيب ظهورها في collection . القيمة المقابلة لكل مفتاح هي مجموعة من العناصر المسؤولة عن إنشاء المفتاح. يتم استدعاء التكرار باستخدام وسيطة واحدة: (القيمة).

الحجج:

@param iterable $collection المجموعة المراد التكرار عليها.

@param callable $iteratee المكرر لتحويل المفاتيح.

يعود:

@return array يُرجع الكائن المجمع المُكوَّن.

مثال:

 <?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']]

invocationMap

يستدعي الطريقة في path كل عنصر في collection ، ويعيد مصفوفة من نتائج كل طريقة تم استدعاؤها. يتم توفير أية وسائط إضافية لكل أسلوب تم استدعاؤه. إذا كان path دالة، فسيتم استدعاؤه لكل عنصر في collection this به.

الحجج:

@param iterable $collection المجموعة المراد التكرار عليها.

@param (صفيف | قابل للاستدعاء | سلسلة) $path مسار الأسلوب المطلوب استدعاؤه أو الوظيفة التي يتم استدعاؤها لكل تكرار.

@param array $args الوسائط التي سيتم استدعاء كل أسلوب بها.

يعود:

@return مصفوفة مجموعة النتائج.

مثال:

 <?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']]

keyBy

ينشئ كائنًا يتكون من مفاتيح تم إنشاؤها من نتائج تشغيل كل عنصر من عناصر collection من خلال iteratee . القيمة المقابلة لكل مفتاح هي العنصر الأخير المسؤول عن إنشاء المفتاح. يتم استدعاء التكرار باستخدام وسيطة واحدة: (القيمة).

الحجج:

@param iterable $collection المجموعة المراد التكرار عليها.

@param callable $iteratee المكرر لتحويل المفاتيح.

يعود:

@return صفيف الكائن المجمع المكون.

مثال:

 <?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]]

رسم خريطة

ينشئ مصفوفة من القيم عن طريق تشغيل كل عنصر في collection من خلال iteratee . يتم استدعاء التكرار بثلاث وسائط: (القيمة، الفهرس|المفتاح، المجموعة).

العديد من أساليب lodash-php محمية للعمل كتكرارات لطرق مثل _::every و _::filter و _::map و _::mapValues ​​و _::reject و _::some .

الأساليب المحمية هي: 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 و words

الحجج:

@param (صفيف | كائن) $collection المجموعة المراد التكرار عليها.

@param (قابل للاستدعاء | سلسلة | صفيف) $iteratee الوظيفة التي يتم استدعاؤها لكل تكرار.

يعود:

@return array يُرجع المصفوفة المعينة الجديدة.

مثال:

 <?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']

orderBy

تشبه هذه الطريقة sortBy باستثناء أنها تسمح بتحديد ترتيبات الفرز للتكرارات التي سيتم الفرز حسبها. إذا كانت orders غير محددة، فسيتم فرز كافة القيم بترتيب تصاعدي. بخلاف ذلك، حدد ترتيبًا "تنازليًا" للترتيب التنازلي أو "تصاعديًا" لترتيب الفرز التصاعدي للقيم المقابلة.

الحجج:

@param (iterable | null) $collection المجموعة المراد التكرار عليها.

@param (array[] | callable[] | string[]) $iteratee التكرارات التي سيتم الفرز حسبها.

@param string[] $orders ترتيبات الفرز iteratees .

يعود:

@return array المصفوفة المصنفة الجديدة.

مثال:

 <?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]]

تقسيم

ينشئ مصفوفة من العناصر مقسمة إلى مجموعتين، تحتوي المجموعة الأولى على عناصر predicate إرجاعات صحيحة، والثانية تحتوي على عناصر predicate تُرجع بشكل خاطئ لـ. يتم استدعاء المسند باستخدام وسيطة واحدة: (القيمة).

الحجج:

@param iterable $collection المجموعة المراد التكرار عليها.

@param callable $predicate الوظيفة التي يتم استدعاؤها لكل تكرار.

يعود:

@return array مجموعة من العناصر المجمعة.

مثال:

 <?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']]

يقلل

يقلل collection إلى قيمة هي النتيجة المتراكمة لتشغيل كل عنصر في collection من خلال iteratee ، حيث يتم تزويد كل استدعاء متتالي بالقيمة المرجعة للسابق. إذا لم يتم إعطاء accumulator ، يتم استخدام العنصر الأول من collection كقيمة أولية. يتم استدعاء التكرار باستخدام أربع وسائط: (accumulator، value، Index|key، Collection).

يتم حراسة العديد من أساليب lodash للعمل كتكرارات لطرق مثل reduce ، reduceRight ، transform .

الأساليب المحمية هي: assign و defaults و defaultsDeep و includes و merge و orderBy و sortBy

الحجج:

@param iterable $collection المجموعة المراد التكرار عليها.

@param مختلط $iteratee الوظيفة التي يتم استدعاؤها لكل تكرار.

param مختلط $accumulator القيمة الأولية.

يعود:

@return مختلط يُرجع القيمة المتراكمة.

مثال:

 <?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)

تقليل اليمين

تشبه هذه الطريقة طريقة reduce إلا أنها تتكرر على عناصر collection من اليمين إلى اليسار.

الحجج:

@param iterable $collection المجموعة المراد التكرار عليها.

@param مختلط $iteratee الوظيفة التي يتم استدعاؤها لكل تكرار.

param مختلط $accumulator القيمة الأولية.

يعود:

@return مختلط يُرجع القيمة المتراكمة.

مثال:

 <?php
 use function _  reduceRight ;

$ array = [[ 0 , 1 ], [ 2 , 3 ], [ 4 , 5 ]];

reduceRight ( array , (flattened, other) => flattened. concat (other), [])
// => [4, 5, 2, 3, 0, 1]

يرفض

على عكس filter تُرجع هذه الطريقة عناصر collection التي لا يُرجع predicate إليها الصدق.

الحجج:

@param iterable $collection المجموعة المراد التكرار عليها.

@param callable $predicate الوظيفة التي يتم استدعاؤها لكل تكرار.

يعود:

@return array المصفوفة الجديدة التي تمت تصفيتها.

مثال:

 <?php
 use function _  reject ;

$ users = [
[ ' user ' => ' barney ' , ' active ' => true ],
[ ' user ' => ' fred ' ,   ' active ' => false ]
]

reject ( $ users , ' active ' )
// => objects for ['fred']

مقاس

الحصول على حجم collection عن طريق إرجاع طولها لقيم المصفوفة أو عدد الخصائص العامة للكائنات.

الحجج:

@param (صفيف | كائن | سلسلة) $collection المجموعة المطلوب فحصها.

يعود:

@return int يُرجع حجم المجموعة.

مثال:

 <?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

بعض

يتحقق مما إذا كان predicate يُرجع الصدق لأي عنصر من عناصر collection . يتم إيقاف التكرار بمجرد إرجاع predicate إلى الحقيقة. يتم استدعاء المسند بثلاث وسائط: (القيمة، الفهرس|المفتاح، المجموعة).

الحجج:

@param iterable $collection المجموعة المراد التكرار عليها.

@param (قابل للاستدعاء | سلسلة | صفيف) المسند $ الوظيفة التي يتم استدعاؤها لكل تكرار.

يعود:

@return boolean يُرجع true إذا اجتاز أي عنصر التحقق من المسند، وإلا فهو false .

مثال:

 <?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 ' );
// => true

فرز حسب

ينشئ مصفوفة من العناصر، مرتبة بترتيب تصاعدي حسب نتائج تشغيل كل عنصر في مجموعة من خلال كل تكرار. تقوم هذه الطريقة بإجراء فرز مستقر، أي أنها تحافظ على ترتيب الفرز الأصلي للعناصر المتساوية. يتم استدعاء التكرارات باستخدام وسيطة واحدة: (القيمة).

الحجج:

@param (صفيف | كائن | خالي) $collection المجموعة المراد التكرار عليها.

@param (callable | callable[]) $iteratees التكرارات التي سيتم الفرز حسبها.

يعود:

@return array يُرجع المصفوفة التي تم فرزها حديثًا.

مثال:

 <?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]] 

تاريخ

الآن

الحصول على الطابع الزمني لعدد المللي ثانية التي انقضت منذ عصر Unix (1 يناير 1970، الساعة 00:00:00 بالتوقيت العالمي).

الحجج:

يعود:

@return int يُرجع الطابع الزمني.

مثال:

 <?php
 use function _  now ;

now ();
// => 1511180325735 

وظيفة

بعد

عكس ما before ؛ تقوم هذه الطريقة بإنشاء دالة تستدعي func بمجرد استدعائها n أو أكثر.

الحجج:

@param int $n عدد المكالمات قبل استدعاء func .

@param Callable $func الوظيفة المراد تقييدها.

يعود:

@return Callable يُرجع الوظيفة المقيدة الجديدة.

مثال:

 <?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.

آري

ينشئ دالة تستدعي func ، بما يصل إلى n من الوسائط، متجاهلاً أي وسائط إضافية.

الحجج:

@param callable $func الوظيفة التي يتم تحديد عدد الوسائط لها.

@param int $n غطاء arity.

يعود:

@return Callable يُرجع الوظيفة المحددة الجديدة.

مثال:

 <?php
 use function _  ary ;

map ([ ' 6 ' , ' 8 ' , ' 10 ' ], ary ( ' intval ' , 1 ));
// => [6, 8, 10]

قبل

ينشئ دالة تستدعي func بوسائط الدالة التي تم إنشاؤها، بينما يتم استدعاؤها أقل من n مرة. تؤدي الاستدعاءات اللاحقة للوظيفة التي تم إنشاؤها إلى إرجاع نتيجة استدعاء func الأخير.

الحجج:

@param int $n عدد المكالمات التي لم يعد يتم استدعاء func فيها.

param callable $func الوظيفة المراد تقييدها.

يعود:

@return callable يُرجع الوظيفة المقيدة الجديدة.

مثال:

 <?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.

ربط

ينشئ دالة تستدعي func مع this الربط object والأجزاء partials المُلحقة بالوسائط التي تتلقاها.

الحجج:

@param وظيفة $ قابلة للاستدعاء الوظيفة المراد ربطها.

@param (كائن | مختلط) $object ربط object func .

@param array<int, mixed> $partials الوسيطات التي سيتم تطبيقها جزئيًا.

يعود:

@return callable يُرجع الدالة المرتبطة الجديدة.

مثال:

 <?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!'

bindKey

ينشئ دالة تستدعي الطريقة $function لـ $object مع إضافة $partials إلى الوسيطات التي تتلقاها.

تختلف هذه الطريقة عن bind من خلال السماح للوظائف المرتبطة بالإشارة إلى الأساليب التي قد يتم إعادة تعريفها أو التي لم تكن موجودة بعد

الحجج:

@param object $object الكائن الذي سيتم استدعاء الطريقة عليه.

@param string $function اسم الطريقة.

@param array<int, mixed> $partials الوسيطات التي سيتم تطبيقها جزئيًا.

يعود:

@return callable يُرجع الدالة المرتبطة الجديدة.

مثال:

 <?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!'

كاري

إنشاء دالة تقبل وسيطات func وإما استدعاء func لإرجاع نتيجتها، إذا تم توفير عدد arity من الوسائط على الأقل، أو إرجاع دالة تقبل وسيطات func المتبقية، وهكذا. يمكن تحديد مدى وظيفة func إذا لم يكن func.length كافيًا.

يمكن استخدام قيمة _.curry.placeholder ، والتي تكون افتراضيًا _ في الإصدارات المتجانسة، كعنصر نائب للوسائط المتوفرة.

ملاحظة: لا تقوم هذه الطريقة بتعيين خاصية "الطول" للوظائف المتموجة.

الحجج:

@param callable $func وظيفة الكاري.

@param (int | null) $arity خاصية func .

يعود:

@return callable يُرجع الدالة الكاري الجديدة.

مثال:

 <?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]

تأخير

يستدعي func بعد wait بالمللي ثانية. يتم توفير أية وسائط إضافية للوظيفة func عند استدعائها.

الحجج:

@param قابل للاستدعاء $func وظيفة التأخير.

@param int $wait عدد المللي ثانية لتأخير الاستدعاء.

@param array<int, mixed> $args

يعود:

@return int معرف المؤقت.

مثال:

 <?php
 use function _  delay ;

delay ( function ( $ text ) {
echo $ text ;
}, 1000 , ' later ' );
// => Echo 'later' after one second.

نقف

ينشئ دالة تستدعي func مع عكس الوسائط.

الحجج:

@param callable $func الوظيفة التي يتم قلب الوسائط لها.

يعود:

@return callable يُرجع الدالة المعكوسة الجديدة.

مثال:

 <?php
 use function _  flip ;

$ flipped = flip ( function () {
return func_get_args ();
});

flipped ( ' a ' , ' b ' , ' c ' , ' d ' );
// => ['d', 'c', 'b', 'a']

حفظ

ينشئ دالة تحفظ نتيجة func . إذا تم توفير resolver ، فإنه يحدد مفتاح ذاكرة التخزين المؤقت لتخزين النتيجة بناءً على الوسائط المتوفرة للوظيفة المحفوظة. افتراضيًا، يتم استخدام الوسيطة الأولى المقدمة للوظيفة المحفوظة كمفتاح ذاكرة التخزين المؤقت للخريطة

ملاحظة: يتم عرض ذاكرة التخزين المؤقت كخاصية cache في الوظيفة المحفوظة. يمكن تخصيص إنشائه عن طريق استبدال منشئ _.memoize.Cache بآخر تقوم مثيلاته بتنفيذ واجهة أسلوب Map clear ، delete ، get ، has ، set .

الحجج:

@param callable $func الوظيفة التي سيتم حفظ مخرجاتها.

@param (قابل للاستدعاء | null) $resolver وظيفة حل مفتاح ذاكرة التخزين المؤقت.

يعود:

@return callable يُرجع الوظيفة المحفوظة الجديدة.

مثال:

 <?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']

نفي

ينشئ دالة تلغي نتيجة المسند func

الحجج:

@param callable $predicate المسند المراد نفيه.

يعود:

@return callable يُرجع الوظيفة المرفوضة الجديدة.

مثال:

 <?php
 use function _  negate ;

function isEven ( $ n ) {
return $ n % 2 == 0 ;
}

filter ([ 1 , 2 , 3 , 4 , 5 , 6 ], negate ( $ isEven ));
// => [1, 3, 5]

مرة واحدة

ينشئ وظيفة تقتصر على استدعاء func مرة واحدة. كرر الاستدعاءات للدالة لإرجاع قيمة الاستدعاء الأول. يتم استدعاء func مع وسيطات الوظيفة التي تم إنشاؤها.

الحجج:

param callable $func الوظيفة المراد تقييدها.

يعود:

@return قابلة للاستدعاء الوظيفة المقيدة الجديدة.

مثال:

 <?php
 use function _  once ;

$ initialize = once ( ' createApplication ' );
$ initialize ();
$ initialize ();
// => `createApplication` is invoked once

overArgs

ينشئ دالة تستدعي func مع تحويل وسيطاتها.

الحجج:

@param قابل للاستدعاء $func الوظيفة المراد التفافها.

@param callable[] $transforms يتم تحويل الوسيطة.

يعود:

@return قابلة للاستدعاء الوظيفة الجديدة.

مثال:

 <?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]

جزئي

ينشئ دالة تستدعي func بأجزاء partials مُلحقة بالوسيطات التي تتلقاها.

الحجج:

@param callable $func الوظيفة التي سيتم تطبيق الوسائط عليها جزئيًا.

@param array<int, mixed> $partials الوسيطات التي سيتم تطبيقها جزئيًا.

يعود:

@return callable يُرجع الوظيفة الجديدة المطبقة جزئيًا.

مثال:

 <?php
 use function _  partial ;

function greet ( $ greeting , $ name ) {
return $ greeting . ' ' . $ name ;
}

$ sayHelloTo = partial ( ' greet ' , ' hello ' );
$ sayHelloTo ( ' fred ' );
// => 'hello fred'

استراحة

ينشئ وظيفة تستدعي func مع this الارتباط للوظيفة والوسائط التي تم إنشاؤها من start وما بعدها المقدمة كصفيف.

الحجج:

param callable $ func الوظيفة لتطبيق معلمة REST على.

param (int | null) $ ابدأ موضع بدء معلمة REST.

يعود:

return callable إرجاع الوظيفة الجديدة.

مثال:

 <?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'

الانتشار

يقوم بإنشاء وظيفة تستدعي func مع this الارتباط من وظيفة إنشاء ومجموعة من الوسائط مثل Function#apply .

ملاحظة: تعتمد هذه الطريقة على مشغل الانتشار.

الحجج:

param callable $ func الوظيفة لنشر الوسائط.

param int $ ابدأ موضع بدء الانتشار.

يعود:

return callable إرجاع الوظيفة الجديدة.

مثال:

 <?php
 use function _  spread ;

$ say = spread ( function ( $ who , $ what ) {
return $ who . ' says ' . $ what ;
});

$ say ([ ' fred ' , ' hello ' ]);
// => 'fred says hello'

أحادي

يخلق وظيفة تقبل حجة واحدة ، وتجاهل أي حجج إضافية.

الحجج:

param callable $ func الوظيفة لتحديد الوسائط ل.

يعود:

RETURN يمكن استدعاء الوظيفة الجديدة المغطاة.

مثال:

 <?php
 use function _  unary ;

map ([ ' 6 ' , ' 8 ' , ' 10 ' ], unary ( ' intval ' ));
// => [6, 8, 10]

طَوّق

ينشئ وظيفة توفر value wrapper كوسيطة لها. يتم إلحاق أي وسيطات إضافية مقدمة للوظيفة لتلك المقدمة إلى wrapper .

الحجج:

param مختلطة القيمة $ القيمة للالتفاف.

param callable $ wrapper وظيفة الغلاف.

يعود:

RETURN يمكن استدعاؤها الوظيفة الجديدة.

مثال:

 <?php
 use function _  wrap ;

$ p = wrap ( ' _escape ' , function ( $ func , $ text ) {
return ' <p> ' . $ func ( $ text ) . ' </p> ' ;
});

$ p ( ' fred, barney, & pebbles ' );
// => '<p>fred, barney, &amp; pebbles</p>' 

لانج

مكافئ

يؤدي مقارنة بين قيمتين لتحديد ما إذا كانت مكافئة.

الحجج:

param مختلطة القيمة $ القيمة للمقارنة.

param مختلطة $ الأخرى القيمة الأخرى للمقارنة.

يعود:

return boolean يعود true إذا كانت القيم متكافئة ، وإلا false .

مثال:

 <?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 );
// => true

isequal

يؤدي مقارنة عميقة بين قيمتين لتحديد ما إذا كانت مكافئة.

ملاحظة: تدعم هذه الطريقة مقارنة المصفوفات ، والطغل ، وكائنات DateTime ، وكائنات الاستثناء ، و splobjectstorage ، والأرقام ، والسلاسل ، والصفائف المكتوبة ، والموارد ، وعقد DOM. تتم مقارنة الكائنات من خلال خصائصها الموروثة ، غير الموروثة.

الحجج:

param مختلطة القيمة $ القيمة للمقارنة.

param مختلطة $ الأخرى القيمة الأخرى للمقارنة.

يعود:

return bool يعود true إذا كانت القيم مكافئة ، غير false .

مثال:

 <?php
 use function _  isEqual ;


$ object = [ ' a ' => 1 ]
$ other = [ ' a ' => ' 1 ' ]

isEqual ( $ object , $ other )
// => true

$ object === $ other
// => false

iserror

يتحقق إذا كانت value هي Exception ، ParseError ، error , Throwable ، ​​soapfault , DOMException ، pdoexception` ، كائن.

الحجج:

param مختلطة قيمة $ القيمة للتحقق.

يعود:

return boolean إرجاع true إذا كانت value كائن خطأ ، وإلا false .

مثال:

 <?php
 use function _  isError ;

isError ( new  Exception ())
// => true

isError (Exception::Class)
// => false 

الرياضيات

يضيف

يضيف رقمين.

الحجج:

param (int | float | string) $ Augend الرقم الأول في إضافة.

param (int | float | string) $ إضافة الرقم الثاني في إضافة.

يعود:

regurn (int | float) إرجاع المجموع.

مثال:

 <?php
 use function _  add ;

add ( 6 , 4 );
// => 10

الأعلى

يحسب الحد الأقصى لقيمة array . إذا كانت array فارغة أو خاطئة ، يتم إرجاع NULL.

الحجج:

param (صفيف | null) $ صفيف الصفيف للتكرار أكثر.

يعود:

RETURN (int | null) إرجاع القيمة القصوى.

مثال:

 <?php
 use function _  max ;

max ([ 4 , 2 , 8 , 6 ]);
// => 8

max ([]);
// => null

ماكسبي

هذه الطريقة مثل max باستثناء أنها تقبل iteratee التي يتم استدعاؤها لكل عنصر في array لإنشاء المعيار الذي يتم من خلاله تصنيف القيمة. يتم استدعاء التكرار بحجة واحدة: (القيمة).

الحجج:

Param Array $ Array The Array للتكرار.

param (callable | string) $ iTerye the tertye ادعى لكل عنصر.

يعود:

العودة @عودة العائد أقصى قيمة.

مثال:

 <?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 المشابك داخل الحدود lower upper الشاملة.

الحجج:

param int $ رقم الرقم إلى المشبك.

param int $ أقل الحد الأدنى السفلي.

param int $ العلوي العلوي.

يعود:

regurn int إرجاع الرقم المربوطة.

مثال:

 <?php
 use function _  clamp ;

clamp (- 10 , - 5 , 5 )
// => -5

clamp ( 10 , - 5 , 5 )
// => 5

غير مسبب

يتحقق إذا كان number بين start وما يصل إلى ، ولكن ليس بما في ذلك ، end . إذا لم يتم تحديد end ، فسيتم تعيينه start start ثم ضبطه على 0 . إذا كانت start أكبر من end ، يتم تبديل params لدعم النطاقات السلبية.

الحجج:

param float $ رقم الرقم للتحقق.

param float $ بدء بداية النطاق.

param تعويم $ نهاية نهاية النطاق.

يعود:

return boolean يعود true إذا كان number في النطاق ، غير false .

مثال:

 <?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

عشوائي

ينتج رقمًا عشوائيًا بين الحدود lower upper الشاملة. إذا تم توفير وسيطة واحدة فقط 0 فسيتم إرجاع الرقم المعطى. إذا كانت floating true ، أو إما أن تكون lower أو upper ، يتم إرجاع رقم النقطة العائمة بدلاً من عدد صحيح.

الحجج:

param (int | float | bool) $ أسفل الحد الأدنى.

param (int | float | bool) $ الجزء العلوي العليا.

param (bool | null) $ floating حدد إرجاع رقم الفاصلة العائمة.

يعود:

regurn (int | float) إرجاع الرقم العشوائي.

مثال:

 <?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 

هدف

يحصل

يحصل على القيمة في مسار الكائن. إذا كانت القيمة التي تم حلها هي NULL ، فسيتم إرجاع DefaultValue في مكانها.

الحجج:

param مختلط $ كائن $ $ صفيف أو كائن لجلب القيمة من

param (Array | String) $ path dot منفصل أو صفيف السلسلة

param مختلط $ defaultValue (اختياري) القيمة التي تم إرجاعها للقيم التي لم يتم حلها أو فارغة.

يعود:

العودة @عودة القيمة التي تم حلها.

مثال:

 <?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 " );
// => ""

يختار

ينشئ كائن يتكون من خصائص object التي تم اختيارها.

الحجج:

كائن param $ كائن المصدر.

Param (String | String []) $ المسارات مسارات الخاصية للاختيار.

يعود:

regurn stdClass إرجاع الكائن الجديد.

مثال:

 <?php
 use function _  pick ;

$ object = ( object ) [ ' a ' => 1 , ' b ' => ' 2 ' , ' c ' => 3 ];

pick ( $ object , [ ' a ' , ' c ' ]);
// => (object) ['a' => 1, 'c' => 3]

بيكبي

ينشئ كائن يتكون من خصائص object predicate يرجع الحقيقة ل. يتم استدعاء المسند مع وسيطتين: (القيمة ، المفتاح).

الحجج:

param (كائن | null) $ كائن كائن المصدر.

param callable $ predicate الوظيفة التي تم استدعاؤها لكل خاصية.

يعود:

regurn stdClass إرجاع الكائن الجديد.

مثال:

 <?php
 use function _  pickBy ;

$ object = ( object ) [ ' a ' => 1 , ' b ' => ' abc ' , ' c ' => 3 ];

pickBy (object, ' is_numeric ' );
// => (object) ['a' => 1, 'c' => 3] 

تسلسل

سلسلة

ينشئ مثيلًا لفائف lodash يلف value بتسلسل سلسلة طريقة صريح ممكّن. يجب أن تكون نتيجة هذه التسلسلات غير مغلفة بـ ->value() .

الحجج:

param مختلطة القيمة $ القيمة للالتفاف.

يعود:

RETURN _ إرجاع مثيل lodash Wrapper الجديد.

مثال:

 <?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' 

خيط

كاميل

يحول string إلى حالة الجمل.

الحجج:

@param string $ سلسلة السلسلة لتحويلها.

يعود:

@regurn string إرجاع السلسلة المغطاة الجمل.

مثال:

 <?php
 use function _  camelCase ;

camelCase ( ' Foo Bar ' )
// => 'fooBar'

camelCase ( ' --foo-bar-- ' )
// => 'fooBar'

camelCase ( ' __FOO_BAR__ ' )
// => 'fooBar'

الاستفادة

يحول الحرف الأول من string إلى العلبة العلوية والبقاء إلى الحالة السفلية.

الحجج:

param string $ سلسلة السلسلة للاستفادة منها.

يعود:

@regurn string إرجاع السلسلة ذات الرسملة.

مثال:

 <?php
 use function _  capitalize ;

capitalize ( ' FRED ' )
// => 'Fred'

ديبور

string Deburrs عن طريق تحويل [ملحق Latin-1] (https => // en.wikipedia.org/wiki/latin-1_supplement_(unicode_block)#character_table) و [Latin Extended-A] (https => // en.wikipedia. رسائل ORG/WIKI/LATIN_EXTENDED-A) إلى الحروف اللاتينية الأساسية وإزالة [الجمع بين علامات التشكيل] (HTTPS => // en.wikipedia.org/wiki/combining_diacritical_marks).

الحجج:

param string $ سلسلة السلسلة إلى Deburr.

يعود:

@regurn string إرجاع السلسلة deburred.

مثال:

 <?php
 use function _  deburr ;

deburr ( ' déjà vu ' )
// => 'deja vu'

ينتهي مع

يتحقق إذا انتهت string مع السلسلة الهدف المحددة.

الحجج:

param string $ سلسلة السلسلة لتفقدها.

param string $ تهدف السلسلة للبحث عنها.

param int $ موقف للبحث عن.

يعود:

RETURN BOOLEEAN يعود true إذا انتهت string مع target ، وإلا false .

مثال:

 <?php
 use function _  endsWith ;

endsWith ( ' abc ' , ' c ' )
// => true

endsWith ( ' abc ' , ' b ' )
// => false

endsWith ( ' abc ' , ' b ' , 2 )
// => true

يهرب

يحول الأحرف "و" و "<" و ">" و "" و "" في string إلى كيانات HTML المقابلة.

على الرغم من أن الحرف ">" يتم هروبه من أجل التماثل ، إلا أن أحرفًا مثل ">" و "/" لا تحتاج إلى الهروب في HTML وليس لها معنى خاص ما لم تكن جزءًا من علامة أو قيمة سمة غير مؤهلة. انظر مقالة Mathias Bynens (تحت "حقيقة ممتعة شبه ذات صلة") لمزيد من التفاصيل.

عند العمل مع HTML ، يجب أن تقتبس دائمًا من قيم السمات لتقليل متجهات XSS.

الحجج:

param string $ سلسلة السلسلة للهروب.

يعود:

@regurn string إرجاع السلسلة الهاربة.

مثال:

 <?php
 use function _  escape ;

escape ( ' fred, barney, & pebbles ' )
// => 'fred, barney, &amp pebbles'

ESCAPEREGEXP

يهرب من الشخصيات الخاصة RegExp "^" ، "$" ، "" ، "." ، "*" ، "+" ، "؟" ، ("،") ، "[" ، "،" ، "{ "،"} "، و" | " في string .

الحجج:

param string $ سلسلة السلسلة للهروب.

يعود:

@regurn string إرجاع السلسلة الهاربة.

مثال:

 <?php
 use function _  escapeRegExp ;

escapeRegExp ( ' [lodash](https://lodash.com/) ' )
// => '[lodash](https://lodash.com/)'

kebabcase

يحول string إلى حالة الكباب.

الحجج:

@param string $ سلسلة السلسلة لتحويلها.

يعود:

@regurn string إرجاع سلسلة كباب غلاف.

مثال:

 <?php
 use function _  kebabCase ;

kebabCase ( ' Foo Bar ' )
// => 'foo-bar'

kebabCase ( ' fooBar ' )
// => 'foo-bar'

kebabCase ( ' __FOO_BAR__ ' )
// => 'foo-bar'

صغيرة

يحول string ، ككلمات مفصولة بالفضاء ، إلى الحالة السفلية.

الحجج:

@param string $ سلسلة السلسلة لتحويلها.

يعود:

@regurn string إرجاع السلسلة المغطاة السفلية.

مثال:

 <?php
 use function _  lowerCase ;

lowerCase ( ' --Foo-Bar-- ' )
// => 'foo bar'

lowerCase ( ' fooBar ' )
// => 'foo bar'

lowerCase ( ' __FOO_BAR__ ' )
// => 'foo bar'

السفلى

يحول الحرف الأول من string إلى الحالة السفلية.

الحجج:

@param string $ سلسلة السلسلة لتحويلها.

يعود:

regurn string إرجاع السلسلة المحولة.

مثال:

 <?php
 use function _  lowerFirst ;

lowerFirst ( ' Fred ' )
// => 'fred'

lowerFirst ( ' FRED ' )
// => 'fRED'

وسادة

سلالات string على الجانبين اليسرى واليمين إذا كان أقصر من length . يتم اقتطاع أحرف الحشو إذا لم يكن من الممكن تقسيمها بالتساوي على length .

الحجج:

param string $ سلسلة السلسلة إلى وسادة.

param int $ طول الحشو.

param string $ chars السلسلة المستخدمة كحشو.

يعود:

@regurn string إرجاع السلسلة المبطنة.

مثال:

 <?php
 use function _  pad ;

pad ( ' abc ' , 8 )
// => '  abc   '

pad ( ' abc ' , 8 , ' _- ' )
// => '_-abc_-_'

pad ( ' abc ' , 2 )
// => 'abc'

padend

سلالات string على الجانب الأيمن إذا كان أقصر من length . يتم اقتطاع أحرف الحشو إذا تجاوزت length .

الحجج:

param string $ سلسلة السلسلة إلى وسادة.

param int $ طول الحشو.

param string $ chars السلسلة المستخدمة كحشو.

يعود:

@regurn string إرجاع السلسلة المبطنة.

مثال:

 <?php
 use function _  padEnd ;

padEnd ( ' abc ' , 6 )
// => 'abc   '

padEnd ( ' abc ' , 6 , ' _- ' )
// => 'abc_-_'

padEnd ( ' abc ' , 2 )
// => 'abc'

Padstart

سلالات string على الجانب الأيسر إذا كانت أقصر من length . يتم اقتطاع أحرف الحشو إذا تجاوزت length .

حجج S:

param string $ string = '' السلسلة إلى وسادة.

param int $ طول الحشو.

param string $ chars السلسلة المستخدمة كحشو.

يعود:

@regurn string إرجاع السلسلة المبطنة.

مثال:

 <?php
 use function _  padStart ;

padStart ( ' abc ' , 6 )
// => '   abc'

padStart ( ' abc ' , 6 , ' _- ' )
// => '_-_abc'

padStart ( ' abc ' , 2 )
// => 'abc'

Parseint

يحول string إلى عدد صحيح من Radix المحدد. إذا كان radix undefined أو 0 ، يتم استخدام radix 10 ما لم تكن string سداسي عشرة ، وفي هذه الحالة يتم استخدام radix 16 .

ملاحظة: تستخدم هذه الطريقة صب عدد صحيح في PHP ، والذي لا يتماشى بالضرورة مع تنفيذ ES5 parseInt .

الحجج:

param (int | float | string) $ سلسلة السلسلة لتحويلها.

param int $ radix the radix لتفسير string بواسطة.

يعود:

regurn int إرجاع عدد صحيح تم تحويله.

مثال:

 <?php
 use function _  parseInt ;

parseInt ( ' 08 ' )
// => 8

يكرر

يكرر السلسلة المعطاة n مرات.

الحجج:

param string $ سلسلة السلسلة لتكرارها.

param int $ n عدد المرات لتكرار السلسلة.

يعود:

@regurn string إرجاع السلسلة المتكررة.

مثال:

 <?php
 use function _  repeat ;

repeat ( ' * ' , 3 )
// => '***'

repeat ( ' abc ' , 2 )
// => 'abcabc'

repeat ( ' abc ' , 0 )
// => ''

يستبدل

استبدال المطابقات pattern في string مع replacement .

ملاحظة: تعتمد هذه الطريقة على String#replace .

الحجج:

param string $ سلسلة السلسلة لتعديل.

param string $ نمط النمط لاستبداله.

param (callable | String) $ استبدال استبدال المطابقة.

يعود:

@regurn string إرجاع السلسلة المعدلة.

مثال:

 <?php
 use function _  replace ;

replace ( ' Hi Fred ' , ' Fred ' , ' Barney ' )
// => 'Hi Barney'

SnakeCase

يحول string إلى حالة الأفعى.

الحجج:

@param string $ سلسلة السلسلة لتحويلها.

يعود:

@regurn string إرجاع سلسلة الغلاف الأفعى.

مثال:

 <?php
 use function _  snakeCase ;

snakeCase ( ' Foo Bar ' )
// => 'foo_bar'

snakeCase ( ' fooBar ' )
// => 'foo_bar'

snakeCase ( ' --FOO-BAR-- ' )
// => 'foo_bar'

ينقسم

تقسيم string بواسطة separator .

ملاحظة: تعتمد هذه الطريقة على String#split .

الحجج:

param string $ سلسلة السلسلة لتقسيمها.

param string $ فاصل نمط الفاصل لتقسيمه.

param int $ الحد من الطول لاقتطاع النتائج إلى.

يعود:

RETURN ARRAY إرجاع شرائح السلسلة.

مثال:

 <?php
 use function _  split ;

split ( ' a-b-c ' , ' - ' , 2 )
// => ['a', 'b']

startcase

يحول string لبدء الحالة.

الحجج:

@param string $ سلسلة السلسلة لتحويلها.

يعود:

regurn string إرجاع سلسلة START CASED.

مثال:

 <?php
 use function _  startCase ;

startCase ( ' --foo-bar-- ' )
// => 'Foo Bar'

startCase ( ' fooBar ' )
// => 'Foo Bar'

startCase ( ' __FOO_BAR__ ' )
// => 'FOO BAR'

يبدأ مع

يتحقق إذا بدأت string مع السلسلة الهدف المحددة.

الحجج:

param string $ سلسلة السلسلة لتفقدها.

param string $ تهدف السلسلة للبحث عنها.

param int $ موقف للبحث من.

يعود:

RETURN BOOULEAN يعيد true إذا بدأت string مع target ، وإلا false .

مثال:

 <?php
 use function _  startsWith ;

startsWith ( ' abc ' , ' a ' )
// => true

startsWith ( ' abc ' , ' b ' )
// => false

startsWith ( ' abc ' , ' b ' , 1 )
// => true

نموذج

يقوم بإنشاء وظيفة قالب مجمعة يمكن أن تتنازل عن خصائص البيانات في محددات "interpolte" ، وخصائص بيانات HTML-ESCAPE في "Depress" ، وتنفيذ PHP في "تقييم" المحددات ". يمكن الوصول إلى خصائص البيانات كمتغيرات مجانية في القالب. إذا تم إعطاء كائن إعداد ، فإنه يأخذ الأسبقية أكثر من قيم $templateSettings .

regexp $ Options ['Escape'] = _ :: $ templatesettings ['Escape'] the HTML "Escape" delimiter. regexp $ reports ['evalate'] = _ :: $ templatesettings ['aluadate'] "تقييم" المحدد. خيارات Array $ ['Imports'] = _ :: $ tapplatesettings ['Imports'] كائن للاستيراد إلى القالب كمتغيرات حرة. regexp $ reports ['interpolate'] = _ :: $ templatesettings ['interpolate'] The "interpolate" delimiter.

الحجج:

param string $ سلسلة القالب.

Param Array $ خيارات مجموعة الخيارات.

يعود:

RETURN يمكن callable إرجاع وظيفة القالب المترجمة.

مثال:

 <?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>&lt;script&gt;</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 ;

تولور

يحول string ، ككل ، إلى الحالة السفلية

الحجج:

@param string $ سلسلة السلسلة لتحويلها.

يعود:

@regurn string إرجاع السلسلة المغطاة السفلية.

مثال:

 <?php
 use function _  toLower ;

toLower ( ' --Foo-Bar-- ' )
// => '--foo-bar--'

toLower ( ' fooBar ' )
// => 'foobar'

toLower ( ' __FOO_BAR__ ' )
// => '__foo_bar__'

توبر

يحول string ، ككل ، إلى الحالة العليا

الحجج:

@param string $ سلسلة السلسلة لتحويلها.

يعود:

@regurn string إرجاع السلسلة الغازية العلوية.

مثال:

 <?php
 use function _  toUpper ;

toUpper ( ' --foo-bar-- ' )
// => '--FOO-BAR--'

toUpper ( ' fooBar ' )
// => 'FOOBAR'

toUpper ( ' __foo_bar__ ' )
// => '__FOO_BAR__'

تقليم

يزيل المسافة البيضاء الرائدة والمتزايدة أو الأحرف المحددة من string .

الحجج:

@param string $ سلسلة السلسلة لتقليم.

param string $ chars الأحرف لتقليص.

يعود:

@regurn string إرجاع السلسلة المقطوعة.

مثال:

 <?php
 use function _  trim ;

trim ( '  abc  ' )
// => 'abc'

trim ( ' -_-abc-_- ' , ' _- ' )
// => 'abc'

تقليم

يزيل مسافة بيضاء زائدة أو أحرف محددة من string .

الحجج:

@param string $ سلسلة السلسلة لتقليم.

param string $ chars الأحرف لتقليص.

يعود:

@regurn string إرجاع السلسلة المقطوعة.

مثال:

 <?php
 use function _  trimEnd ;

trimEnd ( '  abc  ' )
// => '  abc'

trimEnd ( ' -_-abc-_- ' , ' _- ' )
// => '-_-abc'

trimstart

يزيل المسافة البيضاء الرائدة أو الأحرف المحددة من string .

الحجج:

@param string $ سلسلة السلسلة لتقليم.

param string $ chars الأحرف لتقليص.

يعود:

@regurn string إرجاع السلسلة المقطوعة.

مثال:

 <?php
 use function _  trimStart ;

trimStart ( '  abc  ' )
// => 'abc  '

trimStart ( ' -_-abc-_- ' , ' _- ' )
// => 'abc-_-'

اقتطاع

تقطع string إذا كانت أطول من طول السلسلة القصوى المعطى. يتم استبدال الأحرف الأخيرة من السلسلة المقطوعة بسلسلة الإغفال التي تتخلف عن "...".

الطول = 30 طول السلسلة القصوى. الإغفال = '...' تم حذف السلسلة للإشارة إلى النص. فاصل نمط الفاصل لاقتطاع إلى.

الحجج:

param string $ سلسلة السلسلة لاقتطاعها.

Param Array $ خيارات كائن الخيارات.

يعود:

@regurn string إرجاع السلسلة المقطوعة.

مثال:

 <?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 [...]'

غير مرغوب فيه

عكس escape يحول هذه الطريقة كيانات HTML & ، < ، > ، " و ' في string إلى شخصياتها المقابلة.

الحجج:

param string $ سلسلة السلسلة إلى unescape.

يعود:

@regurn string إرجاع السلسلة غير المقيدة.

مثال:

 <?php
 use function _  unescape ;

unescape ( ' fred, barney, &amp; pebbles ' )
// => 'fred, barney, & pebbles'

كبار

يحول string ، ككلمات مفصولة بالفضاء ، إلى الحالة العليا.

الحجج:

@param string $ سلسلة السلسلة لتحويلها.

يعود:

@regurn string إرجاع سلسلة الغلاف العلوي

مثال:

 <?php
 use function _  upperCase ;

upperCase ( ' --foo-bar ' )
// => 'FOO BAR'

upperCase ( ' fooBar ' )
// => 'FOO BAR'

upperCase ( ' __foo_bar__ ' )
// => 'FOO BAR'

العلوي

يحول الحرف الأول من string إلى العلبة العليا.

الحجج:

@param string $ سلسلة السلسلة لتحويلها.

يعود:

regurn string إرجاع السلسلة المحولة.

مثال:

 <?php
 use function _  upperFirst ;

upperFirst ( ' fred ' )
// => 'Fred'

upperFirst ( ' FRED ' )
// => 'FRED'

كلمات

تقسيم string إلى مجموعة من كلماتها.

الحجج:

param string $ سلسلة السلسلة لتفقدها.

param string $ نمط النمط لمطابقة الكلمات.

يعود:

regurn array إرجاع كلمات string .

مثال:

 <?php
 use function _  words ;

words ( ' fred, barney, & pebbles ' )
// => ['fred', 'barney', 'pebbles']

words ( ' fred, barney, & pebbles ' , ' /[^, ]+/g ' )
// => ['fred', 'barney', '&', 'pebbles'] 

فائدة

محاولة

محاولات لاستدعاء func ، إما النتيجة أو كائن الخطأ الذي تم صيده. يتم توفير أي حجج إضافية إلى func عندما يتم استدعاؤها.

حجج S:

param callable $ func الوظيفة لمحاولة.

@param array <int ، mixed> $ args الحجج لاستدعاء func مع.

يعود:

regurn (مختلط | رمي) إرجاع نتيجة func أو كائن الخطأ.

مثال:

 <?php
 use function _  attempt ;

// Avoid throwing errors for invalid PDO data source.
$ elements = attempt ( function () {
new  PDO ( null );
});

if ( isError ( $ elements )) {
$ elements = [];
}

الافتراضي

يتحقق القيمة لتحديد ما إذا كان ينبغي إرجاع القيمة الافتراضية في مكانها. يتم إرجاع القيمة الافتراضية إذا كانت القيمة نان أو خالية.

الحجج:

param مختلطة قيمة $ أي قيمة.

param مختلط قيمة $ defaultValue للعودة عندما تكون قيمة $ لاغية أو nan

يعود:

@العودة value عائدات عوائد.

مثال:

 <?php
 use function _  defaultTo ;

$ a = null ;

defaultTo ( $ a , " default " );
// => "default"

$ a = " x " ;

defaultTo ( $ a , " default " );
// => "x"

هوية

هذه الطريقة تُرجع الوسيطة الأولى التي يتلقاها.

الحجج:

param مختلطة قيمة $ أي قيمة.

يعود:

@العودة value عائدات عوائد.

مثال:

 <?php
 use function _  identity ;

$ object = [ ' a ' => 1 ];

identity ( $ object ) === $ object ;
// => true

ملكية

ينشئ وظيفة تُرجع القيمة في path كائن معين.

الحجج:

param (Array | String) $ PATH مسار العقار للحصول على.

يعود:

RETURN يمكن callable إرجاع وظيفة الإكسسور الجديدة.

مثال:

 <?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]