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

Tweak std.algorithm.comparison.either docs and add to package doc table

Browse source
This commit is contained in:
Jakob Øvrum 2016-01-09 09:32:47 +09:00
parent 42625ce05c
commit 22a90f904e
2 changed files with 10 additions and 9 deletions
Download patch file Download diff file Expand all files Collapse all files

18
std/algorithm/comparison.d
View file

@ -1962,24 +1962,24 @@ bool isPermutation(alias pred = "a == b", Range1, Range2)
}
/**
Get first parameter $(D p) that passes an $(D if (unaryFun!pred(p))) test. If
no parameter passes the test return the last.
Get the _first argument `a` that passes an `if (unaryFun!pred(a))` test. If
no argument passes the test, return the last argument.
Similar to behaviour of `or` operator in dynamic languages such as Lisp's
Similar to behaviour of the `or` operator in dynamic languages such as Lisp's
`(or ...)` and Python's `a or b or ...` except that the last argument is
returned upon no match.
Simplifies logic, for instance, in parsing rules where a set of alternative
matchers are tried. The first one that matches returns it match result,
matchers are tried. The _first one that matches returns it match result,
typically as an abstract syntax tree (AST).
NOTE: Lazy parameters are currently, too restrictively, inferred by DMD to
always throw eventhough they don't need to be. This makes it impossible to
currently mark $(D either) as $(D nothrow). See issue at
https://issues.dlang.org/show_bug.cgi?id=12647
Bugs:
Lazy parameters are currently, too restrictively, inferred by DMD to
always throw even though they don't need to be. This makes it impossible to
currently mark `either` as `nothrow`. See issue at $(BUGZILLA 12647).
Returns:
The first parameter that passes the test $(D pred).
The _first argument that passes the test `pred`.
*/
CommonType!(T, Ts) either(alias pred = a => a, T, Ts...)(T first, lazy Ts alternatives)
if (alternatives.length >= 1 &&

1
std/algorithm/package.d
View file

@ -49,6 +49,7 @@ $(TR $(TDNW Comparison)
$(SUBREF comparison, castSwitch)
$(SUBREF comparison, clamp)
$(SUBREF comparison, cmp)
$(SUBREF comparison, either)
$(SUBREF comparison, equal)
$(SUBREF comparison, isPermutation)
$(SUBREF comparison, isSameLength)