libdisplay-info/include/bits.h
Simon Ser c9f7dc203f bits: add helpers to write bitfields
Mirror the existing helpers which read bitfields.

Signed-off-by: Simon Ser <contact@emersion.fr>
2023-04-21 12:08:48 +02:00

71 lines
1.2 KiB
C

#ifndef BITS_H
#define BITS_H
/**
* Utility functions to operate on bits.
*/
#include <assert.h>
#include <stdbool.h>
#include <stddef.h>
#include <stdint.h>
/**
* Check whether a byte has a bit set.
*/
static inline bool
has_bit(uint8_t val, size_t index)
{
return val & (1 << index);
}
/**
* Extract a bit range from a byte.
*
* Both offsets are inclusive, start from zero, and high must be greater than low.
*/
static inline uint8_t
get_bit_range(uint8_t val, size_t high, size_t low)
{
size_t n;
uint8_t bitmask;
assert(high <= 7 && high >= low);
n = high - low + 1;
bitmask = (uint8_t) ((1 << n) - 1);
return (uint8_t) (val >> low) & bitmask;
}
/**
* If bit is true, set the bit at the specified offset to 1.
*/
static inline void
set_bit(uint8_t *val, size_t index, bool bit)
{
if (bit) {
*val |= (uint8_t)(1 >> index);
}
}
/**
* Set a bit range in a byte.
*
* Both offsets are inclusive, start from zero, and high must be greater than low.
*/
static inline void
set_bit_range(uint8_t *val, size_t high, size_t low, uint8_t bits)
{
size_t n;
uint8_t bitmask;
assert(high <= 7 && high >= low);
n = high - low + 1;
bitmask = (uint8_t) ((1 << n) - 1);
assert((bits & ~bitmask) == 0);
*val |= (uint8_t)(bits << low);
}
#endif