Download the PHP package rikudou/iterables without Composer
On this page you can find all versions of the php package rikudou/iterables. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download rikudou/iterables
More information about rikudou/iterables
Files in rikudou/iterables
Package iterables
Short Description Provides some cool iterable functions complementing the built-in array functions
License MIT
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package iterables
A simple set of functions that reimplement PHP's built-in array functions but optimize memory usage by using Generators. These functions also accept any iterable, not just arrays, making them more flexible when working with large datasets or data streams.
So, these two are equivalent:
The difference is mainly with other iterables:
In the above case there's not really much difference
(except that you can feed results from methods returning iterable directly and avoid unnecessary code),
but imagine there's a billion rows instead of 3. And imagine it's a complex object from the database, not an integer.
Note that some of the functions need to traverse the whole iterable, so you don't gain any memory advantages, but you can still feed any iterable into it directly, which is nice.
Function list
Iterables::map()->array_map()Iterables::filter()->array_filter()Iterables::diff()->array_diff()- requires full traversal of the iterable
Iterables::contains()->in_array()- unlike the built-in version, this is strict by default
- can potentially traverse the whole iterable, until a match is found
Iterables::firstValue()-> equivalent of$array[array_key_first($array)]Iterables::count()->count()- if the iterable does not implement
Countable, requires full traversal
- if the iterable does not implement
Iterables::find()->array_find()- can potentially traverse the whole iterable, until a match is found
Iterables::findKey()->array_find_key()- can potentially traverse the whole iterable, until a match is found
Iterables::any()->array_any()- can potentially traverse the whole iterable, until a match is found
Iterables::all()->array_all()- can potentially traverse the whole iterable, unless any item does not match the callback earlier
Iterables::combine()->array_combine()Iterables::zip()-> no php equivalent, simply yields from all input iterables one by one
Rewindable and cacheable generators
There are two helper objects, RewindableGenerator and CacheableGenerator. Both solve the issue of iterating over
a Generator multiple times in a different way.
RewindableGenerator iterates over the generator over and over, while CacheableGenerator only traverses it once
and afterwards caches the values in memory.
RewindableGenerator is more useful when working with large datasets, because it only ever holds one item in memory.
It accepts a callable argument which will be called every time the original generator is exhausted.
CacheableGenerator accepts the Generator object directly and is useful if you don't care about all the values being
held in memory at once. It's more memory-efficient if you potentially don't iterate over the whole object.
Examples
Rewindable generator
When ran, this is the result:
Cacheable generator
Note: The CacheableGenerator stores data either using the ds extension or an internal fallback class. While the fallback class works, it is not as optimized. For better performance, it's highly recommended to install the ds extension. No additional configuration is needed—the generator will automatically use the ds extension if it's available.
When ran, this is the result:
