Arrays\tail()
At a glance — Direct call — not a Closure constructor. For Generators it streams lazily; for arrays it returns a new array (or
null when empty).
Returns the remainder of an array or iterable after the first element has been removed. An array returns either a new array (or null if empty). A Generator returns a Generator that lazily yields every element after the first; an empty Generator source yields an empty Generator, not null.
/**
* @param iterable<int|string, mixed> $source
* @return array<int|string, mixed>|\Generator<int|string, mixed>|null
*/
Arrays\tail(iterable $source)Examples
Partial Application
This can be used to create a simple closure which can be used as a regular function.
var_dump(Arrays\tail(['a', 'b', 'c'])); // ['b', 'c']
var_dump(Arrays\tail(['only'])); // []
var_dump(Arrays\tail([])); // NULLWorks with Iterables & Generators
Accepts a Generator or any Traversable as input.
$gen = (function () { yield 'a'; yield 'b'; yield 'c'; })();
foreach (Arrays\tail($gen) as $v) echo $v; // bcDetails
- Group: Arrays
- Subgroup: Array access
- Since: 0.1.0
- Source:
Arrays Functions
- Arrays\append()
- Arrays\arrayCompiler()
- Arrays\arrayCompilerTyped()
- Arrays\arsort()
- Arrays\asort()
- Arrays\chunk()
- Arrays\column()
- Arrays\each()
- Arrays\filter()
- Arrays\filterAll()
- Arrays\filterAnd()
- Arrays\filterAny()
- Arrays\filterCount()
- Arrays\filterFirst()
- Arrays\filterKey()
- Arrays\filterLast()
- Arrays\filterMap()
- Arrays\filterOr()
- Arrays\flatMap()
- Arrays\flattenByN()
- Arrays\fold()
- Arrays\foldKeys()
- Arrays\foldR()
- Arrays\groupBy()
- Arrays\head()
- Arrays\krsort()
- Arrays\ksort()
- Arrays\last()
- Arrays\map()
- Arrays\mapKey()
- Arrays\mapWith()
- Arrays\mapWithKey()
- Arrays\natcasesort()
- Arrays\natsort()
- Arrays\partition()
- Arrays\pick()
- Arrays\prepend()
- Arrays\replace()
- Arrays\replaceRecursive()
- Arrays\rsort()
- Arrays\scan()
- Arrays\scanR()
- Arrays\sort()
- Arrays\sumWhere()
- Arrays\tail()
- Arrays\take()
- Arrays\takeLast()
- Arrays\takeUntil()
- Arrays\takeWhile()
- Arrays\toJson()
- Arrays\toObject()
- Arrays\toString()
- Arrays\uasort()
- Arrays\uksort()
- Arrays\usort()
- Arrays\zip()