mirror of
				https://github.com/libsdl-org/SDL.git
				synced 2025-11-04 09:44:35 +00:00 
			
		
		
		
	
		
			
				
	
	
		
			646 lines
		
	
	
		
			20 KiB
		
	
	
	
		
			C
		
	
	
	
	
	
			
		
		
	
	
			646 lines
		
	
	
		
			20 KiB
		
	
	
	
		
			C
		
	
	
	
	
	
/*
 | 
						|
  Simple DirectMedia Layer
 | 
						|
  Copyright (C) 1997-2025 Sam Lantinga <slouken@libsdl.org>
 | 
						|
 | 
						|
  This software is provided 'as-is', without any express or implied
 | 
						|
  warranty.  In no event will the authors be held liable for any damages
 | 
						|
  arising from the use of this software.
 | 
						|
 | 
						|
  Permission is granted to anyone to use this software for any purpose,
 | 
						|
  including commercial applications, and to alter it and redistribute it
 | 
						|
  freely, subject to the following restrictions:
 | 
						|
 | 
						|
  1. The origin of this software must not be misrepresented; you must not
 | 
						|
     claim that you wrote the original software. If you use this software
 | 
						|
     in a product, an acknowledgment in the product documentation would be
 | 
						|
     appreciated but is not required.
 | 
						|
  2. Altered source versions must be plainly marked as such, and must not be
 | 
						|
     misrepresented as being the original software.
 | 
						|
  3. This notice may not be removed or altered from any source distribution.
 | 
						|
*/
 | 
						|
 | 
						|
/**
 | 
						|
 * # CategoryEndian
 | 
						|
 *
 | 
						|
 * Functions converting endian-specific values to different byte orders.
 | 
						|
 *
 | 
						|
 * These functions either unconditionally swap byte order (SDL_Swap16,
 | 
						|
 * SDL_Swap32, SDL_Swap64, SDL_SwapFloat), or they swap to/from the system's
 | 
						|
 * native byte order (SDL_Swap16LE, SDL_Swap16BE, SDL_Swap32LE, SDL_Swap32BE,
 | 
						|
 * SDL_Swap32LE, SDL_Swap32BE, SDL_SwapFloatLE, SDL_SwapFloatBE). In the
 | 
						|
 * latter case, the functionality is provided by macros that become no-ops if
 | 
						|
 * a swap isn't necessary: on an x86 (littleendian) processor, SDL_Swap32LE
 | 
						|
 * does nothing, but SDL_Swap32BE reverses the bytes of the data. On a PowerPC
 | 
						|
 * processor (bigendian), the macros behavior is reversed.
 | 
						|
 *
 | 
						|
 * The swap routines are inline functions, and attempt to use compiler
 | 
						|
 * intrinsics, inline assembly, and other magic to make byteswapping
 | 
						|
 * efficient.
 | 
						|
 */
 | 
						|
 | 
						|
#ifndef SDL_endian_h_
 | 
						|
#define SDL_endian_h_
 | 
						|
 | 
						|
#include <SDL3/SDL_stdinc.h>
 | 
						|
 | 
						|
#if defined(_MSC_VER) && (_MSC_VER >= 1400)
 | 
						|
/* As of Clang 11, '_m_prefetchw' is conflicting with the winnt.h's version,
 | 
						|
   so we define the needed '_m_prefetch' here as a pseudo-header, until the issue is fixed. */
 | 
						|
#if defined(__clang__) &&  !SDL_HAS_BUILTIN(_m_prefetch)
 | 
						|
#ifndef __PRFCHWINTRIN_H
 | 
						|
#define __PRFCHWINTRIN_H
 | 
						|
static __inline__ void __attribute__((__always_inline__, __nodebug__))
 | 
						|
_m_prefetch(void *__P)
 | 
						|
{
 | 
						|
  __builtin_prefetch(__P, 0, 3 /* _MM_HINT_T0 */);
 | 
						|
}
 | 
						|
#endif /* __PRFCHWINTRIN_H */
 | 
						|
#endif /* __clang__ */
 | 
						|
 | 
						|
#include <intrin.h>
 | 
						|
#endif
 | 
						|
 | 
						|
/**
 | 
						|
 *  \name The two types of endianness
 | 
						|
 */
 | 
						|
/* @{ */
 | 
						|
 | 
						|
 | 
						|
