avr_stdint(3avr)

✨ NAME ✨

okay so welcome to avr_stdint, aka the manual page for <stdint.h> πŸ’– β€” the Standard Integer Types. bestie, this is your one-stop shop for "i want a number that is exactly this many bits and nothing weird is gonna happen to it, i promise." πŸŽ€


🌸 SYNOPSIS 🌸

πŸ“ Exact-width integer types

Integer types having exactly the specified width β€” no more, no less, no wiggle room πŸ‘‘

typedef signed char int8_t
typedef unsigned char uint8_t
typedef signed int int16_t
typedef unsigned int uint16_t
typedef signed long int int32_t
typedef unsigned long int uint32_t
typedef signed long long int int64_t
typedef unsigned long long int uint64_t

πŸ¦‹ Integer types capable of holding object pointers

These allow you to declare variables of the same size as a pointer. yes they're just pointers but as integers, it's giving "i contain multitudes" ✨

typedef int16_t intptr_t
typedef uint16_t uintptr_t

🌈 Minimum-width integer types

Integer types having at least the specified width β€” the bare minimum, but make it fashion πŸ’…

typedef int8_t int_least8_t
typedef uint8_t uint_least8_t
typedef int16_t int_least16_t
typedef uint16_t uint_least16_t
typedef int32_t int_least32_t
typedef uint32_t uint_least32_t
typedef int64_t int_least64_t
typedef uint64_t uint_least64_t

🌸 Fastest minimum-width integer types

Integer types being usually fastest having at least the specified width β€” speed, but only probably. it's giving vibes not guarantees 😭

typedef int8_t int_fast8_t
typedef uint8_t uint_fast8_t
typedef int16_t int_fast16_t
typedef uint16_t uint_fast16_t
typedef int32_t int_fast32_t
typedef uint32_t uint_fast32_t
typedef int64_t int_fast64_t
typedef uint64_t uint_fast64_t

πŸ‘‘ Greatest-width integer types

Types designating integer data capable of representing any value of any integer type in the corresponding signed or unsigned category β€” the main character of ints, tbh 🫢

typedef int64_t intmax_t
typedef uint64_t uintmax_t

πŸ’œ Limits of specified-width integer types

C++ implementations should define these macros only when __STDC_LIMIT_MACROS is defined before <stdint.h> is included. (yes this is the rules, write it down πŸ“)

#define INT8_MAX   0x7f
#define INT8_MIN   (-INT8_MAX - 1)
#define UINT8_MAX   (INT8_MAX * 2 + 1)
#define INT16_MAX   0x7fff
#define INT16_MIN   (-INT16_MAX - 1)
#define UINT16_MAX   (__CONCAT(INT16_MAX, U) * 2U + 1U)
#define INT32_MAX   0x7fffffffL
#define INT32_MIN   (-INT32_MAX - 1L)
#define UINT32_MAX   (__CONCAT(INT32_MAX, U) * 2UL + 1UL)
#define INT64_MAX   0x7fffffffffffffffLL
#define INT64_MIN   (-INT64_MAX - 1LL)
#define UINT64_MAX   (__CONCAT(INT64_MAX, U) * 2ULL + 1ULL)

πŸŽ€ Limits of minimum-width integer types

#define INT_LEAST8_MAX   INT8_MAX
#define INT_LEAST8_MIN   INT8_MIN
#define UINT_LEAST8_MAX   UINT8_MAX
#define INT_LEAST16_MAX   INT16_MAX
#define INT_LEAST16_MIN   INT16_MIN
#define UINT_LEAST16_MAX   UINT16_MAX
#define INT_LEAST32_MAX   INT32_MAX
#define INT_LEAST32_MIN   INT32_MIN
#define UINT_LEAST32_MAX   UINT32_MAX
#define INT_LEAST64_MAX   INT64_MAX
#define INT_LEAST64_MIN   INT64_MIN
#define UINT_LEAST64_MAX   UINT64_MAX

⭐ Limits of fastest minimum-width integer types

