mirrors/phobos
1
0
Fork 0
mirror of https://github.com/dlang/phobos.git synced 2025-05-01 15:40:36 +03:00
Code Issues Projects Releases Packages Wiki Activity Actions

Improve docs for findAmong().

Browse source
This commit is contained in:
H. S. Teoh 2015-01-08 13:24:33 -08:00
parent 6ffc326236
commit 8869771682
1 changed files with 15 additions and 4 deletions
Download patch file Download diff file Expand all files Collapse all files

19
std/algorithm.d
View file

@ -7794,10 +7794,21 @@ Range findAdjacent(alias pred = "a == b", Range)(Range r)
// findAmong
/**
Advances $(D seq) by calling $(D seq.popFront) until either $(D
find!(pred)(choices, seq.front)) is $(D true), or $(D seq) becomes
empty. Performs $(BIGOH seq.length * choices.length) evaluations of
$(D pred).
Searches the given range for an element that matches one of the given choices.
Advances $(D seq) by calling $(D seq.popFront) until either
$(D find!(pred)(choices, seq.front)) is $(D true), or $(D seq) becomes empty.
Performs $(BIGOH seq.length * choices.length) evaluations of $(D pred).
Params:
pred = The predicate to use for determining a match.
seq = The $(XREF2 range, isInputRange, input range) to search.
choices = A $(XREF2 range, isForwardRange, forward range) of possible
choices.
Returns:
$(D seq) advanced to the first matching element, or until empty if there are no
matching elements.
See_Also:
$(WEB sgi.com/tech/stl/find_first_of.html, STL's find_first_of)