/**
 | 
						|
 * A value to represent littleendian byteorder.
 | 
						|
 *
 | 
						|
 * This is used with the preprocessor macro SDL_BYTEORDER, to determine a
 | 
						|
 * platform's byte ordering:
 | 
						|
 *
 | 
						|
 * ```c
 | 
						|
 * #if SDL_BYTEORDER == SDL_LIL_ENDIAN
 | 
						|
 * SDL_Log("This system is littleendian.");
 | 
						|
 * #endif
 | 
						|
 * ```
 | 
						|
 *
 | 
						|
 * \since This macro is available since SDL 3.2.0.
 | 
						|
 *
 | 
						|
 * \sa SDL_BYTEORDER
 | 
						|
 * \sa SDL_BIG_ENDIAN
 | 
						|
 */
 | 
						|
#define SDL_LIL_ENDIAN  1234
 | 
						|
 | 
						|
/**
 | 
						|
 * A value to represent bigendian byteorder.
 | 
						|
 *
 | 
						|
 * This is used with the preprocessor macro SDL_BYTEORDER, to determine a
 | 
						|
 * platform's byte ordering:
 | 
						|
 *
 | 
						|
 * ```c
 | 
						|
 * #if SDL_BYTEORDER == SDL_BIG_ENDIAN
 | 
						|
 * SDL_Log("This system is bigendian.");
 | 
						|
 * #endif
 | 
						|
 * ```
 | 
						|
 *
 | 
						|
 * \since This macro is available since SDL 3.2.0.
 | 
						|
 *
 | 
						|
 * \sa SDL_BYTEORDER
 | 
						|
 * \sa SDL_LIL_ENDIAN
 | 
						|
 */
 | 
						|
#define SDL_BIG_ENDIAN  4321
 | 
						|
 | 
						|
/* @} */
 | 
						|
 | 
						|
#ifndef SDL_BYTEORDER
 | 
						|
#ifdef SDL_WIKI_DOCUMENTATION_SECTION
 | 
						|
 | 
						|
/**
 | 
						|
 * A macro that reports the target system's byte order.
 | 
						|
 *
 | 
						|
 * This is set to either SDL_LIL_ENDIAN or SDL_BIG_ENDIAN (and maybe other
 | 
						|
 * values in the future, if something else becomes popular). This can be
 | 
						|
 * tested with the preprocessor, so decisions can be made at compile time.
 | 
						|
 *
 | 
						|
 * ```c
 | 
						|
 * #if SDL_BYTEORDER == SDL_BIG_ENDIAN
 | 
						|
 * SDL_Log("This system is bigendian.");
 | 
						|
 * #endif
 | 
						|
 * ```
 | 
						|
 *
 | 
						|
 * \since This macro is available since SDL 3.2.0.
 | 
						|
 *
 | 
						|
 * \sa SDL_LIL_ENDIAN
 | 
						|
 * \sa SDL_BIG_ENDIAN
 | 
						|
 */
 | 
						|
#define SDL_BYTEORDER   SDL_LIL_ENDIAN___or_maybe___SDL_BIG_ENDIAN
 | 
						|
#elif defined(SDL_PLATFORM_LINUX) || defined(__GLIBC__)
 | 
						|
#include <endian.h>
 | 
						|
#define SDL_BYTEORDER  __BYTE_ORDER
 | 
						|
#elif defined(SDL_PLATFORM_SOLARIS)
 | 
						|
#include <sys/byteorder.h>
 | 
						|
#if defined(_LITTLE_ENDIAN)
 | 
						|
#define SDL_BYTEORDER   SDL_LIL_ENDIAN
 | 
						|
#elif defined(_BIG_ENDIAN)
 | 
						|
#define SDL_BYTEORDER   SDL_BIG_ENDIAN
 | 
						|
#else
 | 
						|
#error Unsupported endianness
 | 
						|
#endif
 | 
						|
#elif defined(SDL_PLATFORM_OPENBSD) || defined(__DragonFly__)
 | 
						|
#include <endian.h>
 | 
						|
#define SDL_BYTEORDER  BYTE_ORDER
 | 
						|
#elif defined(SDL_PLATFORM_FREEBSD) || defined(SDL_PLATFORM_NETBSD)
 | 
						|
#include <sys/endian.h>
 | 
						|
#define SDL_BYTEORDER  BYTE_ORDER
 | 
						|
/* predefs from newer gcc and clang versions: */
 | 
						|
#elif defined(__ORDER_LITTLE_ENDIAN__) && defined(__ORDER_BIG_ENDIAN__) && defined(__BYTE_ORDER__)
 | 
						|
#if (__BYTE_ORDER__ == __ORDER_LITTLE_ENDIAN__)
 | 
						|
#define SDL_BYTEORDER   SDL_LIL_ENDIAN
 | 
						|
#elif (__BYTE_ORDER__ == __ORDER_BIG_ENDIAN__)
 | 
						|
#define SDL_BYTEORDER   SDL_BIG_ENDIAN
 | 
						|
#else
 | 
						|
#error Unsupported endianness
 | 
						|
#endif /**/
 | 
						|