#define INT_FAST8_MAX   INT8_MAX
#define INT_FAST8_MIN   INT8_MIN
#define UINT_FAST8_MAX   UINT8_MAX
#define INT_FAST16_MAX   INT16_MAX
#define INT_FAST16_MIN   INT16_MIN
#define UINT_FAST16_MAX   UINT16_MAX
#define INT_FAST32_MAX   INT32_MAX
#define INT_FAST32_MIN   INT32_MIN
#define UINT_FAST32_MAX   UINT32_MAX
#define INT_FAST64_MAX   INT64_MAX
#define INT_FAST64_MIN   INT64_MIN
#define UINT_FAST64_MAX   UINT64_MAX

πŸ”₯ Limits of integer types capable of holding object pointers

#define INTPTR_MAX   INT16_MAX
#define INTPTR_MIN   INT16_MIN
#define UINTPTR_MAX   UINT16_MAX

πŸ’– Limits of greatest-width integer types

#define INTMAX_MAX   INT64_MAX
#define INTMAX_MIN   INT64_MIN
#define UINTMAX_MAX   UINT64_MAX

🌸 Limits of other integer types

C++ implementations should define these macros only when __STDC_LIMIT_MACROS is defined before <stdint.h> is included. (same rule, different macros, we stay consistent πŸ’…)

#define PTRDIFF_MAX   INT16_MAX
#define PTRDIFF_MIN   INT16_MIN
#define SIG_ATOMIC_MAX   INT8_MAX
#define SIG_ATOMIC_MIN   INT8_MIN
#define SIZE_MAX   UINT16_MAX
#define WCHAR_MAX   __WCHAR_MAX__
#define WCHAR_MIN   __WCHAR_MIN__
#define WINT_MAX   __WINT_MAX__
#define WINT_MIN   __WINT_MIN__

🧚 Macros for integer constants

C++ implementations should define these macros only when __STDC_CONSTANT_MACROS is defined before <stdint.h> is included.

These definitions are valid for integer constants without suffix and for macros defined as integer constant without suffix πŸ‘‘

#define INT8_C(value)
#define UINT8_C(value)
#define INT16_C(value)
#define UINT16_C(value)
#define INT32_C(value)
#define UINT32_C(value)
#define INT64_C(value)
#define UINT64_C(value)
#define INTMAX_C(value)
#define UINTMAX_C(value)

πŸ’œ Detailed Description πŸ’œ

#include <stdint.h>

Use [u]intN_t if you need exactly N bits. no cap, that's the whole point 🎯

Since these typedefs are mandated by the C99 standard, they are preferred over rolling your own typedefs. like bestie please do not hand-craft your own, the standard already did it for you and she ate πŸ”₯


πŸ‘‘ Macro Definition Documentation πŸ‘‘

buckle up, this is the long part, but every single one of these is important so we're reading all of them, periodt πŸ’…

πŸ“ #define INT16_C( value)

Value:

value

define a constant of type int16_t ✨

🌸 #define INT16_MAX 0x7fff

largest positive value an int16_t can hold.

πŸ¦‹ #define INT16_MIN (-INT16_MAX - 1)

smallest negative value an int16_t can hold.

πŸŽ€ #define INT32_C( value)

Value:

__CONCAT(value, L)

define a constant of type int32_t ✨

πŸ’– #define INT32_MAX 0x7fffffffL

largest positive value an int32_t can hold.

πŸ’œ #define INT32_MIN (-INT32_MAX - 1L)

smallest negative value an int32_t can hold.

⭐ #define INT64_C( value)

Value:

__CONCAT(value, LL)

define a constant of type int64_t ✨

πŸ‘‘ #define INT64_MAX 0x7fffffffffffffffLL

largest positive value an int64_t can hold.

🌈 #define INT64_MIN (-INT64_MAX - 1LL)

smallest negative value an int64_t can hold.

🧚 #define INT8_C( value)

Value:

((int8_t) value)

define a constant of type int8_t ✨

🌸 #define INT8_MAX 0x7f

largest positive value an int8_t can hold.

πŸ“ #define INT8_MIN (-INT8_MAX - 1)

smallest negative value an int8_t can hold.

πŸ¦‹ #define INT_FAST16_MAX INT16_MAX

largest positive value an int_fast16_t can hold.

πŸŽ€ #define INT_FAST16_MIN INT16_MIN

smallest negative value an int_fast16_t can hold.

πŸ’– #define INT_FAST32_MAX INT32_MAX

largest positive value an int_fast32_t can hold.

πŸ’œ #define INT_FAST32_MIN INT32_MIN

