490 lines
12 KiB
C++
490 lines
12 KiB
C++
|
|
// Globals.h
|
|
|
|
// This file gets included from every module in the project, so that global symbols may be introduced easily
|
|
// Also used for precompiled header generation in MSVC environments
|
|
|
|
|
|
|
|
|
|
|
|
// Compiler-dependent stuff:
|
|
#if defined(_MSC_VER)
|
|
// MSVC produces warning C4481 on the override keyword usage, so disable the warning altogether
|
|
#pragma warning(disable:4481)
|
|
|
|
// Disable some warnings that we don't care about:
|
|
#pragma warning(disable:4100) // Unreferenced formal parameter
|
|
|
|
// Useful warnings from warning level 4:
|
|
#pragma warning(3 : 4189) // Local variable is initialized but not referenced
|
|
#pragma warning(3 : 4245) // Conversion from 'type1' to 'type2', signed / unsigned mismatch
|
|
#pragma warning(3 : 4310) // Cast truncates constant value
|
|
#pragma warning(3 : 4389) // Signed / unsigned mismatch
|
|
#pragma warning(3 : 4505) // Unreferenced local function has been removed
|
|
#pragma warning(3 : 4701) // Potentially unitialized local variable used
|
|
#pragma warning(3 : 4702) // Unreachable code
|
|
#pragma warning(3 : 4706) // Assignment within conditional expression
|
|
|
|
// 2014-10-23 xoft: Disabled this because the new C++11 headers in MSVC produce tons of these warnings uselessly
|
|
// #pragma warning(3 : 4127) // Conditional expression is constant
|
|
|
|
// Disabling this warning, because we know what we're doing when we're doing this:
|
|
#pragma warning(disable: 4355) // 'this' used in initializer list
|
|
|
|
// Disabled because it's useless:
|
|
#pragma warning(disable: 4512) // 'class': assignment operator could not be generated - reported for each class that has a reference-type member
|
|
|
|
// 2014_01_06 xoft: Disabled this warning because MSVC is stupid and reports it in obviously wrong places
|
|
// #pragma warning(3 : 4244) // Conversion from 'type1' to 'type2', possible loss of data
|
|
|
|
#define OBSOLETE __declspec(deprecated)
|
|
|
|
// No alignment needed in MSVC
|
|
#define ALIGN_8
|
|
#define ALIGN_16
|
|
|
|
#define FORMATSTRING(formatIndex, va_argsIndex)
|
|
|
|
// MSVC has its own custom version of zu format
|
|
#define SIZE_T_FMT "%Iu"
|
|
#define SIZE_T_FMT_PRECISION(x) "%" #x "Iu"
|
|
#define SIZE_T_FMT_HEX "%Ix"
|
|
|
|
#define NORETURN __declspec(noreturn)
|
|
|
|
// Use non-standard defines in <cmath>
|
|
#define _USE_MATH_DEFINES
|
|
|
|
#elif defined(__GNUC__)
|
|
|
|
// TODO: Can GCC explicitly mark classes as abstract (no instances can be created)?
|
|
#define abstract
|
|
|
|
// override is part of c++11
|
|
#if __cplusplus < 201103L
|
|
#define override
|
|
#endif
|
|
|
|
#define OBSOLETE __attribute__((deprecated))
|
|
|
|
#define ALIGN_8 __attribute__((aligned(8)))
|
|
#define ALIGN_16 __attribute__((aligned(16)))
|
|
|
|
// Some portability macros :)
|
|
#define stricmp strcasecmp
|
|
|
|
#define FORMATSTRING(formatIndex, va_argsIndex) __attribute__((format (printf, formatIndex, va_argsIndex)))
|
|
|
|
#if defined(_WIN32)
|
|
// We're compiling on MinGW, which uses an old MSVCRT library that has no support for size_t printfing.
|
|
// We need direct size formats:
|
|
#if defined(_WIN64)
|
|
#define SIZE_T_FMT "%I64u"
|
|
#define SIZE_T_FMT_PRECISION(x) "%" #x "I64u"
|
|
#define SIZE_T_FMT_HEX "%I64x"
|
|
#else
|
|
#define SIZE_T_FMT "%u"
|
|
#define SIZE_T_FMT_PRECISION(x) "%" #x "u"
|
|
#define SIZE_T_FMT_HEX "%x"
|
|
#endif
|
|
#else
|
|
// We're compiling on Linux, so we can use libc's size_t printf format:
|
|
#define SIZE_T_FMT "%zu"
|
|
#define SIZE_T_FMT_PRECISION(x) "%" #x "zu"
|
|
#define SIZE_T_FMT_HEX "%zx"
|
|
#endif
|
|
|
|
#define NORETURN __attribute((__noreturn__))
|
|
|
|
#else
|
|
|
|
#error "You are using an unsupported compiler, you might need to #define some stuff here for your compiler"
|
|
|
|
/*
|
|
// Copy and uncomment this into another #elif section based on your compiler identification
|
|
|
|
// Explicitly mark classes as abstract (no instances can be created)
|
|
#define abstract
|
|
|
|
// Mark virtual methods as overriding (forcing them to have a virtual function of the same signature in the base class)
|
|
#define override
|
|
|
|
// Mark functions as obsolete, so that their usage results in a compile-time warning
|
|
#define OBSOLETE
|
|
|
|
// Mark types / variables for alignment. Do the platforms need it?
|
|
#define ALIGN_8
|
|
#define ALIGN_16
|
|
*/
|
|
|
|
#endif
|
|
|
|
|
|
#ifdef _DEBUG
|
|
#define NORETURNDEBUG NORETURN
|
|
#else
|
|
#define NORETURNDEBUG
|
|
#endif
|
|
|
|
|
|
#include <stddef.h>
|
|
|
|
|
|
// Integral types with predefined sizes:
|
|
typedef signed long long Int64;
|
|
typedef signed int Int32;
|
|
typedef signed short Int16;
|
|
typedef signed char Int8;
|
|
|
|
typedef unsigned long long UInt64;
|
|
typedef unsigned int UInt32;
|
|
typedef unsigned short UInt16;
|
|
typedef unsigned char UInt8;
|
|
|
|
typedef unsigned char Byte;
|
|
typedef Byte ColourID;
|
|
|
|
|
|
// If you get an error about specialization check the size of integral types
|
|
template <typename T, size_t Size, bool x = sizeof(T) == Size>
|
|
class SizeChecker;
|
|
|
|
template <typename T, size_t Size>
|
|
class SizeChecker<T, Size, true>
|
|
{
|
|
T v;
|
|
};
|
|
|
|
template class SizeChecker<Int64, 8>;
|
|
template class SizeChecker<Int32, 4>;
|
|
template class SizeChecker<Int16, 2>;
|
|
template class SizeChecker<Int8, 1>;
|
|
|
|
template class SizeChecker<UInt64, 8>;
|
|
template class SizeChecker<UInt32, 4>;
|
|
template class SizeChecker<UInt16, 2>;
|
|
template class SizeChecker<UInt8, 1>;
|
|
|
|
// A macro to disallow the copy constructor and operator = functions
|
|
// This should be used in the private: declarations for any class that shouldn't allow copying itself
|
|
#define DISALLOW_COPY_AND_ASSIGN(TypeName) \
|
|
TypeName(const TypeName &); \
|
|
void operator =(const TypeName &)
|
|
|
|
// A macro that is used to mark unused local variables, to avoid pedantic warnings in gcc / clang / MSVC
|
|
// Note that in MSVC it requires the full type of X to be known
|
|
#define UNUSED_VAR(X) (void)(X)
|
|
|
|
// A macro that is used to mark unused function parameters, to avoid pedantic warnings in gcc
|
|
// Written so that the full type of param needn't be known
|
|
#ifdef _MSC_VER
|
|
#define UNUSED(X)
|
|
#else
|
|
#define UNUSED UNUSED_VAR
|
|
#endif
|
|
|
|
|
|
|
|
|
|
// OS-dependent stuff:
|
|
#ifdef _WIN32
|
|
|
|
#define WIN32_LEAN_AND_MEAN
|
|
#define _WIN32_WINNT _WIN32_WINNT_WS03 // We want to target Windows XP with Service Pack 2 & Windows Server 2003 with Service Pack 1 and higher
|
|
|
|
// Windows SDK defines min and max macros, messing up with our std::min and std::max usage
|
|
#define NOMINMAX
|
|
|
|
#include <Windows.h>
|
|
#include <winsock2.h>
|
|
#include <Ws2tcpip.h> // IPv6 stuff
|
|
|
|
// Windows SDK defines GetFreeSpace as a constant, probably a Win16 API remnant
|
|
#ifdef GetFreeSpace
|
|
#undef GetFreeSpace
|
|
#endif // GetFreeSpace
|
|
#else
|
|
#include <sys/types.h>
|
|
#include <sys/time.h>
|
|
#include <sys/socket.h>
|
|
#include <netinet/in.h>
|
|
#include <arpa/inet.h>
|
|
#include <netdb.h>
|
|
#include <time.h>
|
|
#include <dirent.h>
|
|
#include <errno.h>
|
|
#include <iostream>
|
|
#include <cstdio>
|
|
#include <cstring>
|
|
#include <pthread.h>
|
|
#include <semaphore.h>
|
|
#include <errno.h>
|
|
#include <fcntl.h>
|
|
#include <unistd.h>
|
|
#endif
|
|
|
|
#if defined(ANDROID_NDK)
|
|
#define FILE_IO_PREFIX "/sdcard/Cuberite/"
|
|
#else
|
|
#define FILE_IO_PREFIX ""
|
|
#endif
|
|
|
|
|
|
|
|
|
|
|
|
// CRT stuff:
|
|
#include <sys/stat.h>
|
|
#include <cassert>
|
|
#include <cstdio>
|
|
#include <cmath>
|
|
#include <cstdarg>
|
|
|
|
|
|
|
|
|
|
|
|
// STL stuff:
|
|
#include <array>
|
|
#include <chrono>
|
|
#include <vector>
|
|
#include <list>
|
|
#include <deque>
|
|
#include <string>
|
|
#include <map>
|
|
#include <algorithm>
|
|
#include <memory>
|
|
#include <set>
|
|
#include <queue>
|
|
#include <limits>
|
|
#include <chrono>
|
|
|
|
|
|
|
|
|
|
// Common headers (part 1, without macros):
|
|
#include "StringUtils.h"
|
|
#include "OSSupport/CriticalSection.h"
|
|
#include "OSSupport/Event.h"
|
|
#include "OSSupport/File.h"
|
|
#include "OSSupport/StackTrace.h"
|
|
|
|
#ifndef TEST_GLOBALS
|
|
|
|
// These fiunctions are defined in Logger.cpp, but are declared here to avoid including all of logger.h
|
|
extern void LOG (const char * a_Format, ...) FORMATSTRING(1, 2);
|
|
extern void LOGINFO (const char * a_Format, ...) FORMATSTRING(1, 2);
|
|
extern void LOGWARNING(const char * a_Format, ...) FORMATSTRING(1, 2);
|
|
extern void LOGERROR (const char * a_Format, ...) FORMATSTRING(1, 2);
|
|
|
|
|
|
|
|
|
|
|
|
// In debug builds, translate LOGD to LOG, otherwise leave it out altogether:
|
|
#ifdef _DEBUG
|
|
#define LOGD LOG
|
|
#else
|
|
#define LOGD(...)
|
|
#endif // _DEBUG
|
|
|
|
#define LOGWARN LOGWARNING
|
|
#else
|
|
// Logging functions
|
|
void inline LOGERROR(const char * a_Format, ...) FORMATSTRING(1, 2);
|
|
|
|
void inline LOGERROR(const char * a_Format, ...)
|
|
{
|
|
va_list argList;
|
|
va_start(argList, a_Format);
|
|
vprintf(a_Format, argList);
|
|
putchar('\n');
|
|
va_end(argList);
|
|
}
|
|
|
|
void inline LOGWARNING(const char * a_Format, ...) FORMATSTRING(1, 2);
|
|
|
|
void inline LOGWARNING(const char * a_Format, ...)
|
|
{
|
|
va_list argList;
|
|
va_start(argList, a_Format);
|
|
vprintf(a_Format, argList);
|
|
putchar('\n');
|
|
va_end(argList);
|
|
}
|
|
|
|
void inline LOGD(const char * a_Format, ...) FORMATSTRING(1, 2);
|
|
|
|
void inline LOGD(const char * a_Format, ...)
|
|
{
|
|
va_list argList;
|
|
va_start(argList, a_Format);
|
|
vprintf(a_Format, argList);
|
|
putchar('\n');
|
|
va_end(argList);
|
|
}
|
|
|
|
void inline LOG(const char * a_Format, ...) FORMATSTRING(1, 2);
|
|
|
|
void inline LOG(const char * a_Format, ...)
|
|
{
|
|
va_list argList;
|
|
va_start(argList, a_Format);
|
|
vprintf(a_Format, argList);
|
|
putchar('\n');
|
|
va_end(argList);
|
|
}
|
|
|
|
#define LOGINFO LOG
|
|
#define LOGWARN LOGWARNING
|
|
|
|
#endif
|
|
|
|
|
|
|
|
|
|
|
|
// Common definitions:
|
|
|
|
/** Evaluates to the number of elements in an array (compile-time!) */
|
|
#define ARRAYCOUNT(X) (sizeof(X) / sizeof(*(X)))
|
|
|
|
/** Allows arithmetic expressions like "32 KiB" (but consider using parenthesis around it, "(32 KiB)") */
|
|
#define KiB * 1024
|
|
#define MiB * 1024 * 1024
|
|
|
|
/** Faster than (int)floorf((float)x / (float)div) */
|
|
#define FAST_FLOOR_DIV(x, div) (((x) - (((x) < 0) ? ((div) - 1) : 0)) / (div))
|
|
|
|
// Own version of assert() that writes failed assertions to the log for review
|
|
#ifdef TEST_GLOBALS
|
|
|
|
class cAssertFailure
|
|
{
|
|
};
|
|
|
|
#ifdef _WIN32
|
|
#if (defined(_MSC_VER) && defined(_DEBUG))
|
|
#define DBG_BREAK _CrtDbgBreak()
|
|
#else
|
|
#define DBG_BREAK
|
|
#endif
|
|
#define REPORT_ERROR(FMT, ...) \
|
|
{ \
|
|
AString msg = Printf(FMT, __VA_ARGS__); \
|
|
puts(msg.c_str()); \
|
|
fflush(stdout); \
|
|
OutputDebugStringA(msg.c_str()); \
|
|
DBG_BREAK; \
|
|
}
|
|
#else
|
|
#define REPORT_ERROR(FMT, ...) \
|
|
{ \
|
|
AString msg = Printf(FMT, __VA_ARGS__); \
|
|
puts(msg.c_str()); \
|
|
fflush(stdout); \
|
|
}
|
|
#endif
|
|
#define ASSERT(x) do { if (!(x)) { throw cAssertFailure();} } while (0)
|
|
#define testassert(x) do { if (!(x)) { REPORT_ERROR("Test failure: %s, file %s, line %d\n", #x, __FILE__, __LINE__); exit(1); } } while (0)
|
|
#define CheckAsserts(x) do { try {x} catch (cAssertFailure) { break; } REPORT_ERROR("Test failure: assert didn't fire for %s, file %s, line %d\n", #x, __FILE__, __LINE__); exit(1); } while (0)
|
|
|
|
#else
|
|
#ifdef _DEBUG
|
|
#define ASSERT( x) ( !!(x) || ( LOGERROR("Assertion failed: %s, file %s, line %i", #x, __FILE__, __LINE__), PrintStackTrace(), assert(0), 0))
|
|
#else
|
|
#define ASSERT(x) ((void)(x))
|
|
#endif
|
|
#endif
|
|
|
|
// Pretty much the same as ASSERT() but stays in Release builds
|
|
#define VERIFY( x) ( !!(x) || ( LOGERROR("Verification failed: %s, file %s, line %i", #x, __FILE__, __LINE__), PrintStackTrace(), exit(1), 0))
|
|
|
|
// Same as assert but in all Self test builds
|
|
#ifdef SELF_TEST
|
|
#define assert_test(x) ( !!(x) || (assert(!#x), exit(1), 0))
|
|
#endif
|
|
|
|
// Unified ptr types from before C++11. Also no silly undercores.
|
|
#define SharedPtr std::shared_ptr
|
|
#define WeakPtr std::weak_ptr
|
|
#define UniquePtr std::unique_ptr
|
|
|
|
|
|
|
|
|
|
|
|
/** A generic interface used mainly in ForEach() functions */
|
|
template <typename Type> class cItemCallback
|
|
{
|
|
public:
|
|
virtual ~cItemCallback() {}
|
|
|
|
/** Called for each item in the internal list; return true to stop the loop, or false to continue enumerating */
|
|
virtual bool Item(Type * a_Type) = 0;
|
|
} ;
|
|
|
|
|
|
|
|
|
|
/** Clamp X to the specified range. */
|
|
template <typename T>
|
|
T Clamp(T a_Value, T a_Min, T a_Max)
|
|
{
|
|
return (a_Value < a_Min) ? a_Min : ((a_Value > a_Max) ? a_Max : a_Value);
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
/** Floors a value, then casts it to C (an int by default) */
|
|
template <typename C = int, typename T>
|
|
typename std::enable_if<std::is_arithmetic<T>::value, C>::type FloorC(T a_Value)
|
|
{
|
|
return static_cast<C>(std::floor(a_Value));
|
|
}
|
|
|
|
/** Ceils a value, then casts it to C (an int by default) */
|
|
template <typename C = int, typename T>
|
|
typename std::enable_if<std::is_arithmetic<T>::value, C>::type CeilC(T a_Value)
|
|
{
|
|
return static_cast<C>(std::ceil(a_Value));
|
|
}
|
|
|
|
|
|
|
|
//temporary replacement for std::make_unique until we get c++14
|
|
|
|
namespace cpp14
|
|
{
|
|
template <class T, class... Args>
|
|
std::unique_ptr<T> make_unique(Args&&... args)
|
|
{
|
|
return std::unique_ptr<T>(new T(std::forward<Args>(args)...));
|
|
}
|
|
}
|
|
|
|
// a tick is 50 ms
|
|
using cTickTime = std::chrono::duration<int, std::ratio_multiply<std::chrono::milliseconds::period, std::ratio<50>>>;
|
|
using cTickTimeLong = std::chrono::duration<Int64, cTickTime::period>;
|
|
|
|
#ifndef TOLUA_TEMPLATE_BIND
|
|
#define TOLUA_TEMPLATE_BIND(x)
|
|
#endif
|
|
|
|
|
|
|
|
|
|
|
|
// Common headers (part 2, with macros):
|
|
#include "ChunkDef.h"
|
|
#include "BiomeDef.h"
|
|
#include "BlockID.h"
|
|
#include "BlockInfo.h"
|
|
|
|
|
|
|
|
|