#else
 | 
						|
#if defined(__hppa__) || \
 | 
						|
    defined(__m68k__) || defined(mc68000) || defined(_M_M68K) || \
 | 
						|
    (defined(__MIPS__) && defined(__MIPSEB__)) || \
 | 
						|
    defined(__ppc__) || defined(__POWERPC__) || defined(__powerpc__) || defined(__PPC__) || \
 | 
						|
    defined(__sparc__) || defined(__sparc)
 | 
						|
#define SDL_BYTEORDER   SDL_BIG_ENDIAN
 | 
						|
#else
 | 
						|
#define SDL_BYTEORDER   SDL_LIL_ENDIAN
 | 
						|
#endif
 | 
						|
#endif /* SDL_PLATFORM_LINUX */
 | 
						|
#endif /* !SDL_BYTEORDER */
 | 
						|
 | 
						|
#ifndef SDL_FLOATWORDORDER
 | 
						|
#ifdef SDL_WIKI_DOCUMENTATION_SECTION
 | 
						|
 | 
						|
/**
 | 
						|
 * A macro that reports the target system's floating point word order.
 | 
						|
 *
 | 
						|
 * This is set to either SDL_LIL_ENDIAN or SDL_BIG_ENDIAN (and maybe other
 | 
						|
 * values in the future, if something else becomes popular). This can be
 | 
						|
 * tested with the preprocessor, so decisions can be made at compile time.
 | 
						|
 *
 | 
						|
 * ```c
 | 
						|
 * #if SDL_FLOATWORDORDER == SDL_BIG_ENDIAN
 | 
						|
 * SDL_Log("This system's floats are bigendian.");
 | 
						|
 * #endif
 | 
						|
 * ```
 | 
						|
 *
 | 
						|
 * \since This macro is available since SDL 3.2.0.
 | 
						|
 *
 | 
						|
 * \sa SDL_LIL_ENDIAN
 | 
						|
 * \sa SDL_BIG_ENDIAN
 | 
						|
 */
 | 
						|
#define SDL_FLOATWORDORDER   SDL_LIL_ENDIAN___or_maybe___SDL_BIG_ENDIAN
 | 
						|
/* predefs from newer gcc versions: */
 | 
						|
#elif defined(__ORDER_LITTLE_ENDIAN__) && defined(__ORDER_BIG_ENDIAN__) && defined(__FLOAT_WORD_ORDER__)
 | 
						|
#if (__FLOAT_WORD_ORDER__ == __ORDER_LITTLE_ENDIAN__)
 | 
						|
#define SDL_FLOATWORDORDER   SDL_LIL_ENDIAN
 | 
						|
#elif (__FLOAT_WORD_ORDER__ == __ORDER_BIG_ENDIAN__)
 | 
						|
#define SDL_FLOATWORDORDER   SDL_BIG_ENDIAN
 | 
						|
#else
 | 
						|
#error Unsupported endianness
 | 
						|
#endif /**/
 | 
						|
#elif defined(__MAVERICK__)
 | 
						|
/* For Maverick, float words are always little-endian. */
 | 
						|
#define SDL_FLOATWORDORDER   SDL_LIL_ENDIAN
 | 
						|
#elif (defined(__arm__) || defined(__thumb__)) && !defined(__VFP_FP__) && !defined(__ARM_EABI__)
 | 
						|
/* For FPA, float words are always big-endian. */
 | 
						|
#define SDL_FLOATWORDORDER   SDL_BIG_ENDIAN
 | 
						|
#else
 | 
						|
/* By default, assume that floats words follow the memory system mode. */
 | 
						|
#define SDL_FLOATWORDORDER   SDL_BYTEORDER
 | 
						|
#endif /* __FLOAT_WORD_ORDER__ */
 | 
						|
#endif /* !SDL_FLOATWORDORDER */
 | 
						|
 | 
						|
 | 
						|
#include <SDL3/SDL_begin_code.h>
 | 
						|
/* Set up for C function definitions, even when using C++ */
 | 
						|
#ifdef __cplusplus
 | 
						|