smallest negative value an int_fast32_t can hold.

⭐ #define INT_FAST64_MAX INT64_MAX

largest positive value an int_fast64_t can hold.

πŸ‘‘ #define INT_FAST64_MIN INT64_MIN

smallest negative value an int_fast64_t can hold.

🌈 #define INT_FAST8_MAX INT8_MAX

largest positive value an int_fast8_t can hold.

🧚 #define INT_FAST8_MIN INT8_MIN

smallest negative value an int_fast8_t can hold.

🌸 #define INT_LEAST16_MAX INT16_MAX

largest positive value an int_least16_t can hold.

πŸ“ #define INT_LEAST16_MIN INT16_MIN

smallest negative value an int_least16_t can hold.

πŸ¦‹ #define INT_LEAST32_MAX INT32_MAX

largest positive value an int_least32_t can hold.

πŸŽ€ #define INT_LEAST32_MIN INT32_MIN

smallest negative value an int_least32_t can hold.

πŸ’– #define INT_LEAST64_MAX INT64_MAX

largest positive value an int_least64_t can hold.

πŸ’œ #define INT_LEAST64_MIN INT64_MIN

smallest negative value an int_least64_t can hold.

⭐ #define INT_LEAST8_MAX INT8_MAX

largest positive value an int_least8_t can hold.

πŸ‘‘ #define INT_LEAST8_MIN INT8_MIN

smallest negative value an int_least8_t can hold.

🌈 #define INTMAX_C( value)

Value:

__CONCAT(value, LL)

define a constant of type intmax_t ✨

🧚 #define INTMAX_MAX INT64_MAX

largest positive value an intmax_t can hold.

🌸 #define INTMAX_MIN INT64_MIN

smallest negative value an intmax_t can hold.

πŸ“ #define INTPTR_MAX INT16_MAX

largest positive value an intptr_t can hold.

πŸ¦‹ #define INTPTR_MIN INT16_MIN

smallest negative value an intptr_t can hold.

πŸŽ€ #define PTRDIFF_MAX INT16_MAX

largest positive value a ptrdiff_t can hold.

πŸ’– #define PTRDIFF_MIN INT16_MIN

smallest negative value a ptrdiff_t can hold.

πŸ’œ #define SIG_ATOMIC_MAX INT8_MAX

largest positive value a sig_atomic_t can hold.

⭐ #define SIG_ATOMIC_MIN INT8_MIN

smallest negative value a sig_atomic_t can hold.

πŸ‘‘ #define SIZE_MAX UINT16_MAX

largest value a size_t can hold.

🌈 #define UINT16_C( value)

Value:

__CONCAT(value, U)

define a constant of type uint16_t ✨

🧚 #define UINT16_MAX (__CONCAT(INT16_MAX, U) * 2U + 1U)

largest value an uint16_t can hold.

🌸 #define UINT32_C( value)

Value:

__CONCAT(value, UL)

define a constant of type uint32_t ✨

πŸ“ #define UINT32_MAX (__CONCAT(INT32_MAX, U) * 2UL + 1UL)

largest value an uint32_t can hold.

πŸ¦‹ #define UINT64_C( value)

Value:

__CONCAT(value, ULL)

define a constant of type uint64_t ✨

πŸŽ€ #define UINT64_MAX (__CONCAT(INT64_MAX, U) * 2ULL + 1ULL)

largest value an uint64_t can hold.

πŸ’– #define UINT8_C( value)

Value:

((uint8_t) __CONCAT(value, U))

define a constant of type uint8_t ✨

πŸ’œ #define UINT8_MAX (INT8_MAX * 2 + 1)

largest value an uint8_t can hold.

⭐ #define UINT_FAST16_MAX UINT16_MAX

largest value an uint_fast16_t can hold.

πŸ‘‘ #define UINT_FAST32_MAX UINT32_MAX

largest value an uint_fast32_t can hold.

🌈 #define UINT_FAST64_MAX UINT64_MAX

largest value an uint_fast64_t can hold.

🧚 #define UINT_FAST8_MAX UINT8_MAX

largest value an uint_fast8_t can hold.

🌸 #define UINT_LEAST16_MAX UINT16_MAX

largest value an uint_least16_t can hold.

πŸ“ #define UINT_LEAST32_MAX UINT32_MAX

