Next: , Up: Data Type Measurements   [Contents][Index]


A.5.1 Width of an Integer Type

TS 18661-1:2014 defines macros for the width of integer types (the number of value and sign bits). One benefit of these macros is they can be used in #if preprocessor directives, whereas sizeof cannot. The following macros are defined in limits.h.

CHAR_WIDTH
SCHAR_WIDTH
UCHAR_WIDTH
SHRT_WIDTH
USHRT_WIDTH
INT_WIDTH
UINT_WIDTH
LONG_WIDTH
ULONG_WIDTH
LLONG_WIDTH
ULLONG_WIDTH

These are the widths of the types char, signed char, unsigned char, short int, unsigned short int, int, unsigned int, long int, unsigned long int, long long int and unsigned long long int, respectively.

Further such macros are defined in stdint.h. Apart from those for types specified by width (see Integers), the following are defined:

INTPTR_WIDTH
UINTPTR_WIDTH
PTRDIFF_WIDTH
SIG_ATOMIC_WIDTH
SIZE_WIDTH
WCHAR_WIDTH
WINT_WIDTH

These are the widths of the types intptr_t, uintptr_t, ptrdiff_t, sig_atomic_t, size_t, wchar_t and wint_t, respectively.

A common reason that a program needs to know how many bits are in an integer type is for using an array of unsigned long int as a bit vector. You can access the bit at index n with:

vector[n / ULONG_WIDTH] & (1UL << (n % ULONG_WIDTH))

Before ULONG_WIDTH was a part of the C language, CHAR_BIT was used to compute the number of bits in an integer data type.

Macro: int CHAR_BIT

This is the number of bits in a char. POSIX.1-2001 requires this to be 8.

The number of bits in any data type type can be computed like this:

sizeof (type) * CHAR_BIT

That expression includes padding bits as well as value and sign bits. On all systems supported by the GNU C Library, standard integer types other than _Bool do not have any padding bits.

Portability Note: One cannot actually easily compute the number of usable bits in a portable manner.


Next: Range of an Integer Type, Up: Data Type Measurements   [Contents][Index]