extern "C" {
 | 
						|
#endif
 | 
						|
 | 
						|
/* various modern compilers may have builtin swap */
 | 
						|
#if defined(__GNUC__) || defined(__clang__)
 | 
						|
#   define HAS_BUILTIN_BSWAP16 (SDL_HAS_BUILTIN(__builtin_bswap16)) || \
 | 
						|
        (__GNUC__ > 4 || (__GNUC__ == 4 && __GNUC_MINOR__ >= 8))
 | 
						|
#   define HAS_BUILTIN_BSWAP32 (SDL_HAS_BUILTIN(__builtin_bswap32)) || \
 | 
						|
        (__GNUC__ > 4 || (__GNUC__ == 4 && __GNUC_MINOR__ >= 3))
 | 
						|
#   define HAS_BUILTIN_BSWAP64 (SDL_HAS_BUILTIN(__builtin_bswap64)) || \
 | 
						|
        (__GNUC__ > 4 || (__GNUC__ == 4 && __GNUC_MINOR__ >= 3))
 | 
						|
 | 
						|
    /* this one is broken */
 | 
						|
#   define HAS_BROKEN_BSWAP (__GNUC__ == 2 && __GNUC_MINOR__ <= 95)
 | 
						|
#else
 | 
						|
#   define HAS_BUILTIN_BSWAP16 0
 | 
						|
#   define HAS_BUILTIN_BSWAP32 0
 | 
						|
#   define HAS_BUILTIN_BSWAP64 0
 | 
						|
#   define HAS_BROKEN_BSWAP 0
 | 
						|
#endif
 | 
						|
 | 
						|
/* Byte swap 16-bit integer. */
 | 
						|
#ifndef SDL_WIKI_DOCUMENTATION_SECTION
 | 
						|
#if HAS_BUILTIN_BSWAP16
 | 
						|
#define SDL_Swap16(x) __builtin_bswap16(x)
 | 
						|
#elif (defined(_MSC_VER) && (_MSC_VER >= 1400)) && !defined(__ICL)
 | 
						|
#pragma intrinsic(_byteswap_ushort)
 | 
						|
#define SDL_Swap16(x) _byteswap_ushort(x)
 | 
						|
#elif defined(__i386__) && !HAS_BROKEN_BSWAP
 | 
						|
SDL_FORCE_INLINE Uint16 SDL_Swap16(Uint16 x)
 | 
						|
{
 | 
						|
  __asm__("xchgb %b0,%h0": "=q"(x):"0"(x));
 | 
						|
    return x;
 | 
						|
}
 | 
						|
#elif defined(__x86_64__)
 | 
						|
SDL_FORCE_INLINE Uint16 SDL_Swap16(Uint16 x)
 | 
						|
{
 | 
						|
  __asm__("xchgb %b0,%h0": "=Q"(x):"0"(x));
 | 
						|
    return x;
 | 
						|
}
 | 
						|
#elif (defined(__powerpc__) || defined(__ppc__))
 | 
						|
SDL_FORCE_INLINE Uint16 SDL_Swap16(Uint16 x)
 | 
						|
{
 | 
						|
    int result;
 | 
						|
 | 
						|
  __asm__("rlwimi %0,%2,8,16,23": "=&r"(result):"0"(x >> 8), "r"(x));
 | 
						|
    return (Uint16)result;
 | 
						|
}
 | 
						|
#elif (defined(__m68k__) && !defined(__mcoldfire__))
 | 
						|
SDL_FORCE_INLINE Uint16 SDL_Swap16(Uint16 x)
 | 
						|
{
 | 
						|
  __asm__("rorw #8,%0": "=d"(x): "0"(x):"cc");
 | 
						|
    return x;
 | 
						|
}
 | 
						|
#elif defined(__WATCOMC__) && defined(__386__)
 | 
						|
extern __inline Uint16 SDL_Swap16(Uint16);
 | 
						|
#pragma aux SDL_Swap16 = \
 | 
						|
  "xchg al, ah" \
 | 
						|
  parm   [ax]   \
 | 
						|
  modify [ax];
 | 
						|
#else
 | 
						|
SDL_FORCE_INLINE Uint16 SDL_Swap16(Uint16 x)
 | 
						|
{
 | 
						|
    return SDL_static_cast(Uint16, ((x << 8) | (x >> 8)));
 | 
						|
}
 | 
						|
#endif
 | 
						|
#endif
 | 
						|
 | 
						|
/* Byte swap 32-bit integer. */
 | 
						|
#ifndef SDL_WIKI_DOCUMENTATION_SECTION
 | 
						|
#if HAS_BUILTIN_BSWAP32
 | 
						|
#define SDL_Swap32(x) __builtin_bswap32(x)
 | 
						|
#elif (defined(_MSC_VER) && (_MSC_VER >= 1400)) && !defined(__ICL)
 | 
						|
#pragma intrinsic(_byteswap_ulong)
 | 
						|
#define SDL_Swap32(x) _byteswap_ulong(x)
 | 
						|
#elif defined(__i386__) && !HAS_BROKEN_BSWAP
 | 
						|
SDL_FORCE_INLINE Uint32 SDL_Swap32(Uint32 x)
 | 
						|
{
 | 
						|
  __asm__("bswap %0": "=r"(x):"0"(x));
 | 
						|
    return x;
 | 
						|
}
 | 
						|
#elif defined(__x86_64__)
 | 
						|
SDL_FORCE_INLINE Uint32 SDL_Swap32(Uint32 x)
 | 
						|
{
 | 
						|
  __asm__("bswapl %0": "=r"(x):"0"(x));
 | 
						|
    return x;
 | 
						|
}
 | 
						|
#elif (defined(__powerpc__) || defined(__ppc__))
 | 
						|
SDL_FORCE_INLINE Uint32 SDL_Swap32(Uint32 x)
 | 
						|
{
 | 
						|
    Uint32 result;
 | 
						|
 | 
						|
  __asm__("rlwimi %0,%2,24,16,23": "=&r"(result): "0" (x>>24),  "r"(x));
 | 
						|
  __asm__("rlwimi %0,%2,8,8,15"  : "=&r"(result): "0" (result), "r"(x));
 | 
						|
  __asm__("rlwimi %0,%2,24,0,7"  : "=&r"(result): "0" (result), "r"(x));
 | 
						|
    return result;
 | 
						|
}
 | 
						|
#elif (defined(__m68k__) && !defined(__mcoldfire__))
 | 
						|
SDL_FORCE_INLINE Uint32 SDL_Swap32(Uint32 x)
 | 
						|
{
 | 
						|
  __asm__("rorw #8,%0\n\tswap %0\n\trorw #8,%0": "=d"(x): "0"(x):"cc");
 | 
						|
    return x;
 | 
						|
}
 | 
						|
#elif defined(__WATCOMC__) && defined(__386__)
 | 
						|
extern __inline Uint32 SDL_Swap32(Uint32);
 | 
						|
#pragma aux SDL_Swap32 = \
 | 
						|
  "bswap eax"  \
 | 
						|
  parm   [eax] \
 | 
						|
  modify [eax];
 | 
						|
#else
 | 
						|
SDL_FORCE_INLINE Uint32 SDL_Swap32(Uint32 x)
 | 
						|
{
 | 
						|
    return SDL_static_cast(Uint32, ((x << 24) | ((x << 8) & 0x00FF0000) |
 | 
						|
                                    ((x >> 8) & 0x0000FF00) | (x >> 24)));
 | 
						|
}
 | 
						|
#endif
 | 
						|
#endif
 | 
						|
 | 
						|
/* Byte swap 64-bit integer. */
 | 
						|
#ifndef SDL_WIKI_DOCUMENTATION_SECTION
 | 
						|
#if HAS_BUILTIN_BSWAP64
 | 
						|
#define SDL_Swap64(x) __builtin_bswap64(x)
 | 
						|
#elif (defined(_MSC_VER) && (_MSC_VER >= 1400)) && !defined(__ICL)
 | 
						|
#pragma intrinsic(_byteswap_uint64)
 | 
						|
#define SDL_Swap64(x) _byteswap_uint64(x)
 | 
						|
#elif defined(__i386__) && !HAS_BROKEN_BSWAP
 | 
						|
SDL_FORCE_INLINE Uint64 SDL_Swap64(Uint64 x)
 | 
						|
{
 | 
						|
    union {
 | 
						|
        struct {
 | 
						|
            Uint32 a, b;
 | 
						|
        } s;
 | 
						|
        Uint64 u;
 | 
						|
    } v;
 | 
						|
    v.u = x;
 | 
						|
  __asm__("bswapl %0 ; bswapl %1 ; xchgl %0,%1"
 | 
						|
          : "=r"(v.s.a), "=r"(v.s.b)
 | 
						|
          : "0" (v.s.a),  "1"(v.s.b));
 | 
						|
    return v.u;
 | 
						|
}
 | 
						|
#elif defined(__x86_64__)
 | 
						|
SDL_FORCE_INLINE Uint64 SDL_Swap64(Uint64 x)
 | 
						|
{
 | 
						|
  __asm__("bswapq %0": "=r"(x):"0"(x));
 | 
						|
    return x;
 | 
						|
}
 | 
						|
#elif defined(__WATCOMC__) && defined(__386__)
 | 
						|
extern __inline Uint64 SDL_Swap64(Uint64);
 | 
						|
#pragma aux SDL_Swap64 = \
 | 
						|
  "bswap eax"     \
 | 
						|
  "bswap edx"     \
 | 
						|
  "xchg eax,edx"  \
 | 
						|
  parm [eax edx]  \
 | 
						|
  modify [eax edx];
 | 
						|
#else
 | 
						|
SDL_FORCE_INLINE Uint64 SDL_Swap64(Uint64 x)
 | 
						|
{
 | 
						|
    Uint32 hi, lo;
 | 
						|
 | 
						|
    /* Separate into high and low 32-bit values and swap them */
 | 
						|
    lo = SDL_static_cast(Uint32, x & 0xFFFFFFFF);
 | 
						|
    x >>= 32;
 | 
						|
    hi = SDL_static_cast(Uint32, x & 0xFFFFFFFF);
 | 
						|
    x = SDL_Swap32(lo);
 | 
						|
    x <<= 32;
 | 
						|
    x |= SDL_Swap32(hi);
 | 
						|
    return (x);
 | 
						|
}
 | 
						|
#endif
 | 
						|
#endif
 | 
						|
 | 
						|
/**
 | 
						|
 * Byte-swap a floating point number.
 | 
						|
 *
 | 
						|
 * This will always byte-swap the value, whether it's currently in the native
 | 
						|
 * byteorder of the system or not. You should use SDL_SwapFloatLE or
 | 
						|
 * SDL_SwapFloatBE instead, in most cases.
 | 
						|
 *
 | 
						|
 * Note that this is a forced-inline function in a header, and not a public
 | 
						|
 * API function available in the SDL library (which is to say, the code is
 | 
						|
 * embedded in the calling program and the linker and dynamic loader will not
 | 
						|
 * be able to find this function inside SDL itself).
 | 
						|
 *
 | 
						|
 * \param x the value to byte-swap.
 | 
						|
 * \returns x, with its bytes in the opposite endian order.
 | 
						|
 *
 | 
						|
 * \threadsafety It is safe to call this function from any thread.
 | 
						|
 *
 | 
						|
 * \since This function is available since SDL 3.2.0.
 | 
						|
 */
 | 
						|
SDL_FORCE_INLINE float SDL_SwapFloat(float x)
 | 
						|
{
 | 
						|
    union {
 | 
						|
        float f;
 | 
						|
        Uint32 ui32;
 | 
						|
    } swapper;
 | 
						|
    swapper.f = x;
 | 
						|
    swapper.ui32 = SDL_Swap32(swapper.ui32);
 | 
						|
    return swapper.f;
 | 
						|
}
 | 
						|
 | 
						|
/* remove extra macros */
 | 
						|
#undef HAS_BROKEN_BSWAP
 | 
						|
#undef HAS_BUILTIN_BSWAP16
 | 
						|
#undef HAS_BUILTIN_BSWAP32
 | 
						|
#undef HAS_BUILTIN_BSWAP64
 | 
						|
 | 
						|
 | 
						|
#ifdef SDL_WIKI_DOCUMENTATION_SECTION
 | 
						|
 | 
						|
/**
 | 
						|
 * Byte-swap an unsigned 16-bit number.
 | 
						|
 *
 | 
						|
 * This will always byte-swap the value, whether it's currently in the native
 | 
						|
 * byteorder of the system or not. You should use SDL_Swap16LE or SDL_Swap16BE
 | 
						|
 * instead, in most cases.
 | 
						|
 *
 | 
						|
 * Note that this is a forced-inline function in a header, and not a public
 | 
						|
 * API function available in the SDL library (which is to say, the code is
 | 
						|
 * embedded in the calling program and the linker and dynamic loader will not
 | 
						|
 * be able to find this function inside SDL itself).
 | 
						|
 *
 | 
						|
 * \param x the value to byte-swap.
 | 
						|
 * \returns `x`, with its bytes in the opposite endian order.
 | 
						|
 *
 | 
						|
 * \threadsafety It is safe to call this function from any thread.
 | 
						|
 *
 | 
						|
 * \since This function is available since SDL 3.2.0.
 | 
						|
 */
 | 
						|
SDL_FORCE_INLINE Uint16 SDL_Swap16(Uint16 x) { return x_but_byteswapped; }
 | 
						|
 | 
						|
/**
 | 
						|
 * Byte-swap an unsigned 32-bit number.
 | 
						|
 *
 | 
						|
 * This will always byte-swap the value, whether it's currently in the native
 | 
						|
 * byteorder of the system or not. You should use SDL_Swap32LE or SDL_Swap32BE
 | 
						|
 * instead, in most cases.
 | 
						|
 *
 | 
						|
 * Note that this is a forced-inline function in a header, and not a public
 | 
						|
 * API function available in the SDL library (which is to say, the code is
 | 
						|
 * embedded in the calling program and the linker and dynamic loader will not
 | 
						|
 * be able to find this function inside SDL itself).
 | 
						|
 *
 | 
						|
 * \param x the value to byte-swap.
 | 
						|
 * \returns `x`, with its bytes in the opposite endian order.
 | 
						|
 *
 | 
						|
 * \threadsafety It is safe to call this function from any thread.
 | 
						|
 *
 | 
						|
 * \since This function is available since SDL 3.2.0.
 | 
						|
 */
 | 
						|
SDL_FORCE_INLINE Uint32 SDL_Swap32(Uint32 x) { return x_but_byteswapped; }
 | 
						|
 | 
						|
/**
 | 
						|
 * Byte-swap an unsigned 64-bit number.
 | 
						|
 *
 | 
						|
 * This will always byte-swap the value, whether it's currently in the native
 | 
						|
 * byteorder of the system or not. You should use SDL_Swap64LE or SDL_Swap64BE
 | 
						|
 * instead, in most cases.
 | 
						|
 *
 | 
						|
 * Note that this is a forced-inline function in a header, and not a public
 | 
						|
 * API function available in the SDL library (which is to say, the code is
 | 
						|
 * embedded in the calling program and the linker and dynamic loader will not
 | 
						|
 * be able to find this function inside SDL itself).
 | 
						|
 *
 | 
						|
 * \param x the value to byte-swap.
 | 
						|
 * \returns `x`, with its bytes in the opposite endian order.
 | 
						|
 *
 | 
						|
 * \threadsafety It is safe to call this function from any thread.
 | 
						|
 *
 | 
						|
 * \since This function is available since SDL 3.2.0.
 | 
						|
 */
 | 
						|
SDL_FORCE_INLINE Uint64 SDL_Swap64(Uint64 x) { return x_but_byteswapped; }
 | 
						|
 | 
						|
/**
 | 
						|
 * Swap a 16-bit value from littleendian to native byte order.
 | 
						|
 *
 | 
						|
 * If this is running on a littleendian system, `x` is returned unchanged.
 | 
						|
 *
 | 
						|
 * This macro never references `x` more than once, avoiding side effects.
 | 
						|
 *
 | 
						|
 * \param x the value to swap, in littleendian byte order.
 | 
						|
 * \returns `x` in native byte order.
 | 
						|
 *
 | 
						|
 * \threadsafety It is safe to call this macro from any thread.
 | 
						|
 *
 | 
						|
 * \since This macro is available since SDL 3.2.0.
 | 
						|
 */
 | 
						|
#define SDL_Swap16LE(x) SwapOnlyIfNecessary(x)
 | 
						|
 | 
						|
/**
 | 
						|
 * Swap a 32-bit value from littleendian to native byte order.
 | 
						|
 *
 | 
						|
 * If this is running on a littleendian system, `x` is returned unchanged.
 | 
						|
 *
 | 
						|
 * This macro never references `x` more than once, avoiding side effects.
 | 
						|
 *
 | 
						|
 * \param x the value to swap, in littleendian byte order.
 | 
						|
 * \returns `x` in native byte order.
 | 
						|
 *
 | 
						|
 * \threadsafety It is safe to call this macro from any thread.
 | 
						|
 *
 | 
						|
 * \since This macro is available since SDL 3.2.0.
 | 
						|
 */
 | 
						|
#define SDL_Swap32LE(x) SwapOnlyIfNecessary(x)
 | 
						|
 | 
						|
/**
 | 
						|
 * Swap a 64-bit value from littleendian to native byte order.
 | 
						|
 *
 | 
						|
 * If this is running on a littleendian system, `x` is returned unchanged.
 | 
						|
 *
 | 
						|
 * This macro never references `x` more than once, avoiding side effects.
 | 
						|
 *
 | 
						|
 * \param x the value to swap, in littleendian byte order.
 | 
						|
 * \returns `x` in native byte order.
 | 
						|
 *
 | 
						|
 * \threadsafety It is safe to call this macro from any thread.
 | 
						|
 *
 | 
						|
 * \since This macro is available since SDL 3.2.0.
 | 
						|
 */
 | 
						|
#define SDL_Swap64LE(x) SwapOnlyIfNecessary(x)
 | 
						|
 | 
						|
/**
 | 
						|
 * Swap a floating point value from littleendian to native byte order.
 | 
						|
 *
 | 
						|
 * If this is running on a littleendian system, `x` is returned unchanged.
 | 
						|
 *
 | 
						|
 * This macro never references `x` more than once, avoiding side effects.
 | 
						|
 *
 | 
						|
 * \param x the value to swap, in littleendian byte order.
 | 
						|
 * \returns `x` in native byte order.
 | 
						|
 *
 | 
						|
 * \threadsafety It is safe to call this macro from any thread.
 | 
						|
 *
 | 
						|
 * \since This macro is available since SDL 3.2.0.
 | 
						|
 */
 | 
						|
#define SDL_SwapFloatLE(x) SwapOnlyIfNecessary(x)
 | 
						|
 | 
						|
/**
 | 
						|
 * Swap a 16-bit value from bigendian to native byte order.
 | 
						|
 *
 | 
						|
 * If this is running on a bigendian system, `x` is returned unchanged.
 | 
						|
 *
 | 
						|
 * This macro never references `x` more than once, avoiding side effects.
 | 
						|
 *
 | 
						|
 * \param x the value to swap, in bigendian byte order.
 | 
						|
 * \returns `x` in native byte order.
 | 
						|
 *
 | 
						|
 * \threadsafety It is safe to call this macro from any thread.
 | 
						|
 *
 | 
						|
 * \since This macro is available since SDL 3.2.0.
 | 
						|
 */
 | 
						|
#define SDL_Swap16BE(x) SwapOnlyIfNecessary(x)
 | 
						|
 | 
						|
/**
 | 
						|
 * Swap a 32-bit value from bigendian to native byte order.
 | 
						|
 *
 | 
						|
 * If this is running on a bigendian system, `x` is returned unchanged.
 | 
						|
 *
 | 
						|
 * This macro never references `x` more than once, avoiding side effects.
 | 
						|
 *
 | 
						|
 * \param x the value to swap, in bigendian byte order.
 | 
						|
 * \returns `x` in native byte order.
 | 
						|
 *
 | 
						|
 * \threadsafety It is safe to call this macro from any thread.
 | 
						|
 *
 | 
						|
 * \since This macro is available since SDL 3.2.0.
 | 
						|
 */
 | 
						|
#define SDL_Swap32BE(x) SwapOnlyIfNecessary(x)
 | 
						|
 | 
						|
/**
 | 
						|
 * Swap a 64-bit value from bigendian to native byte order.
 | 
						|
 *
 | 
						|
 * If this is running on a bigendian system, `x` is returned unchanged.
 | 
						|
 *
 | 
						|
 * This macro never references `x` more than once, avoiding side effects.
 | 
						|
 *
 | 
						|
 * \param x the value to swap, in bigendian byte order.
 | 
						|
 * \returns `x` in native byte order.
 | 
						|
 *
 | 
						|
 * \threadsafety It is safe to call this macro from any thread.
 | 
						|
 *
 | 
						|
 * \since This macro is available since SDL 3.2.0.
 | 
						|
 */
 | 
						|
#define SDL_Swap64BE(x) SwapOnlyIfNecessary(x)
 | 
						|
 | 
						|
/**
 | 
						|
 * Swap a floating point value from bigendian to native byte order.
 | 
						|
 *
 | 
						|
 * If this is running on a bigendian system, `x` is returned unchanged.
 | 
						|
 *
 | 
						|
 * This macro never references `x` more than once, avoiding side effects.
 | 
						|
 *
 | 
						|
 * \param x the value to swap, in bigendian byte order.
 | 
						|
 * \returns `x` in native byte order.
 | 
						|
 *
 | 
						|
 * \threadsafety It is safe to call this macro from any thread.
 | 
						|
 *
 | 
						|
 * \since This macro is available since SDL 3.2.0.
 | 
						|
 */
 | 
						|
#define SDL_SwapFloatBE(x) SwapOnlyIfNecessary(x)
 | 
						|
 | 
						|
#elif SDL_BYTEORDER == SDL_LIL_ENDIAN
 | 
						|
#define SDL_Swap16LE(x)     (x)
 | 
						|
#define SDL_Swap32LE(x)     (x)
 | 
						|
#define SDL_Swap64LE(x)     (x)
 | 
						|
#define SDL_SwapFloatLE(x)  (x)
 | 
						|
#define SDL_Swap16BE(x)     SDL_Swap16(x)
 | 
						|
#define SDL_Swap32BE(x)     SDL_Swap32(x)
 | 
						|
#define SDL_Swap64BE(x)     SDL_Swap64(x)
 | 
						|
#define SDL_SwapFloatBE(x)  SDL_SwapFloat(x)
 | 
						|
#else
 | 
						|
#define SDL_Swap16LE(x)     SDL_Swap16(x)
 | 
						|
#define SDL_Swap32LE(x)     SDL_Swap32(x)
 | 
						|
#define SDL_Swap64LE(x)     SDL_Swap64(x)
 | 
						|
#define SDL_SwapFloatLE(x)  SDL_SwapFloat(x)
 | 
						|
#define SDL_Swap16BE(x)     (x)
 | 
						|
#define SDL_Swap32BE(x)     (x)
 | 
						|
#define SDL_Swap64BE(x)     (x)
 | 
						|
#define SDL_SwapFloatBE(x)  (x)
 | 
						|
#endif
 | 
						|
 | 
						|
/* Ends C function definitions when using C++ */
 | 
						|
#ifdef __cplusplus
 | 
						|
}
 | 
						|
#endif
 | 
						|
#include <SDL3/SDL_close_code.h>
 | 
						|
 | 
						|
#endif /* SDL_endian_h_ */
 |