About: TeX Live provides a comprehensive TeX system including all the major TeX-related programs, macro packages, and fonts that are free software. Windows sources.
  Fossies Dox: w32tex-src.tar.xz  ("unofficial" and yet experimental doxygen-generated source code documentation)  

platform.h File Reference

Basic types for the platform. More...

#include "unicode/uconfig.h"
#include "unicode/uvernum.h"
Include dependency graph for platform.h:
This graph shows which files directly or indirectly include this file:

Go to the source code of this file.


#define U_PF_UNKNOWN   0
#define U_PF_WINDOWS   1000
#define U_PF_MINGW   1800
#define U_PF_CYGWIN   1900
#define U_PF_HPUX   2100
#define U_PF_SOLARIS   2600
#define U_PF_BSD   3000
#define U_PF_AIX   3100
#define U_PF_IRIX   3200
#define U_PF_DARWIN   3500
#define U_PF_IPHONE   3550
#define U_PF_QNX   3700
#define U_PF_LINUX   4000
#define U_PF_ANDROID   4050
#define U_PF_FUCHSIA   4100
#define U_PF_EMSCRIPTEN   5010
#define U_PF_OS390   9000
#define U_PF_OS400   9400
#define U_PLATFORM_HAS_WIN32_API   0
#define U_HAVE_STDINT_H   1
#define U_HAVE_CHAR16_T   0
#define U_GCC_MAJOR_MINOR   0
#define U_IS_BIG_ENDIAN   0
#define UPRV_HAS_ATTRIBUTE(x)   0
#define UPRV_HAS_BUILTIN(x)   0
#define UPRV_HAS_FEATURE(x)   0
#define UPRV_HAS_EXTENSION(x)   0
#define UPRV_HAS_WARNING(x)   0
#define U_ALLOC_SIZE_ATTR2(X, Y)
#define U_NOEXCEPT   noexcept
#define U_ASCII_FAMILY   0
#define U_EBCDIC_FAMILY   1
#define U_CHARSET_IS_UTF8   0
#define U_HAVE_WCHAR_H   1
#define U_SIZEOF_WCHAR_T   4
#define U_EXPORT
#define U_EXPORT2
#define U_IMPORT

Detailed Description

Basic types for the platform.

This file used to be generated by autoconf/configure. Starting with ICU 49, platform.h is a normal source file, to simplify cross-compiling and working with non-autoconf/make build systems.

When a value in this file does not work on a platform, then please try to derive it from the U_PLATFORM value (for which we might need a new value constant in rare cases) and/or from other macros that are predefined by the compiler or defined in standard (POSIX or platform or compiler) headers.

As a temporary workaround, you can add an explicit #define for some macros before it is first tested, or add an equivalent -D macro definition to the compiler's command line.

Note: Some compilers provide ways to show the predefined macros. For example, with gcc you can compile an empty .c file and have the compiler print the predefined macros with

gcc -E -dM -x c /dev/null | sort
#define c(n)
Definition: gpos-common.c:150
#define E
Definition: hpcdtoppm.c:1119
float x
Definition: cordic.py:15
static int sort(lua_State *L)
Definition: ltablib.c:411

(You can provide an actual empty .c file rather than /dev/null. -x c++ is for C++.)

Definition in file platform.h.

Macro Definition Documentation


#define U_ALLOC_SIZE_ATTR (   X)

Attribute to specify the size of the allocated buffer for malloc-like functions

Definition at line 492 of file platform.h.


#define U_ALLOC_SIZE_ATTR2 (   X,

Definition at line 493 of file platform.h.


#define U_ASCII_FAMILY   0

Character data types
U_CHARSET_FAMILY is equal to this value when the platform is an ASCII based platform. @stable ICU 2.0

Definition at line 575 of file platform.h.



Similar to U_CDECL_BEGIN/U_CDECL_END, this qualifier is necessary in callback function typedefs to make sure that the calling convention is compatible.

This is only used for non-ICU-API functions. When a function is a public ICU API, you must use the U_CAPI and U_EXPORT2 qualifiers.

Please note, you need to use U_CALLCONV after the *.

NO : "static const char U_CALLCONV *func( . . . )" YES: "static const char* U_CALLCONV func( . . . )"

@stable ICU 2.0

Definition at line 877 of file platform.h.



Similar to U_CALLCONV, but only used on function pointers.

Definition at line 888 of file platform.h.



These definitions allow to specify the encoding of text in the char data type as defined by the platform and the compiler. It is enough to determine the code point values of "invariant characters", which are the ones shared by all encodings that are in use on a given platform.

Those "invariant characters" should be all the uppercase and lowercase latin letters, the digits, the space, and "basic punctuation". Also, '\n', '\r', '\t' should be available.

The list of "invariant characters" is:

A-Z a-z 0-9 SPACE " % &amp; ' ( ) * + , - . / : ; < = > ? _
int z
Definition: dviconv.c:26
#define A
Definition: fmt.h:35
#define SPACE
Definition: general.h:107
#define a(n)
Definition: gpos-common.c:148
#define Z
Definition: ppmforge.c:75

