4595be9192f2710cf1941930bd55c64842cea8bf
[xonotic/gmqcc.git] / gmqcc.h
1 /*
2  * Copyright (C) 2012, 2013
3  *     Dale Weiler
4  *     Wolfgang Bumiller
5  *
6  * Permission is hereby granted, free of charge, to any person obtaining a copy of
7  * this software and associated documentation files (the "Software"), to deal in
8  * the Software without restriction, including without limitation the rights to
9  * use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies
10  * of the Software, and to permit persons to whom the Software is furnished to do
11  * so, subject to the following conditions:
12  *
13  * The above copyright notice and this permission notice shall be included in all
14  * copies or substantial portions of the Software.
15  *
16  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
17  * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
18  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
19  * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
20  * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
21  * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
22  * SOFTWARE.
23  */
24 #ifndef GMQCC_HDR
25 #define GMQCC_HDR
26 #include <stdarg.h>
27 #include <stdio.h> /* TODO: remove this */
28
29 /*
30  * Disable some over protective warnings in visual studio because fixing them is a waste
31  * of my time.
32  */
33 #ifdef _MSC_VER
34 #   pragma warning(disable : 4244 ) /* conversion from 'int' to 'float', possible loss of data */
35 #endif /*! _MSC_VER */
36
37 #define GMQCC_VERSION_MAJOR 0
38 #define GMQCC_VERSION_MINOR 3
39 #define GMQCC_VERSION_PATCH 0
40 #define GMQCC_VERSION_BUILD(J,N,P) (((J)<<16)|((N)<<8)|(P))
41 #define GMQCC_VERSION \
42     GMQCC_VERSION_BUILD(GMQCC_VERSION_MAJOR, GMQCC_VERSION_MINOR, GMQCC_VERSION_PATCH)
43 /* Undefine the following on a release-tag: */
44 #define GMQCC_VERSION_TYPE_DEVEL
45
46 /* Full version string in case we need it */
47 #ifdef GMQCC_VERSION_TYPE_DEVEL
48 #    ifdef GMQCC_GITINFO
49 #        define GMQCC_DEV_VERSION_STRING "git build: " GMQCC_GITINFO "\n"
50 #    elif defined(GMQCC_VERSION_TYPE_DEVEL)
51 #        define GMQCC_DEV_VERSION_STRING "development build\n"
52 #    else
53 #        define GMQCC_DEV_VERSION_STRING
54 #    endif /*! GMQCC_GITINGO */
55 #else
56 #    define GMQCC_DEV_VERSION_STRING
57 #endif
58
59 #define GMQCC_STRINGIFY(x) #x
60 #define GMQCC_IND_STRING(x) GMQCC_STRINGIFY(x)
61 #define GMQCC_FULL_VERSION_STRING \
62 "GMQCC " \
63 GMQCC_IND_STRING(GMQCC_VERSION_MAJOR) "." \
64 GMQCC_IND_STRING(GMQCC_VERSION_MINOR) "." \
65 GMQCC_IND_STRING(GMQCC_VERSION_PATCH) \
66 " Built " __DATE__ " " __TIME__ \
67 "\n" GMQCC_DEV_VERSION_STRING
68
69 /*
70  * We cannot rely on C99 at all, since compilers like MSVC
71  * simply don't support it.  We define our own boolean type
72  * as a result (since we cannot include <stdbool.h>). For
73  * compilers that are in 1999 mode (C99 compliant) we can use
74  * the language keyword _Bool which can allow for better code
75  * on GCC and GCC-like compilers, opposed to `int`.
76  */
77 #ifndef __cplusplus
78 #   ifdef  false
79 #       undef  false
80 #   endif /*! false */
81 #   ifdef  true
82 #       undef true
83 #   endif /*! true  */
84 #   define false (unsigned)(0)
85 #   define true  (unsigned)(1)
86 #   ifdef __STDC_VERSION__
87 #       if __STDC_VERSION__ < 199901L && __GNUC__ < 3
88             typedef int  bool;
89 #       else
90             typedef _Bool bool;
91 #       endif /*! __STDC_VERSION__ < 199901L && __GNUC__ < 3 */
92 #   else
93         typedef int bool;
94 #   endif /*! __STDC_VERSION__ */
95 #endif /*! __cplusplus      */
96
97 /*
98  * Of some functions which are generated we want to make sure
99  * that the result isn't ignored. To find such function calls,
100  * we use this macro.
101  */
102 #if defined(__GNUC__) || defined(__CLANG__)
103 #   define GMQCC_WARN __attribute__((warn_unused_result))
104 #   define GMQCC_USED __attribute__((used))
105 #else
106 #   define GMQCC_WARN
107 #   define GMQCC_USED
108 #endif /*! defined(__GNUC__) || defined (__CLANG__) */
109
110 /*
111  * Inline is not supported in < C90, however some compilers
112  * like gcc and clang might have an inline attribute we can
113  * use if present.
114  */
115 #ifdef __STDC_VERSION__
116 #    if __STDC_VERSION__ < 199901L
117 #       if defined(__GNUC__) || defined (__CLANG__)
118 #           if __GNUC__ < 2
119 #               define GMQCC_INLINE
120 #           else
121 #               define GMQCC_INLINE __attribute__ ((always_inline))
122 #           endif /*! __GNUC__ < 2 */
123 #       else
124 #           define GMQCC_INLINE
125 #       endif /*! defined(__GNUC__) || defined (__CLANG__) */
126 #    else
127 #       define GMQCC_INLINE inline
128 #    endif /*! __STDC_VERSION < 199901L */
129 /*
130  * Visual studio has __forcinline we can use.  So lets use that
131  * I suspect it also has just __inline of some sort, but our use
132  * of inline is correct (not guessed), WE WANT IT TO BE INLINE
133  */
134 #elif defined(_MSC_VER)
135 #    define GMQCC_INLINE __forceinline
136 #else
137 #    define GMQCC_INLINE
138 #endif /*! __STDC_VERSION__ */
139
140 /*
141  * noreturn is present in GCC and clang
142  * it's required for _ast_node_destory otherwise -Wmissing-noreturn
143  * in clang complains about there being no return since abort() is
144  * called.
145  */
146 #if (defined(__GNUC__) && __GNUC__ >= 2) || defined(__CLANG__)
147 #    define GMQCC_NORETURN __attribute__ ((noreturn))
148 #else
149 #    define GMQCC_NORETURN
150 #endif /*! (defined(__GNUC__) && __GNUC__ >= 2) || defined (__CLANG__) */
151
152 #ifndef _MSC_VER
153 #   include <stdint.h>
154 #else
155     typedef unsigned __int8  uint8_t;
156     typedef unsigned __int16 uint16_t;
157     typedef unsigned __int32 uint32_t;
158     typedef unsigned __int64 uint64_t;
159
160     typedef __int16          int16_t;
161     typedef __int32          int32_t;
162     typedef __int64          int64_t;
163 #endif /*! _MSC_VER */
164
165 /*
166  * Very roboust way at determining endianess at compile time: this handles
167  * almost every possible situation.  Otherwise a runtime check has to be
168  * performed.
169  */
170 #define GMQCC_BYTE_ORDER_LITTLE 1234
171 #define GMQCC_BYTE_ORDER_BIG    4321
172
173 #if defined (__GNUC__) || defined (__GNU_LIBRARY__)
174 #   if defined (__FreeBSD__) || defined (__OpenBSD__)
175 #       include <sys/endian.h>
176 #   elif defined (BSD) && (BSD >= 199103) || defined (__DJGPP__) || defined (__CYGWIN32__)
177 #       include <machine/endian.h>
178 #   elif defined (__APPLE__)
179 #       if defined (__BIG_ENDIAN__) && !defined(BIG_ENDIAN)
180 #           define BIG_ENDIAN
181 #       elif defined (__LITTLE_ENDIAN__) && !defined (LITTLE_ENDIAN)
182 #           define LITTLE_ENDIAN
183 #       endif /*! defined (__BIG_ENDIAN__) && !defined(BIG_ENDIAN) */
184 #   elif !defined (__MINGW32__)
185 #       include <endian.h>
186 #       if !defined (__BEOS__)
187 #           include <byteswap.h>
188 #       endif /*! !definde (__BEOS__) */
189 #   endif /*! defined (__FreeBSD__) || defined (__OpenBSD__) */
190 #endif /*! defined (__GNUC__) || defined (__GNU_LIBRARY__) */
191 #if !defined(PLATFORM_BYTE_ORDER)
192 #   if defined (LITTLE_ENDIAN) || defined (BIG_ENDIAN)
193 #       if defined (LITTLE_ENDIAN) && !defined(BIG_ENDIAN)
194 #           define PLATFORM_BYTE_ORDER GMQCC_BYTE_ORDER_LITTLE
195 #       elif !defined (LITTLE_ENDIAN) && defined (BIG_ENDIAN)
196 #           define PLATFORM_BYTE_ORDER GMQCC_BYTE_ORDER_BIG
197 #       elif defined (BYTE_ORDER) && (BYTE_ORDER == LITTLE_ENDIAN)
198 #           define PLATFORM_BYTE_ORDER GMQCC_BYTE_ORDER_LITTLE
199 #       elif defined (BYTE_ORDER) && (BYTE_ORDER == BIG_ENDIAN)
200 #           define PLATFORM_BYTE_ORDER GMQCC_BYTE_ORDER_BIG
201 #       endif /*! defined (LITTLE_ENDIAN) && !defined(BIG_ENDIAN) */
202 #   elif defined (_LITTLE_ENDIAN) || defined (_BIG_ENDIAN)
203 #       if defined (_LITTLE_ENDIAN) && !defined(_BIG_ENDIAN)
204 #           define PLATFORM_BYTE_ORDER GMQCC_BYTE_ORDER_LITTLE
205 #       elif !defined (_LITTLE_ENDIAN) && defined (_BIG_ENDIAN)
206 #           define PLATFORM_BYTE_ORDER GMQCC_BYTE_ORDER_BIG
207 #       elif defined (_BYTE_ORDER) && (_BYTE_ORDER == _LITTLE_ENDIAN)
208 #           define PLATFORM_BYTE_ORDER GMQCC_BYTE_ORDER_LITTLE
209 #       elif defined (_BYTE_ORDER) && (_BYTE_ORDER == _BIG_ENDIAN)
210 #           define PLATFORM_BYTE_ORDER GMQCC_BYTE_ORDER_BIG
211 #       endif /*! defined (_LITTLE_ENDIAN) && !defined(_BIG_ENDIAN) */
212 #   elif defined (__LITTLE_ENDIAN__) || defined (__BIG_ENDIAN__)
213 #       if defined (__LITTLE_ENDIAN__) && !defined (__BIG_ENDIAN__)
214 #           define PLATFORM_BYTE_ORDER GMQCC_BYTE_ORDER_LITTLE
215 #       elif !defined (__LITTLE_ENDIAN__) && defined (__BIG_ENDIAN__)
216 #           define PLATFORM_BYTE_ORDER GMQCC_BYTE_ORDER_BIG
217 #       elif defined (__BYTE_ORDER__) && (__BYTE_ORDER__ == __LITTLE_ENDIAN__)
218 #           define PLATFORM_BYTE_ORDER GMQCC_BYTE_ORDER_LITTLE
219 #       elif defined (__BYTE_ORDER__) && (__BYTE_ORDER__ == __BIG_ENDIAN__)
220 #           define PLATFORM_BYTE_ORDER GMQCC_BYTE_ORDER_BIG
221 #       endif /*! defined (__LITTLE_ENDIAN__) && !defined (__BIG_ENDIAN__) */
222 #   endif /*! defined(LITTLE_ENDIAN) || defined (BIG_ENDIAN) */
223 #endif /*! !defined(PLATFORM_BYTE_ORDER) */
224 #if !defined (PLATFORM_BYTE_ORDER)
225 #   if   defined (__alpha__) || defined (__alpha)    || defined (i386)       || \
226          defined (__i386__)  || defined (_M_I86)     || defined (_M_IX86)    || \
227          defined (__OS2__)   || defined (sun386)     || defined (__TURBOC__) || \
228          defined (vax)       || defined (vms)        || defined (VMS)        || \
229          defined (__VMS)     || defined (__x86_64__) || defined (_M_IA64)    || \
230          defined (_M_X64)    || defined (__i386)     || defined (__x86_64)
231 #       define PLATFORM_BYTE_ORDER GMQCC_BYTE_ORDER_LITTLE
232 #   elif defined (AMIGA)     || defined (applec)     || defined (__AS400__)  || \
233          defined (_CRAY)     || defined (__hppa)     || defined (__hp9000)   || \
234          defined (ibm370)    || defined (mc68000)    || defined (m68k)       || \
235          defined (__MRC__)   || defined (__MVS__)    || defined (__MWERKS__) || \
236          defined (sparc)     || defined (__sparc)    || defined (SYMANTEC_C) || \
237          defined (__TANDEM)  || defined (THINK_C)    || defined (__VMCMS__)  || \
238          defined (__PPC__)   || defined (__PPC)      || defined (PPC)
239 #       define PLATFORM_BYTE_ORDER GMQCC_BYTE_ORDER_BIG
240 #   else
241 #       define PLATFORM_BYTE_ORDER -1
242 #   endif
243 #endif /*! !defined (PLATFORM_BYTE_ORDER) */
244
245 /*
246  * On windows systems where we're not compiling with MING32 we need a
247  * little extra help on dependinces for implementing our own dirent.h
248  * in fs.c.
249  */
250 #if defined(_WIN32) && !defined(__MINGW32__)
251 #   define _WIN32_LEAN_AND_MEAN
252 #   include <windows.h>
253 #   include <io.h>
254 #   include <fcntl.h>
255
256     struct dirent {
257         long               d_ino;
258         unsigned short     d_reclen;
259         unsigned short     d_namlen;
260         char               d_name[FILENAME_MAX];
261     };
262
263     typedef struct {
264         struct _finddata_t dd_dta;
265         struct dirent      dd_dir;
266         long               dd_handle;
267         int                dd_stat;
268         char               dd_name[1];
269     } DIR;
270     /*
271      * Visual studio also lacks S_ISDIR for sys/stat.h, so we emulate this as well
272      * which is not hard at all.
273      */
274 #    ifdef S_ISDIR
275 #        undef  S_ISDIR
276 #    endif /*! S_ISDIR */
277 #   define S_ISDIR(X) ((X)&_S_IFDIR)
278 #else
279 #   include <dirent.h>
280 #endif /*! _WIN32 && !defined(__MINGW32__) */
281
282 /*===================================================================*/
283 /*=========================== stat.c ================================*/
284 /*===================================================================*/
285 void  stat_info          (void);
286 char *stat_mem_strdup    (const char *, size_t,         const char *, bool);
287 void *stat_mem_reallocate(void *,       size_t, size_t, const char *);
288 void  stat_mem_deallocate(void *);
289 void *stat_mem_allocate  (size_t, size_t, const char *);
290
291 #define mem_a(SIZE)              stat_mem_allocate  ((SIZE), __LINE__, __FILE__)
292 #define mem_d(PTRN)              stat_mem_deallocate((void*)(PTRN))
293 #define mem_r(PTRN, SIZE)        stat_mem_reallocate((void*)(PTRN), (SIZE), __LINE__, __FILE__)
294 #define mem_af(SIZE, FILE, LINE) stat_mem_allocate  ((SIZE), (LINE), (FILE))
295
296 /* TODO: rename to mem variations */
297 #define util_strdup(SRC)         stat_mem_strdup((char*)(SRC), __LINE__, __FILE__, false)
298 #define util_strdupe(SRC)        stat_mem_strdup((char*)(SRC), __LINE__, __FILE__, true)
299
300 /*===================================================================*/
301 /*=========================== util.c ================================*/
302 /*===================================================================*/
303
304 /*
305  * Microsoft implements against the spec versions of ctype.h. Which
306  * means what ever the current set locale is will render the actual
307  * results of say isalpha('A') wrong for what ever retarded locale
308  * is used. Simalerly these are also implemented inefficently on
309  * some toolchains and end up becoming actual library calls. Perhaps
310  * this is why tools like yacc provide their own? Regardless implementing
311  * these as functions is equally as silly, the call overhead is not
312  * justified when this could happen on every character from an input
313  * stream. We provide our own as macros for absolute inlinability.
314  */
315 #define util_isalpha(a) ((((unsigned)(a)|32)-'a') < 26)
316 #define util_isdigit(a) (((unsigned)(a)-'0') < 10)
317 #define util_islower(a) (((unsigned)(a)-'a') < 26)
318 #define util_isupper(a) (((unsigned)(a)-'A') < 26)
319 #define util_isprint(a) (((unsigned)(a)-0x20) < 0x5F)
320 #define util_isspace(a) (((a) >= 9 && (a) <= 13) || (a) == ' ')
321
322 bool  util_filexists     (const char *);
323 bool  util_strupper      (const char *);
324 bool  util_strdigit      (const char *);
325 void  util_debug         (const char *, const char *, ...);
326 void  util_endianswap    (void *,  size_t, unsigned int);
327
328 size_t util_strtocmd    (const char *, char *, size_t);
329 size_t util_strtononcmd (const char *, char *, size_t);
330
331 uint16_t util_crc16(uint16_t crc, const char *data, size_t len);
332
333 void     util_seed(uint32_t);
334 uint32_t util_rand(void);
335
336 /*
337  * String functions (formatting, copying, concatenating, errors). These are wrapped
338  * to use the MSVC _safe_ versions when using MSVC, plus some implementations of
339  * these are non-conformant or don't exist such as asprintf and snprintf, which are
340  * not supported in C90, but do exist in C99.
341  */
342 int         util_vasprintf(char **ret, const char *fmt, va_list);
343 int         util_asprintf (char **ret, const char *fmt, ...);
344 int         util_snprintf (char *src,  size_t bytes, const char *format, ...);
345 char       *util_strcat   (char *dest, const char *src);
346 char       *util_strncpy  (char *dest, const char *src, size_t num);
347 const char *util_strerror (int num);
348
349 /*
350  * A flexible vector implementation: all vector pointers contain some
351  * data about themselfs exactly - sizeof(vector_t) behind the pointer
352  * this data is represented in the structure below.  Doing this allows
353  * us to use the array [] to access individual elements from the vector
354  * opposed to using set/get methods.
355  */
356 typedef struct {
357     size_t  allocated;
358     size_t  used;
359
360     /* can be extended now! whoot */
361 } vector_t;
362
363 /* hidden interface */
364 void _util_vec_grow(void **a, size_t i, size_t s);
365 #define GMQCC_VEC_WILLGROW(X,Y) ( \
366     ((!(X) || vec_meta(X)->used + Y >= vec_meta(X)->allocated)) ? \
367         (void)_util_vec_grow(((void**)&(X)), (Y), sizeof(*(X))) : \
368         (void)0                                                   \
369 )
370
371 /* exposed interface */
372 #define vec_meta(A)       (((vector_t*)((void*)A)) - 1)
373 #define vec_free(A)       ((void)((A) ? (mem_d((void*)vec_meta(A)), (A) = NULL) : 0))
374 #define vec_push(A,V)     (GMQCC_VEC_WILLGROW((A),1), (A)[vec_meta(A)->used++] = (V))
375 #define vec_size(A)       ((A) ? vec_meta(A)->used : 0)
376 #define vec_add(A,N)      (GMQCC_VEC_WILLGROW((A),(N)), vec_meta(A)->used += (N), &(A)[vec_meta(A)->used-(N)])
377 #define vec_last(A)       ((A)[vec_meta(A)->used - 1])
378 #define vec_pop(A)        ((void)(vec_meta(A)->used -= 1))
379 #define vec_shrinkto(A,N) ((void)(vec_meta(A)->used  = (N)))
380 #define vec_shrinkby(A,N) ((void)(vec_meta(A)->used -= (N)))
381 #define vec_append(A,N,S) ((void)(memcpy(vec_add((A), (N)), (S), (N) * sizeof(*(S)))))
382 #define vec_upload(X,Y,S) ((void)(memcpy(vec_add((X), (S) * sizeof(*(Y))), (Y), (S) * sizeof(*(Y)))))
383 #define vec_remove(A,I,N) ((void)(memmove((A)+(I),(A)+((I)+(N)),sizeof(*(A))*(vec_meta(A)->used-(I)-(N))),vec_meta(A)->used-=(N)))
384
385 typedef struct trie_s {
386     void          *value;
387     struct trie_s *entries;
388 } correct_trie_t;
389
390 correct_trie_t* correct_trie_new(void);
391
392 typedef struct hash_table_t {
393     size_t                size;
394     struct hash_node_t **table;
395 } hash_table_t, *ht;
396
397 /*
398  * hashtable implementation:
399  *
400  * Note:
401  *      This was designed for pointers:  you manage the life of the object yourself
402  *      if you do use this for non-pointers please be warned that the object may not
403  *      be valid if the duration of it exceeds (i.e on stack).  So you need to allocate
404  *      yourself, or put those in global scope to ensure duration is for the whole
405  *      runtime.
406  *
407  * util_htnew(size)                             -- to make a new hashtable
408  * util_htset(table, key, value, sizeof(value)) -- to set something in the table
409  * util_htget(table, key)                       -- to get something from the table
410  * util_htdel(table)                            -- to delete the table
411  *
412  * example of use:
413  *
414  * ht    foo  = util_htnew(1024);
415  * int   data = 100;
416  * char *test = "hello world\n";
417  * util_htset(foo, "foo", (void*)&data);
418  * util_gtset(foo, "bar", (void*)test);
419  *
420  * printf("foo: %d, bar %s",
421  *     *((int *)util_htget(foo, "foo")),
422  *      ((char*)util_htget(foo, "bar"))
423  * );
424  *
425  * util_htdel(foo);
426  */
427 hash_table_t *util_htnew (size_t size);
428 void          util_htrem (hash_table_t *ht, void (*callback)(void *data));
429 void          util_htset (hash_table_t *ht, const char *key, void *value);
430 void          util_htdel (hash_table_t *ht);
431 size_t        util_hthash(hash_table_t *ht, const char *key);
432 void          util_htseth(hash_table_t *ht, const char *key, size_t hash, void *value);
433 void          util_htrmh (hash_table_t *ht, const char *key, size_t bin, void (*cb)(void*));
434 void          util_htrm  (hash_table_t *ht, const char *key, void (*cb)(void*));
435
436 void         *util_htget (hash_table_t *ht, const char *key);
437 void         *util_htgeth(hash_table_t *ht, const char *key, size_t hash);
438
439 /*===================================================================*/
440 /*============================ file.c ===============================*/
441 /*===================================================================*/
442 /* file handling */
443 void           fs_file_close  (FILE *);
444 int            fs_file_error  (FILE *);
445 int            fs_file_getc   (FILE *);
446 int            fs_file_printf (FILE *, const char *, ...);
447 int            fs_file_puts   (FILE *, const char *);
448 int            fs_file_seek   (FILE *, long int, int);
449 long int       fs_file_tell   (FILE *);
450
451 size_t         fs_file_read   (void *,        size_t, size_t, FILE *);
452 size_t         fs_file_write  (const void *,  size_t, size_t, FILE *);
453
454 FILE          *fs_file_open   (const char *, const char *);
455 int            fs_file_getline(char  **, size_t *, FILE *);
456
457 /* directory handling */
458 int            fs_dir_make    (const char *);
459 DIR           *fs_dir_open    (const char *);
460 int            fs_dir_close   (DIR *);
461 struct dirent *fs_dir_read    (DIR *);
462
463
464 /*===================================================================*/
465 /*=========================== correct.c =============================*/
466 /*===================================================================*/
467 typedef struct {
468     char   ***edits;
469     size_t  **lens;
470 } correction_t;
471
472 void  correct_del (correct_trie_t*, size_t **);
473 void  correct_add (correct_trie_t*, size_t ***, const char *);
474 char *correct_str (correction_t *, correct_trie_t*, const char *);
475 void  correct_init(correction_t *);
476 void  correct_free(correction_t *);
477
478 /*===================================================================*/
479 /*=========================== code.c ================================*/
480 /*===================================================================*/
481
482 /* Note: if you change the order, fix type_sizeof in ir.c */
483 enum {
484     TYPE_VOID     ,
485     TYPE_STRING   ,
486     TYPE_FLOAT    ,
487     TYPE_VECTOR   ,
488     TYPE_ENTITY   ,
489     TYPE_FIELD    ,
490     TYPE_FUNCTION ,
491     TYPE_POINTER  ,
492     TYPE_INTEGER  ,
493     TYPE_VARIANT  ,
494     TYPE_STRUCT   ,
495     TYPE_UNION    ,
496     TYPE_ARRAY    ,
497
498     TYPE_NIL      , /* it's its own type / untyped */
499     TYPE_NOEXPR   , /* simply invalid in expressions */
500
501     TYPE_COUNT
502 };
503
504 /* const/var qualifiers */
505 #define CV_NONE   0
506 #define CV_CONST  1
507 #define CV_VAR   -1
508 #define CV_WRONG  0x8000 /* magic number to help parsing */
509
510 extern const char    *type_name        [TYPE_COUNT];
511 extern const uint16_t type_store_instr [TYPE_COUNT];
512 extern const uint16_t field_store_instr[TYPE_COUNT];
513
514 /*
515  * could use type_store_instr + INSTR_STOREP_F - INSTR_STORE_F
516  * but this breaks when TYPE_INTEGER is added, since with the enhanced
517  * instruction set, the old ones are left untouched, thus the _I instructions
518  * are at a seperate place.
519  */
520 extern const uint16_t type_storep_instr[TYPE_COUNT];
521 extern const uint16_t type_eq_instr    [TYPE_COUNT];
522 extern const uint16_t type_ne_instr    [TYPE_COUNT];
523 extern const uint16_t type_not_instr   [TYPE_COUNT];
524
525 typedef struct {
526     uint32_t offset;      /* Offset in file of where data begins  */
527     uint32_t length;      /* Length of section (how many of)      */
528 } prog_section;
529
530 typedef struct {
531     uint32_t     version;      /* Program version (6)     */
532     uint16_t     crc16;
533     uint16_t     skip;
534
535     prog_section statements;   /* prog_section_statement  */
536     prog_section defs;         /* prog_section_def        */
537     prog_section fields;       /* prog_section_field      */
538     prog_section functions;    /* prog_section_function   */
539     prog_section strings;
540     prog_section globals;
541     uint32_t     entfield;     /* Number of entity fields */
542 } prog_header;
543
544 /*
545  * Each paramater incerements by 3 since vector types hold
546  * 3 components (x,y,z).
547  */
548 #define OFS_NULL      0
549 #define OFS_RETURN    1
550 #define OFS_PARM0     (OFS_RETURN+3)
551 #define OFS_PARM1     (OFS_PARM0 +3)
552 #define OFS_PARM2     (OFS_PARM1 +3)
553 #define OFS_PARM3     (OFS_PARM2 +3)
554 #define OFS_PARM4     (OFS_PARM3 +3)
555 #define OFS_PARM5     (OFS_PARM4 +3)
556 #define OFS_PARM6     (OFS_PARM5 +3)
557 #define OFS_PARM7     (OFS_PARM6 +3)
558
559 typedef struct {
560     uint16_t opcode;
561
562     /* operand 1 */
563     union {
564         int16_t  s1; /* signed   */
565         uint16_t u1; /* unsigned */
566     } o1;
567     /* operand 2 */
568     union {
569         int16_t  s1; /* signed   */
570         uint16_t u1; /* unsigned */
571     } o2;
572     /* operand 3 */
573     union {
574         int16_t  s1; /* signed   */
575         uint16_t u1; /* unsigned */
576     } o3;
577
578     /*
579      * This is the same as the structure in darkplaces
580      * {
581      *     unsigned short op;
582      *     short          a,b,c;
583      * }
584      * But this one is more sane to work with, and the
585      * type sizes are guranteed.
586      */
587 } prog_section_statement;
588
589 typedef struct {
590     /*
591      * The types:
592      * 0 = ev_void
593      * 1 = ev_string
594      * 2 = ev_float
595      * 3 = ev_vector
596      * 4 = ev_entity
597      * 5 = ev_field
598      * 6 = ev_function
599      * 7 = ev_pointer -- engine only
600      * 8 = ev_bad     -- engine only
601      */
602     uint16_t type;
603     uint16_t offset;
604     uint32_t name;
605 } prog_section_both;
606
607 typedef prog_section_both prog_section_def;
608 typedef prog_section_both prog_section_field;
609
610 /* this is ORed to the type */
611 #define DEF_SAVEGLOBAL (1<<15)
612 #define DEF_TYPEMASK   ((1<<15)-1)
613
614 typedef struct {
615     int32_t   entry;      /* in statement table for instructions  */
616     uint32_t  firstlocal; /* First local in local table           */
617     uint32_t  locals;     /* Total ints of params + locals        */
618     uint32_t  profile;    /* Always zero (engine uses this)       */
619     uint32_t  name;       /* name of function in string table     */
620     uint32_t  file;       /* file of the source file              */
621     int32_t   nargs;      /* number of arguments                  */
622     uint8_t   argsize[8]; /* size of arguments (keep 8 always?)   */
623 } prog_section_function;
624
625 /*
626  * Instructions
627  * These are the external instructions supported by the interperter
628  * this is what things compile to (from the C code).
629  */
630 enum {
631     INSTR_DONE,
632     INSTR_MUL_F,
633     INSTR_MUL_V,
634     INSTR_MUL_FV, /* NOTE: the float operands must NOT be at the same locations: A != C */
635     INSTR_MUL_VF, /* and here: B != C */
636     INSTR_DIV_F,
637     INSTR_ADD_F,
638     INSTR_ADD_V,
639     INSTR_SUB_F,
640     INSTR_SUB_V,
641     INSTR_EQ_F,
642     INSTR_EQ_V,
643     INSTR_EQ_S,
644     INSTR_EQ_E,
645     INSTR_EQ_FNC,
646     INSTR_NE_F,
647     INSTR_NE_V,
648     INSTR_NE_S,
649     INSTR_NE_E,
650     INSTR_NE_FNC,
651     INSTR_LE,
652     INSTR_GE,
653     INSTR_LT,
654     INSTR_GT,
655     INSTR_LOAD_F,
656     INSTR_LOAD_V,
657     INSTR_LOAD_S,
658     INSTR_LOAD_ENT,
659     INSTR_LOAD_FLD,
660     INSTR_LOAD_FNC,
661     INSTR_ADDRESS,
662     INSTR_STORE_F,
663     INSTR_STORE_V,
664     INSTR_STORE_S,
665     INSTR_STORE_ENT,
666     INSTR_STORE_FLD,
667     INSTR_STORE_FNC,
668     INSTR_STOREP_F,
669     INSTR_STOREP_V,
670     INSTR_STOREP_S,
671     INSTR_STOREP_ENT,
672     INSTR_STOREP_FLD,
673     INSTR_STOREP_FNC,
674     INSTR_RETURN,
675     INSTR_NOT_F,
676     INSTR_NOT_V,
677     INSTR_NOT_S,
678     INSTR_NOT_ENT,
679     INSTR_NOT_FNC,
680     INSTR_IF,
681     INSTR_IFNOT,
682     INSTR_CALL0,
683     INSTR_CALL1,
684     INSTR_CALL2,
685     INSTR_CALL3,
686     INSTR_CALL4,
687     INSTR_CALL5,
688     INSTR_CALL6,
689     INSTR_CALL7,
690     INSTR_CALL8,
691     INSTR_STATE,
692     INSTR_GOTO,
693     INSTR_AND,
694     INSTR_OR,
695     INSTR_BITAND,
696     INSTR_BITOR,
697
698     /*
699      * Virtual instructions used by the IR
700      * Keep at the end!
701      */
702     VINSTR_END,
703     VINSTR_PHI,
704     VINSTR_JUMP,
705     VINSTR_COND,
706     /* A never returning CALL.
707      * Creating this causes IR blocks to be marked as 'final'.
708      * No-Return-Call
709      */
710     VINSTR_NRCALL
711 };
712
713 /* TODO: elide */
714 extern const char *util_instr_str[VINSTR_END];
715
716 /* uhh? */
717 typedef float   qcfloat;
718 typedef int32_t qcint;
719
720 typedef struct {
721     prog_section_statement *statements;
722     int                    *linenums;
723     prog_section_def       *defs;
724     prog_section_field     *fields;
725     prog_section_function  *functions;
726     int                    *globals;
727     char                   *chars;
728     uint16_t                crc;
729     uint32_t                entfields;
730     ht                      string_cache;
731     qcint                   string_cached_empty;
732 } code_t;
733
734 /*
735  * code_write          -- writes out the compiled file
736  * code_init           -- prepares the code file
737  * code_genstrin       -- generates string for code
738  * code_alloc_field    -- allocated a field
739  * code_push_statement -- keeps statements and linenumbers together
740  * code_pop_statement  -- keeps statements and linenumbers together
741  */
742 bool      code_write         (code_t *, const char *filename, const char *lno);
743 GMQCC_WARN
744 code_t   *code_init          (void);
745 void      code_cleanup       (code_t *);
746 uint32_t  code_genstring     (code_t *, const char *string);
747 qcint     code_alloc_field   (code_t *, size_t qcsize);
748 void      code_push_statement(code_t *, prog_section_statement *stmt, int linenum);
749 void      code_pop_statement (code_t *);
750
751 /*
752  * A shallow copy of a lex_file to remember where which ast node
753  * came from.
754  */
755 typedef struct {
756     const char *file;
757     size_t      line;
758     size_t      column;
759 } lex_ctx;
760
761 /*===================================================================*/
762 /*============================ con.c ================================*/
763 /*===================================================================*/
764 enum {
765     CON_BLACK   = 30,
766     CON_RED,
767     CON_GREEN,
768     CON_BROWN,
769     CON_BLUE,
770     CON_MAGENTA,
771     CON_CYAN ,
772     CON_WHITE
773 };
774
775 /* message level */
776 enum {
777     LVL_MSG,
778     LVL_WARNING,
779     LVL_ERROR
780 };
781
782 FILE *con_default_out(void);
783 FILE *con_default_err(void);
784
785 void con_vprintmsg (int level, const char *name, size_t line, size_t column, const char *msgtype, const char *msg, va_list ap);
786 void con_printmsg  (int level, const char *name, size_t line, size_t column, const char *msgtype, const char *msg, ...);
787 void con_cvprintmsg(void *ctx, int lvl, const char *msgtype, const char *msg, va_list ap);
788 void con_cprintmsg (void *ctx, int lvl, const char *msgtype, const char *msg, ...);
789
790 void con_close (void);
791 void con_init  (void);
792 void con_reset (void);
793 void con_color (int);
794 int  con_change(const char *, const char *);
795 int  con_verr  (const char *, va_list);
796 int  con_vout  (const char *, va_list);
797 int  con_err   (const char *, ...);
798 int  con_out   (const char *, ...);
799
800 /* error/warning interface */
801 extern size_t compile_errors;
802 extern size_t compile_Werrors;
803 extern size_t compile_warnings;
804
805 void /********/ compile_error   (lex_ctx ctx, /*LVL_ERROR*/ const char *msg, ...);
806 void /********/ vcompile_error  (lex_ctx ctx, /*LVL_ERROR*/ const char *msg, va_list ap);
807 bool GMQCC_WARN compile_warning (lex_ctx ctx, int warntype, const char *fmt, ...);
808 bool GMQCC_WARN vcompile_warning(lex_ctx ctx, int warntype, const char *fmt, va_list ap);
809 void            compile_show_werrors(void);
810
811 /*===================================================================*/
812 /*============================= ir.c ================================*/
813 /*===================================================================*/
814
815 enum store_types {
816     store_global,
817     store_local,  /* local, assignable for now, should get promoted later */
818     store_param,  /* parameters, they are locals with a fixed position */
819     store_value,  /* unassignable */
820     store_return  /* unassignable, at OFS_RETURN */
821 };
822
823 typedef struct {
824     qcfloat x, y, z;
825 } vector;
826
827 vector  vec3_add  (vector, vector);
828 vector  vec3_sub  (vector, vector);
829 qcfloat vec3_mulvv(vector, vector);
830 vector  vec3_mulvf(vector, float);
831
832 /*===================================================================*/
833 /*============================= exec.c ==============================*/
834 /*===================================================================*/
835
836 /* TODO: cleanup */
837 /*
838  * Darkplaces has (or will have) a 64 bit prog loader
839  * where the 32 bit qc program is autoconverted on load.
840  * Since we may want to support that as well, let's redefine
841  * float and int here.
842  */
843 typedef union {
844     qcint   _int;
845     qcint    string;
846     qcint    function;
847     qcint    edict;
848     qcfloat _float;
849     qcfloat vector[3];
850     qcint   ivector[3];
851 } qcany;
852
853 typedef char qcfloat_size_is_correct [sizeof(qcfloat) == 4 ?1:-1];
854 typedef char qcint_size_is_correct   [sizeof(qcint)   == 4 ?1:-1];
855
856 enum {
857     VMERR_OK,
858     VMERR_TEMPSTRING_ALLOC,
859
860     VMERR_END
861 };
862
863 #define VM_JUMPS_DEFAULT 1000000
864
865 /* execute-flags */
866 #define VMXF_DEFAULT 0x0000     /* default flags - nothing */
867 #define VMXF_TRACE   0x0001     /* trace: print statements before executing */
868 #define VMXF_PROFILE 0x0002     /* profile: increment the profile counters */
869
870 struct qc_program_s;
871
872 typedef int (*prog_builtin)(struct qc_program_s *prog);
873
874 typedef struct {
875     qcint                  stmt;
876     size_t                 localsp;
877     prog_section_function *function;
878 } qc_exec_stack;
879
880 typedef struct qc_program_s {
881     char           *filename;
882
883     prog_section_statement *code;
884     prog_section_def       *defs;
885     prog_section_def       *fields;
886     prog_section_function  *functions;
887     char                   *strings;
888     qcint                  *globals;
889     qcint                  *entitydata;
890     bool                   *entitypool;
891
892     const char*            *function_stack;
893
894     uint16_t crc16;
895
896     size_t tempstring_start;
897     size_t tempstring_at;
898
899     qcint  vmerror;
900
901     size_t *profile;
902
903     prog_builtin *builtins;
904     size_t        builtins_count;
905
906     /* size_t ip; */
907     qcint  entities;
908     size_t entityfields;
909     bool   allowworldwrites;
910
911     qcint         *localstack;
912     qc_exec_stack *stack;
913     size_t statement;
914
915     size_t xflags;
916
917     int    argc; /* current arg count for debugging */
918 } qc_program;
919
920 qc_program* prog_load(const char *filename, bool ignoreversion);
921 void        prog_delete(qc_program *prog);
922
923 bool prog_exec(qc_program *prog, prog_section_function *func, size_t flags, long maxjumps);
924
925 const char*       prog_getstring (qc_program *prog, qcint str);
926 prog_section_def* prog_entfield  (qc_program *prog, qcint off);
927 prog_section_def* prog_getdef    (qc_program *prog, qcint off);
928 qcany*            prog_getedict  (qc_program *prog, qcint e);
929 qcint             prog_tempstring(qc_program *prog, const char *_str);
930
931
932 /*===================================================================*/
933 /*===================== parser.c commandline ========================*/
934 /*===================================================================*/
935 struct parser_s;
936 struct parser_s *parser_create        (void);
937 bool             parser_compile_file  (struct parser_s *parser, const char *);
938 bool             parser_compile_string(struct parser_s *parser, const char *, const char *, size_t);
939 bool             parser_finish        (struct parser_s *parser, const char *);
940 void             parser_cleanup       (struct parser_s *parser);
941
942 /*===================================================================*/
943 /*====================== ftepp.c commandline ========================*/
944 /*===================================================================*/
945 struct ftepp_s;
946 struct ftepp_s *ftepp_create           (void);
947 bool            ftepp_preprocess_file  (struct ftepp_s *ftepp, const char *filename);
948 bool            ftepp_preprocess_string(struct ftepp_s *ftepp, const char *name, const char *str);
949 void            ftepp_finish           (struct ftepp_s *ftepp);
950 const char     *ftepp_get              (struct ftepp_s *ftepp);
951 void            ftepp_flush            (struct ftepp_s *ftepp);
952 void            ftepp_add_define       (struct ftepp_s *ftepp, const char *source, const char *name);
953 void            ftepp_add_macro        (struct ftepp_s *ftepp, const char *name,   const char *value);
954
955 /*===================================================================*/
956 /*======================= main.c commandline ========================*/
957 /*===================================================================*/
958
959 #if 1
960 /* Helpers to allow for a whole lot of flags. Otherwise we'd limit
961  * to 32 or 64 -f options...
962  */
963 typedef struct {
964     size_t  idx; /* index into an array of 32 bit words */
965     uint8_t bit; /* bit index for the 8 bit group idx points to */
966 } longbit;
967 #define LONGBIT(bit) { ((bit)/32), ((bit)%32) }
968 #define LONGBIT_SET(B, I) ((B).idx = (I)/32, (B).bit = ((I)%32))
969 #else
970 typedef uint32_t longbit;
971 #define LONGBIT(bit) (bit)
972 #define LONGBIT_SET(B, I) ((B) = (I))
973 #endif
974
975 /*===================================================================*/
976 /*=========================== utf8lib.c =============================*/
977 /*===================================================================*/
978 typedef uint32_t uchar_t;
979
980 bool    u8_analyze (const char *_s, size_t *_start, size_t *_len, uchar_t *_ch, size_t _maxlen);
981 size_t  u8_strlen  (const char*);
982 size_t  u8_strnlen (const char*, size_t);
983 uchar_t u8_getchar (const char*, const char**);
984 uchar_t u8_getnchar(const char*, const char**, size_t);
985 int     u8_fromchar(uchar_t w,   char *to,     size_t maxlen);
986
987 /*===================================================================*/
988 /*============================= opts.c ==============================*/
989 /*===================================================================*/
990 typedef struct {
991     const char *name;
992     longbit     bit;
993 } opts_flag_def;
994
995 bool opts_setflag  (const char *, bool);
996 bool opts_setwarn  (const char *, bool);
997 bool opts_setwerror(const char *, bool);
998 bool opts_setoptim (const char *, bool);
999
1000 void opts_init         (const char *, int, size_t);
1001 void opts_set          (uint32_t   *, size_t, bool);
1002 void opts_setoptimlevel(unsigned int);
1003 void opts_ini_init     (const char *);
1004
1005 /* Saner flag handling */
1006 void opts_backup_non_Wall(void);
1007 void opts_restore_non_Wall(void);
1008 void opts_backup_non_Werror_all(void);
1009 void opts_restore_non_Werror_all(void);
1010
1011
1012 enum {
1013 # define GMQCC_TYPE_FLAGS
1014 # define GMQCC_DEFINE_FLAG(X) X,
1015 #  include "opts.def"
1016     COUNT_FLAGS
1017 };
1018
1019 enum {
1020 # define GMQCC_TYPE_WARNS
1021 # define GMQCC_DEFINE_FLAG(X) WARN_##X,
1022 #  include "opts.def"
1023     COUNT_WARNINGS
1024 };
1025
1026 enum {
1027 # define GMQCC_TYPE_OPTIMIZATIONS
1028 # define GMQCC_DEFINE_FLAG(NAME, MIN_O) OPTIM_##NAME,
1029 #  include "opts.def"
1030     COUNT_OPTIMIZATIONS
1031 };
1032
1033 enum {
1034 #   define GMQCC_TYPE_OPTIONS
1035 #   define GMQCC_DEFINE_FLAG(X) OPTION_##X,
1036 #   include "opts.def"
1037     OPTION_COUNT
1038 };
1039
1040 extern const opts_flag_def opts_flag_list[COUNT_FLAGS+1];
1041 extern const opts_flag_def opts_warn_list[COUNT_WARNINGS+1];
1042 extern const opts_flag_def opts_opt_list[COUNT_OPTIMIZATIONS+1];
1043 extern const unsigned int  opts_opt_oflag[COUNT_OPTIMIZATIONS+1];
1044 extern unsigned int        opts_optimizationcount[COUNT_OPTIMIZATIONS];
1045
1046 /* other options: */
1047 typedef enum {
1048     COMPILER_QCC,     /* circa  QuakeC */
1049     COMPILER_FTEQCC,  /* fteqcc QuakeC */
1050     COMPILER_QCCX,    /* qccx   QuakeC */
1051     COMPILER_GMQCC    /* this   QuakeC */
1052 } opts_std_t;
1053
1054 typedef union {
1055     bool     B;
1056     uint16_t U16;
1057     uint32_t U32;
1058     char    *STR;
1059 } opt_value_t;
1060
1061
1062 typedef struct {
1063     opt_value_t  options      [OPTION_COUNT];
1064     uint32_t     flags        [1 + (COUNT_FLAGS         / 32)];
1065     uint32_t     warn         [1 + (COUNT_WARNINGS      / 32)];
1066     uint32_t     werror       [1 + (COUNT_WARNINGS      / 32)];
1067     uint32_t     warn_backup  [1 + (COUNT_WARNINGS      / 32)];
1068     uint32_t     werror_backup[1 + (COUNT_WARNINGS      / 32)];
1069     uint32_t     optimization [1 + (COUNT_OPTIMIZATIONS / 32)];
1070     bool         optimizeoff; /* True when -O0 */
1071 } opts_cmd_t;
1072
1073 extern opts_cmd_t opts;
1074
1075 #define OPTS_GENERIC(f,i)    (!! (((f)[(i)/32]) & (1<< (unsigned)((i)%32))))
1076 #define OPTS_FLAG(i)         OPTS_GENERIC(opts.flags,        (i))
1077 #define OPTS_WARN(i)         OPTS_GENERIC(opts.warn,         (i))
1078 #define OPTS_WERROR(i)       OPTS_GENERIC(opts.werror,       (i))
1079 #define OPTS_OPTIMIZATION(i) OPTS_GENERIC(opts.optimization, (i))
1080 #define OPTS_OPTION_BOOL(X) (opts.options[X].B)
1081 #define OPTS_OPTION_U16(X)  (opts.options[X].U16)
1082 #define OPTS_OPTION_U32(X)  (opts.options[X].U32)
1083 #define OPTS_OPTION_STR(X)  (opts.options[X].STR)
1084
1085 #endif /*! GMQCC_HDR */