mirrors/phobos
1
0
Fork 0
mirror of https://github.com/dlang/phobos.git synced 2025-05-06 19:16:13 +03:00
Code Issues Projects Releases Packages Wiki Activity Actions

Add REF-erences to the text in std.algorithm.iteration.cache

Browse source
This commit is contained in:
Sebastian Wilzbach 2018-03-25 21:44:11 +02:00
parent 4e00114390
commit be7dd97d2f
1 changed files with 6 additions and 6 deletions
Download patch file Download diff file Expand all files Collapse all files

12
std/algorithm/iteration.d
View file

@ -119,16 +119,16 @@ if (fun.length >= 1)
}
/++
`cache` eagerly evaluates `front` of `range`
on each construction or call to `popFront`,
`cache` eagerly evaluates $(REF_ALTTEXT front, front, std,_range,primitives) of `range`
on each construction or call to $(REF_ALTTEXT popFront, popFront, std,_range,primitives),
to store the result in a _cache.
The result is then directly returned when `front` is called,
The result is then directly returned when $(REF_ALTTEXT front, front, std,_range,primitives) is called,
rather than re-evaluated.
This can be a useful function to place in a chain, after functions
that have expensive evaluation, as a lazy alternative to $(REF array, std,array).
In particular, it can be placed after a call to `map`, or before a call
to `filter` or `tee`.
In particular, it can be placed after a call to $(LREF map), or before a call
$(REF filter, std,_range) or $(REF tee, std,_range)
`cache` may provide
$(REF_ALTTEXT bidirectional _range, isBidirectionalRange, std,_range,primitives)
@ -148,7 +148,7 @@ Params:
range = an $(REF_ALTTEXT input _range, isInputRange, std,_range,primitives)
Returns:
an input _range with the cached values of _range
An $(REF_ALTTEXT input _range, isInputRange, std,_range,primitives) with the cached values of _range
+/
auto cache(Range)(Range range)
if (isInputRange!Range)