SDL 3.0
SDL_endian.h File Reference

Functions for reading and writing endian-specific values. More...

+ Include dependency graph for SDL_endian.h:
+ This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Macros

Swap to native

Byteswap item from the specified endianness to the native endianness.

#define SDL_SwapLE16(X)   (X)
 
#define SDL_SwapLE32(X)   (X)
 
#define SDL_SwapLE64(X)   (X)
 
#define SDL_SwapFloatLE(X)   (X)
 
#define SDL_SwapBE16(X)   SDL_Swap16(X)
 
#define SDL_SwapBE32(X)   SDL_Swap32(X)
 
#define SDL_SwapBE64(X)   SDL_Swap64(X)
 
#define SDL_SwapFloatBE(X)   SDL_SwapFloat(X)
 

The two types of endianness

#define SDL_LIL_ENDIAN   1234
 
#define SDL_BIG_ENDIAN   4321
 
#define SDL_BYTEORDER   SDL_LIL_ENDIAN
 
#define SDL_FLOATWORDORDER   SDL_BYTEORDER
 
#define HAS_BUILTIN_BSWAP16   0
 
#define HAS_BUILTIN_BSWAP32   0
 
#define HAS_BUILTIN_BSWAP64   0
 
#define HAS_BROKEN_BSWAP   0
 
SDL_FORCE_INLINE Uint16 SDL_Swap16 (Uint16 x)
 
SDL_FORCE_INLINE Uint32 SDL_Swap32 (Uint32 x)
 
SDL_FORCE_INLINE Uint64 SDL_Swap64 (Uint64 x)
 
SDL_FORCE_INLINE float SDL_SwapFloat (float x)
 

Detailed Description

Functions for reading and writing endian-specific values.

Definition in file SDL_endian.h.

Macro Definition Documentation

◆ HAS_BROKEN_BSWAP

#define HAS_BROKEN_BSWAP   0

Definition at line 138 of file SDL_endian.h.

◆ HAS_BUILTIN_BSWAP16

#define HAS_BUILTIN_BSWAP16   0

Definition at line 135 of file SDL_endian.h.

◆ HAS_BUILTIN_BSWAP32

#define HAS_BUILTIN_BSWAP32   0

Definition at line 136 of file SDL_endian.h.

◆ HAS_BUILTIN_BSWAP64

#define HAS_BUILTIN_BSWAP64   0

Definition at line 137 of file SDL_endian.h.

◆ SDL_BIG_ENDIAN

#define SDL_BIG_ENDIAN   4321

Definition at line 55 of file SDL_endian.h.

◆ SDL_BYTEORDER

#define SDL_BYTEORDER   SDL_LIL_ENDIAN

Definition at line 85 of file SDL_endian.h.

◆ SDL_FLOATWORDORDER

#define SDL_FLOATWORDORDER   SDL_BYTEORDER

Definition at line 108 of file SDL_endian.h.

◆ SDL_LIL_ENDIAN

#define SDL_LIL_ENDIAN   1234

Definition at line 54 of file SDL_endian.h.

◆ SDL_SwapBE16

#define SDL_SwapBE16 (   X)    SDL_Swap16(X)

Swap 16-bit big endian integer to 16-bit native endian integer.

Definition at line 376 of file SDL_endian.h.

◆ SDL_SwapBE32

#define SDL_SwapBE32 (   X)    SDL_Swap32(X)

Swap 32-bit big endian integer to 32-bit native endian integer.

Definition at line 377 of file SDL_endian.h.

◆ SDL_SwapBE64

#define SDL_SwapBE64 (   X)    SDL_Swap64(X)

Swap 64-bit big endian integer to 64-bit native endian integer.

Definition at line 378 of file SDL_endian.h.

◆ SDL_SwapFloatBE

#define SDL_SwapFloatBE (   X)    SDL_SwapFloat(X)

Swap endian float to native endian float.

Definition at line 379 of file SDL_endian.h.

◆ SDL_SwapFloatLE

#define SDL_SwapFloatLE (   X)    (X)

Swap little endian float to native endian float.

Definition at line 375 of file SDL_endian.h.

◆ SDL_SwapLE16

#define SDL_SwapLE16 (   X)    (X)

Swap 16-bit little endian integer to 16-bit native endian integer.

Definition at line 372 of file SDL_endian.h.

◆ SDL_SwapLE32

#define SDL_SwapLE32 (   X)    (X)

Swap 32-bit little endian integer to 32-bit native endian integer.

Definition at line 373 of file SDL_endian.h.

◆ SDL_SwapLE64

#define SDL_SwapLE64 (   X)    (X)

Swap 64-bit little endian integer to 64-bit native endian integer.

Definition at line 374 of file SDL_endian.h.

Function Documentation

◆ SDL_Swap16()

SDL_FORCE_INLINE Uint16 SDL_Swap16 ( Uint16  x)

Byte swap 16-bit integer.

Definition at line 187 of file SDL_endian.h.

188{
189 return SDL_static_cast(Uint16, ((x << 8) | (x >> 8)));
190}
uint16_t Uint16
Definition: SDL_stdinc.h:159
#define SDL_static_cast(type, expression)
Definition: SDL_stdinc.h:106

References SDL_static_cast.

◆ SDL_Swap32()

SDL_FORCE_INLINE Uint32 SDL_Swap32 ( Uint32  x)

Byte swap 32-bit integer.

Definition at line 241 of file SDL_endian.h.

242{
243 return SDL_static_cast(Uint32, ((x << 24) | ((x << 8) & 0x00FF0000) |
244 ((x >> 8) & 0x0000FF00) | (x >> 24)));
245}
uint32_t Uint32
Definition: SDL_stdinc.h:171

References SDL_static_cast.

Referenced by SDL_Swap64(), and SDL_SwapFloat().

◆ SDL_Swap64()

SDL_FORCE_INLINE Uint64 SDL_Swap64 ( Uint64  x)

Byte swap 64-bit integer.

Definition at line 289 of file SDL_endian.h.

290{
291 Uint32 hi, lo;
292
293 /* Separate into high and low 32-bit values and swap them */
294 lo = SDL_static_cast(Uint32, x & 0xFFFFFFFF);
295 x >>= 32;
296 hi = SDL_static_cast(Uint32, x & 0xFFFFFFFF);
297 x = SDL_Swap32(lo);
298 x <<= 32;
299 x |= SDL_Swap32(hi);
300 return (x);
301}
SDL_FORCE_INLINE Uint32 SDL_Swap32(Uint32 x)
Definition: SDL_endian.h:241

References SDL_static_cast, and SDL_Swap32().

◆ SDL_SwapFloat()

SDL_FORCE_INLINE float SDL_SwapFloat ( float  x)

Byte swap floating point number.

Definition at line 309 of file SDL_endian.h.

310{
311 union {
312 float f;
313 Uint32 ui32;
314 } swapper;
315 swapper.f = x;
316 swapper.ui32 = SDL_Swap32(swapper.ui32);
317 return swapper.f;
318}

References SDL_Swap32().