View source code
Display the source code in std/range/package.d from which this
page was generated on github.
Report a bug
If you spot a problem with this page, click here to create a
Bugzilla issue.
Improve this page
Quickly fork, edit online, and submit a pull request for this page.
Requires a signed-in GitHub account. This works well for small changes.
If you'd like to make larger changes you may want to consider using
local clone.
Function std.range.retro
Iterates a bidirectional range backwards. The original range can be
accessed by using the source
property. Applying retro twice to
the same range yields the original range.
auto retro(Range)
(
Range r
)
if (isBidirectionalRange!(Unqual!Range));
Parameters
Name | Description |
---|---|
r | the bidirectional range to iterate backwards |
Returns
A bidirectional range with length if r
also provides a length. Or,
if r
is a random access range, then the return value will be random
access as well.
See Also
reverse
for mutating the source range directly.
Example
import std .algorithm .comparison : equal;
int[5] a = [ 1, 2, 3, 4, 5 ];
int[5] b = [ 5, 4, 3, 2, 1 ];
assert(equal(retro(a[]), b[]));
assert(retro(a[]) .source is a[]);
assert(retro(retro(a[])) is a[]);
Authors
Andrei Alexandrescu, David Simcha, Jonathan M Davis, and Jack Stouffer. Credit for some of the ideas in building this module goes to Leonardo Maffi.
License
Copyright © 1999-2022 by the D Language Foundation | Page generated by ddox.