View source code
Display the source code in std/bitmanip.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.

Module std.bitmanip

Bit-level manipulation facilities.

Category Functions
Bit constructs BitArray bitfields bitsSet
Endianness conversion bigEndianToNative littleEndianToNative nativeToBigEndian nativeToLittleEndian swapEndian
Integral ranges append peek read write
Floating-Point manipulation DoubleRep FloatRep
Tagging taggedClassRef taggedPointer

Functions

NameDescription
append(range, value) Takes an integral value, converts it to the given endianness, and appends it to the given range of ubytes (using put) as a sequence of T.sizeof ubytes starting at index. hasSlicing!R must be true.
bigEndianToNative(val) Converts the given value from big endian to the native endianness and returns it. The value is given as a ubyte[n] where n is the size of the target type. You must give the target type as a template argument, because there are multiple types with the same size and so the type of the argument is not enough to determine the return type.
bitsSet(value) Range that iterates the indices of the set bits in value. Index 0 corresponds to the least significant bit. For signed integers, the highest index corresponds to the sign bit.
littleEndianToNative(val) Converts the given value from little endian to the native endianness and returns it. The value is given as a ubyte[n] where n is the size of the target type. You must give the target type as a template argument, because there are multiple types with the same size and so the type of the argument is not enough to determine the return type.
nativeToBigEndian(val) Converts the given value from the native endianness to big endian and returns it as a ubyte[n] where n is the size of the given type.
nativeToLittleEndian(val) Converts the given value from the native endianness to little endian and returns it as a ubyte[n] where n is the size of the given type.
peek(range) Takes a range of ubytes and converts the first T.sizeof bytes to T. The value returned is converted from the given endianness to the native endianness. The range is not consumed.
read(range) Takes a range of ubytes and converts the first T.sizeof bytes to T. The value returned is converted from the given endianness to the native endianness. The T.sizeof bytes which are read are consumed from the range.
swapEndian(val) Swaps the endianness of the given integral value or character.
write(range, value, index) Takes an integral value, converts it to the given endianness, and writes it to the given range of ubytes as a sequence of T.sizeof ubytes starting at index. hasSlicing!R must be true.

Structs

NameDescription
BitArray A dynamic array of bits. Each bit in a BitArray can be manipulated individually or by the standard bitwise operators &, |, ^, ~, >>, << and also by other effective member functions; most of them work relative to the BitArray's dimension (see dim), instead of its length.
DoubleRep Allows manipulating the fraction, exponent, and sign parts of a double separately. The definition is:
FloatRep Allows manipulating the fraction, exponent, and sign parts of a float separately. The definition is:

Manifest constants

NameTypeDescription
bitfields Allows creating bit fields inside structs and classes.
taggedClassRef This string mixin generator allows one to create tagged class reference inside structs and classes.
taggedPointer This string mixin generator allows one to create tagged pointers inside structs and classes.

Authors

Walter Bright, Andrei Alexandrescu, Jonathan M Davis, Alex Rønne Petersen, Damian Ziemba, Amaury SECHET

License

Boost License 1.0.