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

Members

Aliases

DoubleRep alias DoubleRep = FloatingPointRepresentation!double: Allows manipulating the fraction, exponent, and sign parts of a double separately. The definition is:
FloatRep alias FloatRep = FloatingPointRepresentation!float: Allows manipulating the fraction, exponent, and sign parts of a float separately. The definition is:

Enums

Endian (from std.system) enum Endian via public import std.system : Endian;: Byte order endianness.

Functions

append void append(R range, T 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 T bigEndianToNative(ubyte[n] 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.
bitfields string bitfields(): Allows creating bitfields inside structs, classes and unions.
bitsSet auto bitsSet(T 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 T littleEndianToNative(ubyte[n] 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 auto nativeToBigEndian(T 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 auto nativeToLittleEndian(T 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 T peek(R range)
T peek(R range, size_t index)
T peek(R range, size_t* index): 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 T read(R 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 T swapEndian(T val): Swaps the endianness of the given integral value or character.
write void write(R range, T value, size_t index)
void write(R range, T value, size_t* 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

BitArray struct 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.

Templates

taggedClassRef template taggedClassRef(T, string name, Ts...): This string mixin generator allows one to create tagged class reference inside structs and classes.
taggedPointer template taggedPointer(T : T*, string name, Ts...): This string mixin generator allows one to create tagged pointers inside structs and classes.

std.bitmanip

Members

Aliases

Enums

Functions

Structs

Templates

Meta

Source

License

Copyright

Authors