Merge remote-tracking branch 'origin/nasm-2.12.xx'
[nasm.git] / compiler.h
blobbaa8d197e51c8a61ffbdf046cc1c2338e6652c2f
1 /* ----------------------------------------------------------------------- *
2 *
3 * Copyright 2007-2016 The NASM Authors - All Rights Reserved
4 * See the file AUTHORS included with the NASM distribution for
5 * the specific copyright holders.
7 * Redistribution and use in source and binary forms, with or without
8 * modification, are permitted provided that the following
9 * conditions are met:
11 * * Redistributions of source code must retain the above copyright
12 * notice, this list of conditions and the following disclaimer.
13 * * Redistributions in binary form must reproduce the above
14 * copyright notice, this list of conditions and the following
15 * disclaimer in the documentation and/or other materials provided
16 * with the distribution.
18 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND
19 * CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES,
20 * INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
21 * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
22 * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR
23 * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
24 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
25 * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
26 * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
27 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
28 * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
29 * OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,
30 * EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
32 * ----------------------------------------------------------------------- */
35 * compiler.h
37 * Compiler-specific macros for NASM. Feel free to add support for
38 * other compilers in here.
40 * This header file should be included before any other header.
43 #ifndef NASM_COMPILER_H
44 #define NASM_COMPILER_H 1
46 #ifdef __DJGPP__
47 /* DJGPP has header file problems if __STRICT_ANSI__ is defined */
48 # undef __STRICT_ANSI__
49 #endif
51 /* On Microsoft platforms we support multibyte character sets in filenames */
52 #define _MBCS 1
54 #ifdef HAVE_CONFIG_H
55 # include "config.h"
56 /* autoconf doesn't define these if they are redundant, but we want to
57 be able to #ifdef them... */
58 #else
59 /* Default these to unsupported unless we have config.h */
60 # ifndef inline
61 # define inline
62 # endif
63 # ifndef restrict
64 # define restrict
65 # endif
66 #endif /* HAVE_CONFIG_H */
68 /* This is required to get the standard <inttypes.h> macros when compiling
69 with a C++ compiler. This must be defined *before* <inttypes.h> is
70 included, directly or indirectly. */
71 #define __STDC_CONSTANT_MACROS 1
72 #define __STDC_LIMIT_MACROS 1
73 #define __STDC_FORMAT_MACROS 1
75 /* Some versions of MSVC have these only with underscores in front */
76 #include <stddef.h>
77 #include <stdarg.h>
78 #include <stdio.h>
80 #ifndef HAVE_SNPRINTF
81 # ifdef HAVE__SNPRINTF
82 # define snprintf _snprintf
83 # else
84 int snprintf(char *, size_t, const char *, ...);
85 # endif
86 #endif
88 #ifndef HAVE_VSNPRINTF
89 # ifdef HAVE__VSNPRINTF
90 # define vsnprintf _vsnprintf
91 # else
92 int vsnprintf(char *, size_t, const char *, va_list);
93 # endif
94 #endif
96 /* Missing fseeko/ftello */
97 #ifndef HAVE_FSEEKO
98 # undef off_t /* Just in case it is a macro */
99 # ifdef HAVE__FSEEKI64
100 # define fseeko _fseeki64
101 # define ftello _ftelli64
102 # define off_t int64_t
103 # else
104 # define fseeko fseek
105 # define ftello ftell
106 # define off_t long
107 # endif
108 #endif
110 #if !defined(HAVE_STRLCPY) || !HAVE_DECL_STRLCPY
111 size_t strlcpy(char *, const char *, size_t);
112 #endif
114 #ifndef __cplusplus /* C++ has false, true, bool as keywords */
115 # ifdef HAVE_STDBOOL_H
116 # include <stdbool.h>
117 # elif defined(HAVE__BOOL)
118 # typedef _Bool bool
119 # define false 0
120 # define true 1
121 # else
122 /* This is sort of dangerous, since casts will behave different than
123 casting to the standard boolean type. Always use !!, not (bool). */
124 typedef enum bool { false, true } bool;
125 # endif
126 #endif
128 /* Provide a substitute for offsetof() if we don't have one. This
129 variant works on most (but not *all*) systems... */
130 #ifndef offsetof
131 # define offsetof(t,m) ((size_t)&(((t *)0)->m))
132 #endif
134 /* The container_of construct: if p is a pointer to member m of
135 container class c, then return a pointer to the container of which
136 *p is a member. */
137 #ifndef container_of
138 # define container_of(p, c, m) ((c *)((char *)(p) - offsetof(c,m)))
139 #endif
141 /* Some misguided platforms hide the defs for these */
142 #if defined(HAVE_STRCASECMP) && !HAVE_DECL_STRCASECMP
143 int strcasecmp(const char *, const char *);
144 #endif
146 #if defined(HAVE_STRICMP) && !HAVE_DECL_STRICMP
147 int stricmp(const char *, const char *);
148 #endif
150 #if defined(HAVE_STRNCASECMP) && !HAVE_DECL_STRNCASECMP
151 int strncasecmp(const char *, const char *, size_t);
152 #endif
154 #if defined(HAVE_STRNICMP) && !HAVE_DECL_STRNICMP
155 int strnicmp(const char *, const char *, size_t);
156 #endif
158 #if defined(HAVE_STRSEP) && !HAVE_DECL_STRSEP
159 char *strsep(char **, const char *);
160 #endif
163 * Define this to 1 for faster performance if this is a littleendian
164 * platform which can do unaligned memory references. It is safe
165 * to leave it defined to 0 even if that is true.
167 #if defined(__386__) || defined(__i386__) || defined(__x86_64__)
168 # define X86_MEMORY 1
169 # ifndef WORDS_LITTLEENDIAN
170 # define WORDS_LITTLEENDIAN 1
171 # endif
172 #else
173 # define X86_MEMORY 0
174 #endif
177 * Hints to the compiler that a particular branch of code is more or
178 * less likely to be taken.
180 #if defined(__GNUC__) && __GNUC__ >= 3
181 # define likely(x) __builtin_expect(!!(x), 1)
182 # define unlikely(x) __builtin_expect(!!(x), 0)
183 #else
184 # define likely(x) (!!(x))
185 # define unlikely(x) (!!(x))
186 #endif
189 * How to tell the compiler that a function doesn't return
191 #ifdef __GNUC__
192 # define no_return void __attribute__((noreturn))
193 #else
194 # define no_return void
195 #endif
198 * How to tell the compiler that a function takes a printf-like string
200 #ifdef __GNUC__
201 # define printf_func(fmt, list) __attribute__((format(printf, fmt, list)))
202 #else
203 # define printf_func(fmt, list)
204 #endif
206 #endif /* NASM_COMPILER_H */