(52 letters + 10 numbers + 20 punc/sym/space = 82 total)

This matches the IBM Syntactic Character Set (CS 640).

In other words, all the graphic characters in 7-bit ASCII should be safely accessible except the following:

'\' <backslash>
'[' <left bracket>
']' <right bracket>
'{' <left brace>
'}' <right brace>
'^' <circumflex>
'~' <tilde>
'!' <exclamation mark>
'#' <number sign>
'|' <vertical line>
'$' <dollar sign>
'@' <commercial at>
'`' <grave accent>
#define mark
Definition: aptex-macros.h:374
#define accent
Definition: aptex-macros.h:403
@ right
Definition: annotate.c:15
#define sign(x)
int tilde
Definition: bdf.c:133
char backslash[]
Definition: vlna.c:110

@stable ICU 2.0

Definition at line 632 of file platform.h.


#define U_CHARSET_IS_UTF8   0

Hardcode the default charset to UTF-8.

If this is set to 1, then

  • ICU will assume that all non-invariant char*, StringPiece, std::string etc. contain UTF-8 text, regardless of what the system API uses
  • some ICU code will use fast functions like u_strFromUTF8() rather than the more general and more heavy-weight conversion API (ucnv.h)
  • ucnv_getDefaultName() always returns "UTF-8"
  • ucnv_setDefaultName() is disabled and will not change the default charset
  • static builds of ICU are smaller
  • more functionality is available with the UCONFIG_NO_CONVERSION build-time configuration option (see unicode/uconfig.h)
  • the UCONFIG_NO_CONVERSION build option in uconfig.h is more usable

@stable ICU 4.2

See also

Definition at line 661 of file platform.h.



0 if no C++; 1, 11, 14, ... if C++. Support for specific features cannot always be determined by the C++ version alone.

Definition at line 509 of file platform.h.


#define U_EBCDIC_FAMILY   1

U_CHARSET_FAMILY is equal to this value when the platform is an EBCDIC based platform. @stable ICU 2.0

Definition at line 581 of file platform.h.


#define U_EXPORT

Symbol import-export control

Definition at line 835 of file platform.h.


#define U_EXPORT2

Definition at line 844 of file platform.h.



Annotate intentional fall-through between switch labels. http://clang.llvm.org/docs/AttributeReference.html#fallthrough-clang-fallthrough

Definition at line 562 of file platform.h.


#define U_GCC_MAJOR_MINOR   0

Compiler and environment features

Indicates whether the compiler is gcc (test for != 0), and if so, contains its major (times 100) and minor version numbers. If the compiler is not gcc, then U_GCC_MAJOR_MINOR == 0.

For example, for testing for whether we have gcc, and whether it's 4.6 or higher, use "#if U_GCC_MAJOR_MINOR >= 406".

Definition at line 374 of file platform.h.


#define U_HAVE_CHAR16_T   0

Defines whether the char16_t type is available for UTF-16 and u"abc" UTF-16 string literals are supported. This is a new standard type and standard string literal syntax in C++0x but has been available in some compilers before.

Definition at line 788 of file platform.h.



Define this to define the MFC debug version of the operator new.

@stable ICU 3.4

Definition at line 430 of file platform.h.



Defines whether inttypes.h is available. It is a C99 standard header. We include inttypes.h where it is available but stdint.h is not.

Definition at line 354 of file platform.h.



Determines whether to override placement new and delete for STL. @stable ICU 2.6

Definition at line 416 of file platform.h.


#define U_HAVE_STDINT_H   1

Defines whether stdint.h is available. It is a C99 standard header. We used to include inttypes.h which includes stdint.h but we usually do not need the additional definitions from inttypes.h.

Definition at line 328 of file platform.h.


#define U_HAVE_WCHAR_H   1

Information about wchar support

Indicates whether <wchar.h> is available (1) or not (0). Set to 1 by default.

@stable ICU 2.0

Definition at line 686 of file platform.h.



Definition at line 758 of file platform.h.


#define U_IMPORT

Definition at line 854 of file platform.h.


#define U_IS_BIG_ENDIAN   0

Determines the endianness of the platform.

Definition at line 403 of file platform.h.



Attribute to mark functions as malloc-like

Definition at line 478 of file platform.h.


#define U_NOEXCEPT   noexcept

"noexcept" if supported, otherwise empty. Some code, especially STL containers, uses move semantics of objects only if the move constructor and the move operator are declared as not throwing exceptions.

Definition at line 536 of file platform.h.


#define U_PF_AIX   3100

AIX is based on UNIX System V Releases and 4.3 BSD.

Definition at line 108 of file platform.h.


#define U_PF_ANDROID   4050

Android is based on Linux.

Definition at line 134 of file platform.h.



