Rounding integer division

Integer division returns the quotient. I.e. rounds to zero. This code will round the result to nearest integer. Rounding behavior is controlled by DIV_ROUND_BEHAVIOR. More...

Collaboration diagram for Rounding integer division:

Modules
	Rounding behavior

Macros
#define	DIV_ROUND_CLOSEST(n, d, t)
	Rounded integer division.
#define	UDIV_ROUND_CLOSEST(n, d, t)   ((t)((n) + DIV_ROUND_CORRECT(d, t))/(t)(d))
	Rounded unsigned integer division.
#define	UDIV_ROUND_UP(n, d, t)   ((t)((n) + (t)((d)+1U))/(t)(d))
	Rounding up unsigned integer division.

Functions
template<uint16_t divisor>
TESTABLE_STATIC_CONSTEXPR uint16_t	div_round_closest_u16 (uint16_t n)
	Rounded unsigned integer division optimized for compile time constants.

Detailed Description

Integer division returns the quotient. I.e. rounds to zero. This code will round the result to nearest integer. Rounding behavior is controlled by DIV_ROUND_BEHAVIOR.

Macro Definition Documentation

DIV_ROUND_CLOSEST

#define DIV_ROUND_CLOSEST	(		n,
			d,
			t
	)

Value:

    ( \
    (((n) < (t)(0)) ^ ((d) < (t)(0))) ? \
        ((t)((n) - DIV_ROUND_CORRECT(d, t))/(t)(d)) : \
        ((t)((n) + DIV_ROUND_CORRECT(d, t))/(t)(d)))

Rounded integer division.

Integer division returns the quotient. I.e. rounds to zero. This macro will round the result to nearest integer. Rounding behavior is controlled by DIV_ROUND_BEHAVIOR

Warning

For performance reasons, this macro does not promote integers. So it will overflow if n>MAX(t)-(d/2).

Parameters

n	The numerator (dividee) (an integer)
d	The denominator (divider) (an integer)
t	The type of the result. E.g. uint16_t

UDIV_ROUND_CLOSEST

#define UDIV_ROUND_CLOSEST	(		n,
			d,
			t
	)		((t)((n) + DIV_ROUND_CORRECT(d, t))/(t)(d))

Rounded unsigned integer division.

This is slightly faster than the signed version (DIV_ROUND_CLOSEST(n, d, t))

Warning

For performance reasons, this macro does not promote integers. So it will overflow if n>MAX(t)-(d/2).

Parameters

n	The numerator (dividee) (an unsigned integer)
d	The denominator (divider) (an unsigned integer)
t	The type of the result. E.g. uint16_t

UDIV_ROUND_UP

#define UDIV_ROUND_UP	(		n,
			d,
			t
	)		((t)((n) + (t)((d)+1U))/(t)(d))

Rounding up unsigned integer division.

Function Documentation

div_round_closest_u16()

template<uint16_t divisor>

TESTABLE_STATIC_CONSTEXPR uint16_t div_round_closest_u16

(

uint16_t

n

)

Rounded unsigned integer division optimized for compile time constants.

Template Parameters

divisor

Divisor

Parameters

n

Dividend

Returns

uint16_t