Make your array usage quite easy and fast.
You have to provide you array to constructor and after that you can do a lot of operations on haystack via class methods.
// Some array to be processed.
$array = [
[0, 1, 2, 3, 5],
'fruits' => ['apple', 'orange'],
'persons' => [
'john_doe' => [
'name' => 'John Doe',
'cars' => ['bmw', 'audi'],
'isActive' => true,
'comment' => 'some description',
],
'mike_shepard' => [
'name' => 'Mike Shepard',
'cars' => [],
'isActive' => false,
'comment' => null
],
]
];
// Making FlexArray.
$array = new FlexArray($array);- get
- getInteger
- getFloat
- getString
- getBoolean
- getAny
- getAll
- getKeys
- getAllBut
- getAllIntegers
- getAllStrings
- getAllBooleans
- getAllCleaned
- getFirst
- getFirstKey
- getLast
- getLastKey
- getByIndex
- getKeyOfIndex
- getUpTo
- implodeAll
- implode
- implodeKeys
- count
- keyOf
- keysOf
- indexOf
- indexesOf
- binarySearch
- toJson
- touch
- findValues
- isEmpty
- keyExists
- hasKeys
- hasAnyKey
- hasValues
- hasAnyValue
- inCount
- assertEqualsByKey
- assertAnyEqualsByKey
get(int|string $key, mixed $default = null): mixed|nullReturns value from haystack by $key or $default (null on default) on not set.
getInteger(int|string $key, mixed $default = null): ?intReturns value from haystack by $key cast to integer or $default (null on default) on not set.
getFloat(int|string $key, mixed $default = null): ?floatReturns value from haystack by $key cast to float or $default (null on default) on not set.
getString(int|string $key, mixed $default = null): ?stringReturns value from haystack by $key cast to string or $default (null on default) on not set.
getBoolean(int|string $key, mixed $default = null): ?boolReturns value from haystack by $key cast to boolean or $default (null on default) on not set.
getAny(int|string ...$keys): mixed|nullReturns value first found by $keys or null on not found.
getAll(): arrayReturns haystack as array.
getKeys(): arrayReturn keys of the haystack.
getAllBut(int|string ...$keys): arrayReturns list of haystack values but provided in $keys.
getAllIntegers(): arrayReturns list of integer values indexed by its keys.
getAllStrings(): arrayReturns list of string values indexed by its keys.
getAllBooleans(): arrayReturns list of boolean values indexed by its keys.
getAllClean(): arrayReturns the haystack of not real empty values.
getFirst(): mixedReturns the first element.
getFirstKey(): int|string|nullReturns first key of the haystack or null on empty haystack.
getLast(): mixedReturns the last element.
getLastKey(): int|string|nullReturns last key of the haystack or null on empty haystack.
getByIndex(int $index): mixedReturns value by index or nul if $index is not in haystack length. Pass negative number for reverse search.
getKeyOfIndex(int $index): int|string|nullReturns key of integer index in the haystack or nul if $index is not in haystack length. Pass negative number for reverse search.
getUpTo(int $index): arrayReturn values up to $index. Pass negative number for reverse search.
implodeAll(string $separator, bool $associative = false): stringReturns array values imploded to string recursively.
Pass true in $associative to represent in indexed by its keys.
implode(string $separator, bool $associative = false): stringReturns only scalar values in the haystack as string.
Pass true in $associative to represent in indexed by its keys.
implodeKeys(string $separator): stringReturns haystack keys as string.
count(): intReturns the haystack length.
keyOf(int|string $key): int|string|nullReturns key of value in the haystack or null on found.
keysOf(int|string $key): arrayReturns list of keys for haystack values.
indexOf(mixed $needle): int|nullReturns integer index of value or null on not found.
indexesOf(mixed $needle): arrayReturns list of integer indexes of provided values.
binarySearch(int $needle): int|nullBinary search method for integer value in haystack. Sorts the haystack due the process. Returns the integer index of value on found or null on not.
toJson(): stringRepresents haystack in JSON string content. Trows Exception on decode error.
touch(int|string ...$keys): arrayReturns only scalar values in the haystack as string.
Pass true in $associative to represent in indexed by its keys.
findValues(mixed ...$values): arrayReturns list of found values associated with found keys in haystack.
set(int|string $key, mixed $value): selfSets value by $key.
prepend(mixed $value): selfAdds value to haystack to the top of haystack.
append(mixed $value): selfAdds value to haystack in the end.
delete(int|string $key): selfDeletes value by $key.
deleteOnFound(mixed ...$values): selfRemove haystack elements by values if exists.
deleteFirst(): selfDeletes the first element.
deleteLast(): selfDeletes the last element.
deleteByIndex(int|string $key): selfDeletes element by index.
deleteAll(): selfDelete all values and sets empty array to haystack.
flip(): selfFlips the haystack.
merge(array ...$arrays): selfMerges the elements of one or more arrays together.
unique(int $flags = SORT_STRING): selfReturns haystack keys as string.
Available flags
- SORT_REGULAR - compare items normally (don't change types)
- SORT_NUMERIC - compare items numerically
- SORT_STRING - compare items as strings
- SORT_LOCALE_STRING - compare items as strings, based on the current locale.
sort(int $flags = SORT_REGULAR): selfSort haystack.
Available flags
- SORT_REGULAR - compare items normally; the details are described in the comparison operators section
- SORT_NUMERIC - compare items numerically
- SORT_STRING - compare items as strings
- SORT_LOCALE_STRING - compare items as strings, based on the current locale. It uses the locale, which can be changed using
setlocale() - SORT_NATURAL - compare items as strings using "natural ordering" like
natsort() - SORT_FLAG_CASE - can be combined (bitwise OR) with SORT_STRING or SORT_NATURAL to sort strings case-insensitively
rsort(int $flags = SORT_REGULAR): selfSort haystack in reverse order.
Available flags
- SORT_REGULAR - compare items normally; the details are described in the comparison operators section
- SORT_NUMERIC - compare items numerically
- SORT_STRING - compare items as strings
- SORT_LOCALE_STRING - compare items as strings, based on the current locale. It uses the locale, which can be changed using
setlocale() - SORT_NATURAL - compare items as strings using "natural ordering" like
natsort() - SORT_FLAG_CASE - can be combined (bitwise OR) with SORT_STRING or SORT_NATURAL to sort strings case-insensitively
ksort(int $flags = SORT_REGULAR): selfSort the haystack by keys.
Available flags
- SORT_REGULAR - compare items normally; the details are described in the comparison operators section
- SORT_NUMERIC - compare items numerically
- SORT_STRING - compare items as strings
- SORT_LOCALE_STRING - compare items as strings, based on the current locale. It uses the locale, which can be changed using
setlocale() - SORT_NATURAL - compare items as strings using "natural ordering" like
natsort() - SORT_FLAG_CASE - can be combined (bitwise OR) with SORT_STRING or SORT_NATURAL to sort strings case-insensitively
krsort(int $flags = SORT_REGULAR): selfSort the haystack by keys in reverse order.
Available flags
- SORT_REGULAR - compare items normally; the details are described in the comparison operators section
- SORT_NUMERIC - compare items numerically
- SORT_STRING - compare items as strings
- SORT_LOCALE_STRING - compare items as strings, based on the current locale. It uses the locale, which can be changed using
setlocale() - SORT_NATURAL - compare items as strings using "natural ordering" like
natsort() - SORT_FLAG_CASE - can be combined (bitwise OR) with SORT_STRING or SORT_NATURAL to sort strings case-insensitively
asort(int $flags = SORT_REGULAR): selfSort an array and maintain index association.
Available flags
- SORT_REGULAR - compare items normally; the details are described in the comparison operators section
- SORT_NUMERIC - compare items numerically
- SORT_STRING - compare items as strings
- SORT_LOCALE_STRING - compare items as strings, based on the current locale. It uses the locale, which can be changed using
setlocale() - SORT_NATURAL - compare items as strings using "natural ordering" like
natsort() - SORT_FLAG_CASE - can be combined (bitwise OR) with SORT_STRING or SORT_NATURAL to sort strings case-insensitively
arsort(int $flags = SORT_REGULAR): selfSort an array and maintain index association in reverse order.
Available flags
- SORT_REGULAR - compare items normally; the details are described in the comparison operators section
- SORT_NUMERIC - compare items numerically
- SORT_STRING - compare items as strings
- SORT_LOCALE_STRING - compare items as strings, based on the current locale. It uses the locale, which can be changed using
setlocale() - SORT_NATURAL - compare items as strings using "natural ordering" like
natsort() - SORT_FLAG_CASE - can be combined (bitwise OR) with SORT_STRING or SORT_NATURAL to sort strings case-insensitively
clean(): selfCleans real empty values in the haystack.
createBy(int|string $key): selfCreates and returns inner collection (new static()) by $key if indexed value in the haystack is array. Otherwise, collection with empty haystack returns. Now, inner array is available to processed with all described methods.
createByFirst(): selfCreates class object by first element.
createByLast(): selfCreates class object by last element.
createByIndex(): selfCreates class object by element located by index. Pass negative number to get it in reverse order.
isEmpty(int|string $key): boolDefines if value by $key exists and is not empty
keyExists(int|string $key): boolDefines if the given key or index exists in the haystack even nullable.
hasKeys(mixed ...$keys): boolDefines if all provided keys exists.
hasAnyKey(mixed ...$keys): boolDefines if the haystack has any value (even nullable) indexed by keys provided.
hasValues(mixed ...$values): boolDefines if the haystack has any value provided.
hasAnyValue(mixed ...$values): boolDefines if the haystack has any value provided.
inCount(int ...$count): boolDefines if the haystack length in provided value.
assertEqualsByKey(int|string $key, mixed ...$values): boolAsserts if each value identically equals the value in the haystack by key.
assertAnyEqualsByKey(int|string $key, mixed ...$values): boolAsserts if any value identically equals the value in the haystack by key.
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent