syncfiles/lib/defs.h

// Copyright 2022 Dietrich Epp.
// This file is part of SyncFiles. SyncFiles is licensed under the terms of the
// Mozilla Public License, version 2.0. See LICENSE.txt for details.
#ifndef LIB_DEFS_H
#define LIB_DEFS_H
// defs.h - common definitions.

// =============================================================================
// Target information
// =============================================================================

/*
	Macros we care about:

	TARGET_OS_MAC             OS is some Macintosh variant (broadly speaking)
	TARGET_API_MAC_OS8        Targeting classic Mac OS (9.x and earlier)

	TARGET_RT_LITTLE_ENDIAN   Little-endian byte order
	TARGET_RT_BIG_ENDIAN      Big-endian byte order
*/
#if macintosh

// Classic Mac OS. Header is part of Universal Interfaces & Carbon.
#include <ConditionalMacros.h>

// The target API macros do not exist until later versions of Universal
// Interfaces. For example, they do not exist in Universal Interfaces 3.1, which
// ships with CodeWarrior Pro 4.
#ifndef TARGET_API_MAC_OS8
#define TARGET_API_MAC_OS8 1
#endif

#elif __APPLE__

// Newer apple systems, including macOS >= 10. Header is in /usr/include, or
// within /usr/include inside the SDK.
#include <TargetConditionals.h>

#else

#if __BYTE_ORDER__
#if __BYTE_ORDER__ == __ORDER_LITTLE_ENDIAN__
#define TARGET_RT_LITTLE_ENDIAN 1
#define TARGET_RT_BIG_ENDIAN 0
#elif __BYTE_ORDER__ == __ORDER_BIG_ENDIAN__
#define TARGET_RT_LITTLE_ENDIAN 0
#define TARGET_RT_BIG_ENDIAN 1
#else
#error "unknown endian"
#endif
#else
#error "could not determine byte order"
#endif

#endif

// =============================================================================
// Basic types
// =============================================================================

#if TARGET_API_MAC_OS8

#include <MacTypes.h>

#else

// Include <stddef.h> for NULL.
#include <stddef.h>
#include <stdint.h>

#if __STDC_VERSION__ >= 199901l
#include <stdbool.h>
#endif

#if __bool_true_false_are_defined
typedef bool Boolean;
#else
enum {
	false,
	true,
};
typedef unsigned char Boolean;
#endif

typedef uint8_t UInt8;
typedef int8_t SInt8;
typedef uint16_t UInt16;
typedef int16_t SInt16;
typedef uint32_t UInt32;
typedef int32_t SInt32;
typedef uint64_t UInt64;
typedef int64_t SInt64;

typedef char *Ptr;
typedef Ptr *Handle;
typedef long Size;

#endif

// =============================================================================
// Memory allocation
// =============================================================================

/*
	These functions are used to work with memory from code that runs on both
	classic Mac OS systems and newer systems. Memory can be tight on very old
	Mac systems, and to make the most of it, we only relocatable blocks of
	memory (handles) whenever possible.
*/

#if TARGET_API_MAC_OS8

#include <MacMemory.h>

#else

// Allocate a relocatable block of memory.
Handle NewHandle(Size byteSize);

// Free a relocatable block of memory.
void DisposeHandle(Handle h);

#endif

/// Resize a relocatable block of memory. Return true on success.
Boolean ResizeHandle(Handle h, Size newSize);

// Fill memory with zeroes.
void MemClear(void *ptr, Size size);

// =============================================================================
// Utility Macros
// =============================================================================

#define ARRAY_COUNT(x) (sizeof(x) / sizeof(*(x)))

// =============================================================================
// Assertions
// =============================================================================

#if NDEBUG
#define assert(x) ((void)0)
#else
#include <assert.h>
#endif

#endif