Plattform-Makros

…für Plattform- und Compilerübergreifende Programme (Stichwort: Portabilität)

Zuerst kommt die Ermittlung/Bestimmung des Compilers und danach der Plattform, weil viele Makros vom Compiler selbst gesetzt werden und sind deshalb Compiler-abhängig.

Eine große Übersicht von Makros im Bezug auf Compiler und Plattforme sind hier zu finden:

• "C/C++ tip: How to detect the operating system type using compiler predefined macros" (Stand: 03.01.2012): http://nadeausoftware.com/articles/2012/01/c_c_tip_how_use_compiler_predefined_macros_detect_operating_system
• "C/C++ tip: How to list compiler predefined macros" (Stand: 07.12.2011): http://nadeausoftware.com/articles/2011/12/c_c_tip_how_list_compiler_predefined_macros

Anhand folgender Makros läßt sich feststellen, mit welchem Compiler der Quelltext übersetzt wird:

// Test for GCC > 3.2.0
#if __GNUC__ > 3 || (__GNUC__ == 3 && (__GNUC_MINOR__ > 2 || (__GNUC_MINOR__ == 2 && __GNUC_PATCHLEVEL__ > 0))
#endif

#define GCC_VERSION (__GNUC__ * 10000 + __GNUC_MINOR__ * 100 + __GNUC_PATCHLEVEL__)
// Test for GCC > 3.2.0
#if GCC_VERSION > 30200
#endif

Quelle: https://gcc.gnu.org/onlinedocs/cpp/Common-Predefined-Macros.html

Weitere Compiler:

Sprach-Level:

// Es muss mindestens C++11 sein:
#if (__cplusplus < 201103L)
#error ---------- C++11 features not available - use the GCC-option -std=c++11 ----------
#endif

#if (__cplusplus < 201402L) // vor C++14
#include <memory>
namespace std
{
	template<typename T, typename ...Args>
	std::unique_ptr<T> make_unique(Args&& ...args)
	{
		return std::unique_ptr<T>(new T(std::forward<Args>(args)...));
	}
}
#endif

IN ARBEIT - Anfang

Unterscheidung auf HW-Ebene:

• Prozessorarchitektur (z.B. "x86" oder "sparc") - welche Kürzel?
• Bit-Breite (z.B. 32- oder 64-Bit)
• Endianes (z.B. Big-/Little-Endian)

HW = Prozessorarchitektur + Bit-Breite + Endianes

Folgende Makros können für die Bestimmung der HW-Ebene herangezogen werden:

• Prozessorarchitektur:

Dieses Makros werden durch den MS VisualStudio-Compiler gesetzt:

• Bit-Breite:

• Endianes:

// Test for a little-endian machine:
#if __BYTE_ORDER__ == __ORDER_LITTLE_ENDIAN__
#endif

Unterscheidung auf SW-Ebene:

• OS-Familie (z.B. "unix", "linux", "windows")
• OS-Name/-Derivat (innerhalb der Familie, z.B. "solaris", "debian")
• Namenszusatz (z.B. Nummer 6 bei RHEL6 oder 10 bei Windows10)
• Bit-Breite (z.B. 32- oder 64-Bit)

OS = OS-Familie + OS-Name + Namenszusatz + Bit-Breite

Makro	Kommentar
Windows-Familie	MS VisualStudio-Compiler
_WIN32	Definiert für Win32- und Win64-Anwendungen. (Immer definiert.) Hinweis: Nicht mit "WIN32" (ohne Unterstrich) verwechseln! "_WIN32" wird durch den Compiler gesetzt, "WIN32" durch das SDK oder Build Environment.
_WIN64	Definiert nur für Win64-Anwendungen.
UNIXoide
__unix __unix__	Definiert auf allen / meisten UNIX-artigen Betriebssystemen.
_AIX	Definiert unter AIX.
sun __sun __sun__ __SVR4	Definiert unter SunOS / Solaris. ( Klären: SunOS versus Solaris.)
__FreeBSD__	FreeBSD.
__NetBSD__	NetBSD.
__OpenBSD__	OpenBSD.
__hpux	HP-UX.
__APPLE__ __MACH__	Definiert unter OSX, iOS und Darwin. Zur weiteren Unterscheidung werden Makros aus TargetConditionals.h herangezogen: TARGET_OS_EMBEDDED, TARGET_OS_IPHONE, TARGET_OS_MAC und TARGET_IPHONE_SIMULATOR
Linux
__linux__ __gnu_linux__	Definiert auf Linux-Derivaten. Eigentlich gehört die Linux-Familie auch zu den UNIXoiden, wird hier jedoch übersichtshalber und aufgrund großer Anzahl verschiedener Distributionen separat behandelt. Die Makros "__unix" und "__unix__" sind unter Linux ebenfalls definiert.

_WINDOWS
__i386
__i386__
i386
x86
x64
_X64
__x86_64
__sparc
__sparc__
sparc
_SPARC

Fazit:

Plattform-ID (oder einfach Plattform) = HW + OS

IN ARBEIT - Ende

Viele Plattform-Makros sind im HeaderFile gtest-port.h (aus GoogleTest) enthalten und können sehr gut als Anhaltspunkte verwendet werden.

Stand: 27.09.2019
— : Jürgen Kreick

EOF