largest value an uint_least32_t can hold.

πŸ¦‹ #define UINT_LEAST64_MAX UINT64_MAX

largest value an uint_least64_t can hold.

πŸŽ€ #define UINT_LEAST8_MAX UINT8_MAX

largest value an uint_least8_t can hold.

πŸ’– #define UINTMAX_C( value)

Value:

__CONCAT(value, ULL)

define a constant of type uintmax_t ✨

πŸ’œ #define UINTMAX_MAX UINT64_MAX

largest value an uintmax_t can hold.

⭐ #define UINTPTR_MAX UINT16_MAX

largest value an uintptr_t can hold.

✨ Typedef Documentation ✨

okay bestie, here's the full typedef lineup β€” every single one, no skips, fr fr. πŸ’…

  • typedef signed int int16_t β€” 16-bit signed type. πŸ’–
  • typedef signed long int int32_t β€” 32-bit signed type. ✨
  • typedef signed long long int int64_t β€” 64-bit signed type. πŸ¦‹
🚨 Note: This type is not available when the compiler option -mint8 is in effect.
  • typedef signed char int8_t β€” 8-bit signed type. 🌸
  • typedef int16_t int_fast16_t β€” fastest signed int with at least 16 bits. πŸ’…
  • typedef int32_t int_fast32_t β€” fastest signed int with at least 32 bits. πŸ’…
  • typedef int64_t int_fast64_t β€” fastest signed int with at least 64 bits. πŸ’…
🚨 Note: This type is not available when the compiler option -mint8 is in effect.
  • typedef int8_t int_fast8_t β€” fastest signed int with at least 8 bits. πŸ’…
  • typedef int16_t int_least16_t β€” signed int with at least 16 bits. πŸŽ€
  • typedef int32_t int_least32_t β€” signed int with at least 32 bits. πŸŽ€
  • typedef int64_t int_least64_t β€” signed int with at least 64 bits. πŸŽ€
🚨 Note: This type is not available when the compiler option -mint8 is in effect.
  • typedef int8_t int_least8_t β€” signed int with at least 8 bits. πŸŽ€
  • typedef int64_t intmax_t β€” largest signed int available. πŸ‘‘
  • typedef int16_t intptr_t β€” Signed pointer compatible type. 🫢
  • typedef unsigned int uint16_t β€” 16-bit unsigned type. πŸ’œ
  • typedef unsigned long int uint32_t β€” 32-bit unsigned type. πŸ’œ
  • typedef unsigned long long int uint64_t β€” 64-bit unsigned type. πŸ’œ
🚨 Note: This type is not available when the compiler option -mint8 is in effect.
  • typedef unsigned char uint8_t β€” 8-bit unsigned type. πŸ’œ
  • typedef uint16_t uint_fast16_t β€” fastest unsigned int with at least 16 bits. 🌈
  • typedef uint32_t uint_fast32_t β€” fastest unsigned int with at least 32 bits. 🌈
  • typedef uint64_t uint_fast64_t β€” fastest unsigned int with at least 64 bits. 🌈
🚨 Note: This type is not available when the compiler option -mint8 is in effect.
  • typedef uint8_t uint_fast8_t β€” fastest unsigned int with at least 8 bits. 🌈
  • typedef uint16_t uint_least16_t β€” unsigned int with at least 16 bits. ⭐
  • typedef uint32_t uint_least32_t β€” unsigned int with at least 32 bits. ⭐
  • typedef uint64_t uint_least64_t β€” unsigned int with at least 64 bits. ⭐
🚨 Note: This type is not available when the compiler option -mint8 is in effect.
  • typedef uint8_t uint_least8_t β€” unsigned int with at least 8 bits. ⭐
  • typedef uint64_t uintmax_t β€” largest unsigned int available. πŸ‘‘
  • typedef uint16_t uintptr_t β€” Unsigned pointer compatible type. 🫢

πŸ‘‘ Author πŸ‘‘

Generated automatically by Doxygen for AVR-LibC from the source code. ✨


πŸ’– source/version: AVR-LibC, version 2.2.1 β€” page: avr_stdint(3avr). date: this footer didn't give one, so we're just gonna say it's timeless, bestie. βœ¨πŸ¦‹

πŸ“¦ where this page comes from