Next: Integer Type Overflow, Previous: Integer Bounds, Up: Integer Properties [Contents][Index]

These macros yield 1 if the corresponding C operators might not yield numerically correct answers due to arithmetic overflow. They do not rely on undefined or implementation-defined behavior. They expand to integer constant expressions if their arguments are. Their implementations are simple and straightforward, but they are typically harder to use than the integer type overflow macros. See Integer Type Overflow.

Although the implementation of these macros is similar to that suggested in Seacord R, The CERT C Secure Coding Standard (2009, revised 2011), in its two sections “INT30-C. Ensure that unsigned integer operations do not wrap” and “INT32-C. Ensure that operations on signed integers do not result in overflow”, Gnulib’s implementation was derived independently of CERT’s suggestions.

Example usage:

#include <intprops.h> void print_product (long int a, long int b) { if (INT_MULTIPLY_RANGE_OVERFLOW (a, b, LONG_MIN, LONG_MAX)) printf ("multiply would overflow"); else printf ("product is %ld", a * b); }

These macros have the following restrictions:

- Their arguments must be integer expressions.
- They may evaluate their arguments zero or multiple times, so the arguments should not have side effects.
- The arithmetic arguments (including the
`min`and`max`arguments) must be of the same integer type after the usual arithmetic conversions, and the type must have minimum value`min`and maximum`max`. Unsigned values should use a zero`min`of the proper type, for example,`(unsigned int) 0`

.

These macros are tuned for constant `min` and `max`. For
commutative operations such as

, they are also
tuned for constant `a` + `b``b`.

`INT_ADD_RANGE_OVERFLOW (`

`a`,`b`,`min`,`max`)-
Yield 1 if

would overflow in [`a`+`b``min`,`max`] integer arithmetic. See above for restrictions. `INT_SUBTRACT_RANGE_OVERFLOW (`

`a`,`b`,`min`,`max`)-
Yield 1 if

would overflow in [`a`-`b``min`,`max`] integer arithmetic. See above for restrictions. `INT_NEGATE_RANGE_OVERFLOW (`

`a`,`min`,`max`)-
Yield 1 if

`-`

would overflow in [`a``min`,`max`] integer arithmetic. See above for restrictions. `INT_MULTIPLY_RANGE_OVERFLOW (`

`a`,`b`,`min`,`max`)-
Yield 1 if

would overflow in [`a`*`b``min`,`max`] integer arithmetic. See above for restrictions. `INT_DIVIDE_RANGE_OVERFLOW (`

`a`,`b`,`min`,`max`)-
Yield 1 if

would overflow in [`a`/`b``min`,`max`] integer arithmetic. See above for restrictions. Division overflow can happen on two’s complement hosts when dividing the most negative integer by -1. This macro does not check for division by zero. `INT_REMAINDER_RANGE_OVERFLOW (`

`a`,`b`,`min`,`max`)-
Yield 1 if

would overflow in [`a`%`b``min`,`max`] integer arithmetic. See above for restrictions. Remainder overflow can happen on two’s complement hosts when dividing the most negative integer by -1; although the mathematical result is always 0, in practice some implementations trap, so this counts as an overflow. This macro does not check for division by zero. `INT_LEFT_SHIFT_RANGE_OVERFLOW (`

`a`,`b`,`min`,`max`)-
Yield 1 if

would overflow in [`a`<<`b``min`,`max`] integer arithmetic. See above for restrictions. Here,`min`and`max`are for`a`only, and`b`need not be of the same type as the other arguments. The C standard says that behavior is undefined for shifts unless 0≤`b`<`w`where`w`is`a`’s word width, and that when`a`is negative then

has undefined behavior and`a`<<`b`

has implementation-defined behavior, but this macro does not check these other restrictions.`a`>>`b`

Next: Integer Type Overflow, Previous: Integer Bounds, Up: Integer Properties [Contents][Index]