e66c0da0c1
Add a <misc/math_extras.h> header file with portable implementations of a number of commonly used math and bit counting operations that are not available in the C programming language. The math_extras functions fall into two groups: 1. Unsigned integer arithmetic with overflow detection. Addition and multiplication are provides for the u32_t, u64_t, and size_t types. This commit doesn't include subtraction and division, and there are no signed operations. These could be added later if there is a need. 2. Bit-counting operations like clz, ctz, and ffs. These are provided for u32_t and u64_t only. I don't see a need for size_t operations, but they could be added if needed. A follow-on commit will add more efficient implementations using compiler builtins for those compilers that support it. Another commit will replace other uses of "naked" compiler builtins with calls to these functions. Signed-off-by: Jakob Olesen <jolesen@fb.com>
73 lines
2.0 KiB
C
73 lines
2.0 KiB
C
/*
|
|
* Copyright (c) 2019 Facebook.
|
|
*
|
|
* SPDX-License-Identifier: Apache-2.0
|
|
*/
|
|
|
|
/**
|
|
* @file
|
|
* @brief Extra arithmetic and bitmanipulation functions.
|
|
*
|
|
* @details This header file provides portable wrapper functions for a number of
|
|
* arithmetic and bit-counting functions that are often provided by compiler
|
|
* builtins. If the compiler does not have an appropriate builtin, a portable C
|
|
* implementation is used instead.
|
|
*/
|
|
|
|
#ifndef ZEPHYR_INCLUDE_MISC_MATH_EXTRAS_H_
|
|
#define ZEPHYR_INCLUDE_MISC_MATH_EXTRAS_H_
|
|
|
|
#include <zephyr/types.h>
|
|
#include <stdbool.h>
|
|
#include <stddef.h>
|
|
|
|
/**
|
|
* @name Unsigned integer addition with overflow detection.
|
|
*
|
|
* These functions compute `a + b` and store the result in `*result`, returning
|
|
* true if the operation overflowed.
|
|
*/
|
|
/**@{*/
|
|
static bool u32_add_overflow(u32_t a, u32_t b, u32_t *result);
|
|
static bool u64_add_overflow(u64_t a, u64_t b, u64_t *result);
|
|
static bool size_add_overflow(size_t a, size_t b, size_t *result);
|
|
/**@}*/
|
|
|
|
/**
|
|
* @name Unsigned integer multiplication with overflow detection.
|
|
*
|
|
* These functions compute `a * b` and store the result in `*result`, returning
|
|
* true if the operation overflowed.
|
|
*/
|
|
/**@{*/
|
|
static bool u32_mul_overflow(u32_t a, u32_t b, u32_t *result);
|
|
static bool u64_mul_overflow(u64_t a, u64_t b, u64_t *result);
|
|
static bool size_mul_overflow(size_t a, size_t b, size_t *result);
|
|
/**@}*/
|
|
|
|
/**
|
|
* @name Count leading zeros.
|
|
*
|
|
* Count the number of leading zero bits in the bitwise representation of `x`.
|
|
* When `x = 0`, this is the size of `x` in bits.
|
|
*/
|
|
/**@{*/
|
|
static int u32_count_leading_zeros(u32_t x);
|
|
static int u64_count_leading_zeros(u64_t x);
|
|
/**@}*/
|
|
|
|
/**
|
|
* @name Count trailing zeros.
|
|
*
|
|
* Count the number of trailing zero bits in the bitwise representation of `x`.
|
|
* When `x = 0`, this is the size of `x` in bits.
|
|
*/
|
|
/**@{*/
|
|
static int u32_count_trailing_zeros(u32_t x);
|
|
static int u64_count_trailing_zeros(u64_t x);
|
|
/**@}*/
|
|
|
|
#include <misc/math_extras_impl.h>
|
|
|
|
#endif /* ZEPHYR_INCLUDE_MISC_MATH_EXTRAS_H_ */
|