Native Client is pretty close to Linux. See https://developer.chrome.com/native-client and http://www.chromium.org/nativeclient

Definition at line 132 of file platform.h.


#define U_PF_BSD   3000

BSD is a UNIX operating system derivative.

Definition at line 106 of file platform.h.


#define U_PF_CYGWIN   1900

Cygwin. Windows, calls to cygwin1.dll for Posix functions, using MSVC or GNU gcc and binutils.

Definition at line 99 of file platform.h.


#define U_PF_DARWIN   3500

Darwin is a POSIX-compliant operating system, composed of code developed by Apple, as well as code derived from NeXTSTEP, BSD, and other projects, built around the Mach kernel. Darwin forms the core set of components upon which Mac OS X, Apple TV, and iOS are based. (Original description modified from WikiPedia.)

Definition at line 119 of file platform.h.


#define U_PF_EMSCRIPTEN   5010

Emscripten is a C++ transpiler for the Web that can target asm.js or WebAssembly. It provides some POSIX-compatible wrappers and stubs and some Linux-like functionality, but is not fully compatible with either.

Definition at line 145 of file platform.h.


#define U_PF_FUCHSIA   4100

Fuchsia is a POSIX-ish platform.

Definition at line 136 of file platform.h.


#define U_PF_HPUX   2100

HP-UX is based on UNIX System V.

Definition at line 102 of file platform.h.


#define U_PF_IPHONE   3550

iPhone OS (iOS) is a derivative of Mac OS X.

Definition at line 121 of file platform.h.


#define U_PF_IRIX   3200

IRIX is based on UNIX System V with BSD extensions.

Definition at line 110 of file platform.h.


#define U_PF_LINUX   4000

Linux is a Unix-like operating system.

Definition at line 125 of file platform.h.


#define U_PF_MINGW   1800

MinGW. Windows, calls to Win32 API, but using GNU gcc and binutils.

Definition at line 93 of file platform.h.

◆ U_PF_OS390

#define U_PF_OS390   9000

z/OS is the successor to OS/390 which was the successor to MVS.

Definition at line 147 of file platform.h.

◆ U_PF_OS400

#define U_PF_OS400   9400

"IBM i" is the current name of what used to be i5/OS and earlier OS/400.

Definition at line 149 of file platform.h.


#define U_PF_QNX   3700

QNX is a commercial Unix-like real-time operating system related to BSD.

Definition at line 123 of file platform.h.


#define U_PF_SOLARIS   2600

Solaris is a Unix operating system based on SVR4.

Definition at line 104 of file platform.h.


#define U_PF_UNKNOWN   0

Unknown platform.

Definition at line 89 of file platform.h.


#define U_PF_WINDOWS   1000


Definition at line 91 of file platform.h.



Define some things so that they can be documented.

The U_PLATFORM macro defines the platform we're on.

We used to define one different, value-less macro per platform. That made it hard to know the set of relevant platforms and macros, and hard to deal with variants of platforms.

Starting with ICU 49, we define platforms as numeric macros, with ranges of values for related platforms and their variants. The U_PLATFORM macro is set to one of these values.

Historical note from the Solaris Wikipedia article: AT&T and Sun collaborated on a project to merge the most popular Unix variants on the market at that time: BSD, System V, and Xenix. This became Unix System V Release 4 (SVR4).

Definition at line 206 of file platform.h.


#define U_PLATFORM_HAS_WIN32_API   0

Defines whether the Win32 API is available on the platform. Set to 1 for Windows/MSVC, MinGW and Cygwin.

Definition at line 250 of file platform.h.



Defines whether target is intended for Universal Windows Platform API Set to 1 for Windows10 Release Solution Configuration

Definition at line 262 of file platform.h.



Defines whether the platform implements (most of) the POSIX API. Set to 1 for Cygwin and most other platforms.

Definition at line 276 of file platform.h.



Defines whether the platform is Darwin or one of its derivatives.

Definition at line 302 of file platform.h.



Defines whether the platform is Linux or one of its derivatives.

Definition at line 289 of file platform.h.



Defines whether the platform uses only the Win32 API. Set to 1 for Windows/MSVC and MinGW but not Cygwin.

Definition at line 236 of file platform.h.


#define U_SIZEOF_WCHAR_T   4


@stable ICU 2.0

Definition at line 754 of file platform.h.


#define UPRV_HAS_ATTRIBUTE (   x)    0

Definition at line 437 of file platform.h.


#define UPRV_HAS_BUILTIN (   x)    0

Definition at line 452 of file platform.h.


#define UPRV_HAS_CPP_ATTRIBUTE (   x)    0

Definition at line 442 of file platform.h.



Definition at line 447 of file platform.h.


#define UPRV_HAS_EXTENSION (   x)    0

Definition at line 462 of file platform.h.


#define UPRV_HAS_FEATURE (   x)    0

Definition at line 457 of file platform.h.


#define UPRV_HAS_WARNING (   x)    0

Definition at line 467 of file platform.h.