submod8()

LIB8STATIC uint8_t submod8	(	uint8_t	a,
		uint8_t	b,
		uint8_t	m )

Subtract two numbers, and calculate the modulo of the difference and a third number, M.

In other words, it returns (A-B) % M. It is designed as a compact mechanism for decrementing a "mode" switch and wrapping around back to "mode 0" when the switch goes past the start of the available range. e.g. if you have seven modes, this switches to the previous one and wraps around if needed:

mode = submod8( mode, 1, 7);

Parameters

a	dividend byte
b	value to subtract from the dividend
m	divisor byte

Returns

remainder of (a - b) / m

See also

mod8() for notes on performance.

Definition at line 425 of file math8.h.

                                                            {
#if defined(__AVR__)
    asm volatile("       sub %[a],%[b]    \n\t"
                 "L_%=:  sub %[a],%[m]    \n\t"
                 "       brcc L_%=        \n\t"
                 "       add %[a],%[m]    \n\t"
                 : [a] "+r"(a)
                 : [b] "r"(b), [m] "r"(m));
#else
    a -= b;
    while (a >= m)
        a -= m;
#endif
    return a;
}

References LIB8STATIC.