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.bitwise
Bitwise adapter over an integral type range. Consumes the range elements bit by bit, from the least significant bit to the most significant bit.
auto bitwise(R)
(
auto ref R range
)
if (isInputRange!R && isIntegral!(ElementType!R));
Parameters
Name | Description |
---|---|
R | an integral input range to iterate over |
range | range to consume bit by by |
Returns
A Bitwise
input range with propagated forward, bidirectional
and random access capabilities
Example
import std .algorithm .comparison : equal;
import std .format : format;
// 00000011 00001001
ubyte[] arr = [3, 9];
auto r = arr .bitwise;
// iterate through it as with any other range
writeln(format("%(%d%)", r)); // "1100000010010000"
assert(format("%(%d%)", r .retro) .equal("1100000010010000" .retro));
auto r2 = r[5 .. $];
// set a bit
r[2] = 1;
writeln(arr[0]); // 7
writeln(r[5]); // r2[0]
Example
You can use bitwise to implement an uniform bool generator
import std .algorithm .comparison : equal;
import std .random : rndGen;
auto rb = rndGen .bitwise;
static assert(isInfinite!(typeof(rb)));
auto rb2 = rndGen .bitwise;
// Don't forget that structs are passed by value
assert(rb .take(10) .equal(rb2 .take(10)));
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.