mirrors/phobos
1
0
Fork 0
mirror of https://github.com/dlang/phobos.git synced 2025-04-29 22:50:38 +03:00
Code Issues Projects Releases Packages Wiki Activity Actions

Merge pull request #4004 from quickfur/cache-ddoc

Browse source 
[doc only] Improve ddoc for std.algorithm.iteration.cache
This commit is contained in:
Robert Schadek 2016-02-25 12:46:09 +01:00
commit 5e5a8010ef
1 changed files with 5 additions and 5 deletions
Download patch file Download diff file Expand all files Collapse all files

10
std/algorithm/iteration.d
View file

@ -197,14 +197,14 @@ if (isBidirectionalRange!Range)
/++
Tip: $(D cache) is eager when evaluating elements. If calling front on the
underlying range has a side effect, it will be observeable before calling
front on the actual cached range.
underlying _range has a side effect, it will be observeable before calling
front on the actual cached _range.
Furtermore, care should be taken composing $(D cache) with $(XREF _range,take).
Furthermore, care should be taken composing $(D cache) with $(XREF _range,take).
By placing $(D take) before $(D cache), then $(D cache) will be "aware"
of when the range ends, and correctly stop caching elements when needed.
of when the _range ends, and correctly stop caching elements when needed.
If calling front has no side effect though, placing $(D take) after $(D cache)
may yield a faster range.
may yield a faster _range.
Either way, the resulting ranges will be equivalent, but maybe not at the
same cost or side effects.