Add g_usleep
[mono.git] / eglib / src / glib.h
1 #ifndef __GLIB_H
2 #define __GLIB_H
3
4 #include <stdarg.h>
5 #include <stdlib.h>
6 #include <string.h>
7 #include <stdio.h>
8 #include <stddef.h>
9 #include <ctype.h>
10 #include <limits.h>
11
12 #ifdef _MSC_VER
13 #pragma include_alias(<eglib-config.h>, <eglib-config.hw>)
14 #else
15 #include <stdint.h>
16 #endif
17
18 #include <eglib-config.h>
19
20 #ifndef offsetof
21 #   define offsetof(s_name,n_name) (size_t)(char *)&(((s_name*)0)->m_name)
22 #endif
23
24 #define __EGLIB_X11 1
25
26 /*
27  * Basic data types
28  */
29 typedef int            gboolean;
30 typedef int            gint;
31 typedef unsigned int   guint;
32 typedef short          gshort;
33 typedef unsigned short gushort;
34 typedef long           glong;
35 typedef unsigned long  gulong;
36 typedef void *         gpointer;
37 typedef const void *   gconstpointer;
38 typedef char           gchar;
39 typedef unsigned char  guchar;
40
41 #if !G_TYPES_DEFINED
42 #ifdef _MSC_VER
43 typedef __int8                          gint8;
44 typedef unsigned __int8         guint8;
45 typedef __int16                         gint16;
46 typedef unsigned __int16        guint16;
47 typedef __int32                         gint32;
48 typedef unsigned __int32        guint32;
49 typedef __int64                         gint64;
50 typedef unsigned __int64        guint64;
51 typedef float                           gfloat;
52 typedef double                          gdouble;
53 typedef unsigned __int16        gunichar2;
54 #else
55 /* Types defined in terms of the stdint.h */
56 typedef int8_t         gint8;
57 typedef uint8_t        guint8;
58 typedef int16_t        gint16;
59 typedef uint16_t       guint16;
60 typedef int32_t        gint32;
61 typedef uint32_t       guint32;
62 typedef int64_t        gint64;
63 typedef uint64_t       guint64;
64 typedef float          gfloat;
65 typedef double         gdouble;
66 typedef uint16_t       gunichar2;
67 #endif
68 #endif
69
70
71 /*
72  * Macros
73  */
74 #define G_N_ELEMENTS(s)      (sizeof(s) / sizeof ((s) [0]))
75
76 #define FALSE                0
77 #define TRUE                 1
78
79 #define G_MAXINT             INT_MAX
80 #define G_MININT             INT_MIN
81 #define G_MAXINT32           INT32_MAX
82 #define G_MININT32           INT32_MIN
83 #define G_MININT64           INT64_MIN
84 #define G_MAXINT64           INT64_MAX
85
86 #define G_LITTLE_ENDIAN 1234
87 #define G_BIG_ENDIAN    4321
88 #define G_STMT_START    do 
89 #define G_STMT_END      while (0)
90
91 #define G_USEC_PER_SEC  1000000
92
93 #define ABS(a)         ((a) > 0 ? (a) : -(a))
94
95 #define G_STRUCT_OFFSET(p_type,field) offsetof(p_type,field)
96
97 #define EGLIB_STRINGIFY(x) #x
98 #define EGLIB_TOSTRING(x) EGLIB_STRINGIFY(x)
99 #define G_STRLOC __FILE__ ":" EGLIB_TOSTRING(__LINE__) ":"
100
101 #ifdef  __cplusplus
102 #define G_BEGIN_DECLS  extern "C" {
103 #define G_END_DECLS    }
104 #else
105 #define G_BEGIN_DECLS
106 #define G_END_DECLS
107 #endif
108  
109 #define G_CONST_RETURN const
110
111 /*
112  * Allocation
113  */
114 void g_free (void *ptr);
115 static inline gpointer g_realloc (gpointer obj, gsize size) { if (!size) {g_free (obj); return 0;} return  realloc (obj, size);}
116 static inline gpointer g_malloc (gsize x) {if (x) return malloc (x); else return 0;}
117 static inline gpointer g_malloc0 (gsize x) {if (x) return calloc(1,x); else return 0;}
118 #define g_try_malloc(x)         g_malloc(x)
119 #define g_try_realloc(obj,size) g_realloc((obj),(size))
120
121 #define g_new(type,size)        ((type *) g_malloc (sizeof (type) * (size)))
122 #define g_new0(type,size)       ((type *) g_malloc0 (sizeof (type)* (size)))
123 #define g_newa(type,size)       ((type *) alloca (sizeof (type) * (size)))
124
125 #define g_memmove(dest,src,len) memmove (dest, src, len)
126 #define g_renew(struct_type, mem, n_structs) g_realloc (mem, sizeof (struct_type) * n_structs)
127 #define g_alloca(size)          alloca (size)
128
129 gpointer g_memdup (gconstpointer mem, guint byte_size);
130 static inline gchar   *g_strdup (const gchar *str) { if (str) {return strdup (str);} return NULL; }
131
132 typedef struct {
133         gpointer (*malloc)      (gsize    n_bytes);
134         gpointer (*realloc)     (gpointer mem, gsize n_bytes);
135         void     (*free)        (gpointer mem);
136         gpointer (*calloc)      (gsize    n_blocks, gsize n_block_bytes);
137         gpointer (*try_malloc)  (gsize    n_bytes);
138         gpointer (*try_realloc) (gpointer mem, gsize n_bytes);
139 } GMemVTable;
140
141 #define g_mem_set_vtable(x)
142 /*
143  * Misc.
144  */
145 #define g_atexit(func)  ((void) atexit (func))
146
147 const gchar *    g_getenv(const gchar *variable);
148 gboolean         g_setenv(const gchar *variable, const gchar *value, gboolean overwrite);
149 void             g_unsetenv(const gchar *variable);
150
151 gchar*           g_win32_getlocale(void);
152
153 /*
154  * Precondition macros
155  */
156 #define g_return_if_fail(x)  G_STMT_START { if (!(x)) { printf ("%s:%d: assertion '%s' failed", __FILE__, __LINE__, #x); return; } } G_STMT_END
157 #define g_return_val_if_fail(x,e)  G_STMT_START { if (!(x)) { printf ("%s:%d: assertion '%s' failed", __FILE__, __LINE__, #x); return (e); } } G_STMT_END
158
159 /*
160  * Hashtables
161  */
162 typedef struct _GHashTable GHashTable;
163 typedef void     (*GFunc)          (gpointer data, gpointer user_data);
164 typedef gint     (*GCompareFunc)   (gconstpointer a, gconstpointer b);
165 typedef gint     (*GCompareDataFunc) (gconstpointer a, gconstpointer b, gpointer user_data);
166 typedef void     (*GHFunc)         (gpointer key, gpointer value, gpointer user_data);
167 typedef gboolean (*GHRFunc)        (gpointer key, gpointer value, gpointer user_data);
168 typedef void     (*GDestroyNotify) (gpointer data);
169 typedef guint    (*GHashFunc)      (gconstpointer key);
170 typedef gboolean (*GEqualFunc)     (gconstpointer a, gconstpointer b);
171 typedef void     (*GFreeFunc)      (gpointer       data);
172
173 GHashTable     *g_hash_table_new             (GHashFunc hash_func, GEqualFunc key_equal_func);
174 GHashTable     *g_hash_table_new_full        (GHashFunc hash_func, GEqualFunc key_equal_func,
175                                               GDestroyNotify key_destroy_func, GDestroyNotify value_destroy_func);
176 void            g_hash_table_insert_replace  (GHashTable *hash, gpointer key, gpointer value, gboolean replace);
177 guint           g_hash_table_size            (GHashTable *hash);
178 gpointer        g_hash_table_lookup          (GHashTable *hash, gconstpointer key);
179 gboolean        g_hash_table_lookup_extended (GHashTable *hash, gconstpointer key, gpointer *orig_key, gpointer *value);
180 void            g_hash_table_foreach         (GHashTable *hash, GHFunc func, gpointer user_data);
181 gpointer        g_hash_table_find            (GHashTable *hash, GHRFunc predicate, gpointer user_data);
182 gboolean        g_hash_table_remove          (GHashTable *hash, gconstpointer key);
183 guint           g_hash_table_foreach_remove  (GHashTable *hash, GHRFunc func, gpointer user_data);
184 guint           g_hash_table_foreach_steal   (GHashTable *hash, GHRFunc func, gpointer user_data);
185 void            g_hash_table_destroy         (GHashTable *hash);
186
187 guint           g_spaced_primes_closest      (guint x);
188
189 #define g_hash_table_insert(h,k,v)    g_hash_table_insert_replace ((h),(k),(v),FALSE)
190 #define g_hash_table_replace(h,k,v)   g_hash_table_insert_replace ((h),(k),(v),TRUE)
191
192 gboolean g_direct_equal (gconstpointer v1, gconstpointer v2);
193 guint    g_direct_hash  (gconstpointer v1);
194 gboolean g_int_equal    (gconstpointer v1, gconstpointer v2);
195 guint    g_int_hash     (gconstpointer v1);
196 gboolean g_str_equal    (gconstpointer v1, gconstpointer v2);
197 guint    g_str_hash     (gconstpointer v1);
198
199 #define  g_assert(x)     G_STMT_START { if (!(x)) g_error ("* Assertion at %s:%d, condition `%s' not met\n", __FILE__, __LINE__, #x);  } G_STMT_END
200 #define  g_assert_not_reached() G_STMT_START { g_error ("* Assertion: should not be reached at %s:%d\n", __FILE__, __LINE__); } G_STMT_END
201
202 /*
203  * Errors
204  */
205 typedef struct {
206         /* In the real glib, this is a GQuark, but we dont use/need that */
207         gpointer domain;
208         gint     code;
209         gchar   *message;
210 } GError;
211
212 void    g_clear_error (GError **error);
213 void    g_error_free (GError *error);
214 GError *g_error_new  (gpointer domain, gint code, const char *format, ...);
215 void    g_set_error  (GError **err, gpointer domain, gint code, const gchar *format, ...);
216 void    g_propagate_error (GError **dest, GError *src);
217
218 /*
219  * Strings utility
220  */
221 gchar       *g_strdup_printf  (const gchar *format, ...);
222 gchar       *g_strdup_vprintf (const gchar *format, va_list args);
223 gchar       *g_strndup        (const gchar *str, gsize n);
224 const gchar *g_strerror       (gint errnum);
225 gchar       *g_strndup        (const gchar *str, gsize n);
226 void         g_strfreev       (gchar **str_array);
227 gchar       *g_strconcat      (const gchar *first, ...);
228 gchar      **g_strsplit       (const gchar *string, const gchar *delimiter, gint max_tokens);
229 gchar      **g_strsplit_set   (const gchar *string, const gchar *delimiter, gint max_tokens);
230 gchar       *g_strreverse     (gchar *str);
231 gboolean     g_str_has_prefix (const gchar *str, const gchar *prefix);
232 gboolean     g_str_has_suffix (const gchar *str, const gchar *suffix);
233 guint        g_strv_length    (gchar **str_array);
234 gchar       *g_strjoin        (const gchar *separator, ...);
235 gchar       *g_strjoinv       (const gchar *separator, gchar **str_array);
236 gchar       *g_strchug        (gchar *str);
237 gchar       *g_strchomp       (gchar *str);
238 void         g_strdown        (gchar *string);
239 gchar       *g_strnfill       (gsize length, gchar fill_char);
240
241 gchar       *g_strdelimit     (gchar *string, const gchar *delimiters, gchar new_delimiter);
242 gchar       *g_strescape      (const gchar *source, const gchar *exceptions);
243
244 gchar       *g_filename_to_uri   (const gchar *filename, const gchar *hostname, GError **error);
245 gchar       *g_filename_from_uri (const gchar *uri, gchar **hostname, GError **error);
246
247 gint         g_printf          (gchar const *format, ...);
248 gint         g_fprintf         (FILE *file, gchar const *format, ...);
249 gint         g_sprintf         (gchar *string, gchar const *format, ...);
250 gint         g_snprintf        (gchar *string, gulong n, gchar const *format, ...);
251 #define g_vprintf vprintf
252 #define g_vfprintf vfprintf
253 #define g_vsprintf vsprintf
254 #define g_vsnprintf vsnprintf
255 #define g_vasprintf vasprintf
256
257 gsize       g_strlcpy          (gchar *dest, const gchar *src, gsize dest_size);
258
259 gchar   g_ascii_tolower      (gchar c);
260 gchar  *g_ascii_strdown      (const gchar *str, gssize len);
261 gint    g_ascii_strncasecmp  (const gchar *s1, const gchar *s2, gsize n);
262 gint    g_ascii_xdigit_value (gchar c);
263 #define g_ascii_isspace(c)   (isspace (c) != 0)
264 #define g_ascii_isalpha(c)   (isalpha (c) != 0)
265 #define g_ascii_isprint(c)   (isprint (c) != 0)
266 #define g_ascii_isxdigit(c)  (isxdigit (c) != 0)
267
268 /* FIXME: g_strcasecmp supports utf8 unicode stuff */
269 #ifdef _MSC_VER
270 #define g_strcasecmp stricmp
271 #define g_ascii_strcasecmp stricmp
272 #define g_strncasecmp strnicmp
273 #define g_strstrip(a) g_strchug (g_strchomp (a))
274 #else
275 #define g_strcasecmp strcasecmp
276 #define g_ascii_strcasecmp strcasecmp
277 #define g_strncasecmp strncasecmp
278 #define g_strstrip(a) g_strchug (g_strchomp (a))
279 #endif
280
281
282 #define G_STR_DELIMITERS "_-|> <."
283
284 /*
285  * String type
286  */
287 typedef struct {
288         char *str;
289         gsize len;
290         gsize allocated_len;
291 } GString;
292
293 GString     *g_string_new           (const gchar *init);
294 GString     *g_string_new_len       (const gchar *init, gssize len);
295 GString     *g_string_sized_new     (gsize default_size);
296 gchar       *g_string_free          (GString *string, gboolean free_segment);
297 GString     *g_string_append        (GString *string, const gchar *val);
298 void         g_string_printf        (GString *string, const gchar *format, ...);
299 void         g_string_append_printf (GString *string, const gchar *format, ...);
300 GString     *g_string_append_c      (GString *string, gchar c);
301 GString     *g_string_append        (GString *string, const gchar *val);
302 GString     *g_string_append_len    (GString *string, const gchar *val, gssize len);
303 GString     *g_string_truncate      (GString *string, gsize len);
304 GString     *g_string_prepend       (GString *string, const gchar *val);
305
306 #define g_string_sprintfa g_string_append_printf
307
308 /*
309  * Lists
310  */
311 typedef struct _GSList GSList;
312 struct _GSList {
313         gpointer data;
314         GSList *next;
315 };
316
317 GSList *g_slist_alloc         (void);
318 GSList *g_slist_append        (GSList        *list,
319                                gpointer       data);
320 GSList *g_slist_prepend       (GSList        *list,
321                                gpointer       data);
322 void    g_slist_free          (GSList        *list);
323 void    g_slist_free_1        (GSList        *list);
324 GSList *g_slist_copy          (GSList        *list);
325 GSList *g_slist_concat        (GSList        *list1,
326                                GSList        *list2);
327 void    g_slist_foreach       (GSList        *list,
328                                GFunc          func,
329                                gpointer       user_data);
330 GSList *g_slist_last          (GSList        *list);
331 GSList *g_slist_find          (GSList        *list,
332                                gconstpointer  data);
333 GSList *g_slist_find_custom   (GSList        *list,
334                                gconstpointer  data,
335                                GCompareFunc   func);
336 GSList *g_slist_remove        (GSList        *list,
337                                gconstpointer  data);
338 GSList *g_slist_remove_all    (GSList        *list,
339                                gconstpointer  data);
340 GSList *g_slist_reverse       (GSList        *list);
341 guint   g_slist_length        (GSList        *list);
342 GSList *g_slist_remove_link   (GSList        *list,
343                                GSList        *link);
344 GSList *g_slist_delete_link   (GSList        *list,
345                                GSList        *link);
346 GSList *g_slist_insert_sorted (GSList        *list,
347                                gpointer       data,
348                                GCompareFunc   func);
349 GSList *g_slist_insert_before (GSList        *list,
350                                GSList        *sibling,
351                                gpointer       data);
352 GSList *g_slist_sort          (GSList        *list,
353                                GCompareFunc   func);
354 gint    g_slist_index         (GSList        *list,
355                                gconstpointer  data);
356 GSList *g_slist_nth           (GSList        *list,
357                                guint          n);
358 gpointer g_slist_nth_data     (GSList        *list,
359                                guint          n);
360
361 #define g_slist_next(slist) ((slist) ? (((GSList *) (slist))->next) : NULL)
362
363
364 typedef struct _GList GList;
365 struct _GList {
366   gpointer data;
367   GList *next;
368   GList *prev;
369 };
370
371 #define g_list_next(list) ((list) ? (((GList *) (list))->next) : NULL)
372 #define g_list_previous(list) ((list) ? (((GList *) (list))->prev) : NULL)
373
374 GList *g_list_alloc         (void);
375 GList *g_list_append        (GList         *list,
376                              gpointer       data);
377 GList *g_list_prepend       (GList         *list,
378                              gpointer       data);
379 void   g_list_free          (GList         *list);
380 void   g_list_free_1        (GList         *list);
381 GList *g_list_copy          (GList         *list);
382 guint  g_list_length        (GList         *list);
383 gint   g_list_index         (GList         *list,
384                              gconstpointer  data);
385 GList *g_list_nth           (GList         *list,
386                              guint          n);
387 gpointer g_list_nth_data      (GList         *list,
388                              guint          n);
389 GList *g_list_last          (GList         *list);
390 GList *g_list_concat        (GList         *list1,
391                              GList         *list2);
392 void   g_list_foreach       (GList         *list,
393                              GFunc          func,
394                              gpointer       user_data);
395 GList *g_list_first         (GList         *list);
396 GList *g_list_find          (GList         *list,
397                              gconstpointer  data);
398 GList *g_list_find_custom   (GList         *list,
399                              gconstpointer  data,
400                              GCompareFunc   func);
401 GList *g_list_remove        (GList         *list,
402                              gconstpointer  data);
403 GList *g_list_reverse       (GList         *list);
404 GList *g_list_remove_link   (GList         *list,
405                              GList         *link);
406 GList *g_list_delete_link   (GList         *list,
407                              GList         *link);
408 GList *g_list_insert_sorted (GList         *list,
409                              gpointer       data,
410                              GCompareFunc   func);
411 GList *g_list_insert_before (GList         *list,
412                              GList         *sibling,
413                              gpointer       data);
414 GList *g_list_sort          (GList         *sort,
415                              GCompareFunc   func);
416
417 /*
418  * Array
419  */
420
421 typedef struct _GArray GArray;
422 struct _GArray {
423         gchar *data;
424         gint len;
425 };
426
427 GArray *g_array_new               (gboolean zero_terminated, gboolean clear_, guint element_size);
428 gchar*  g_array_free              (GArray *array, gboolean free_segment);
429 GArray *g_array_append_vals       (GArray *array, gconstpointer data, guint len);
430 GArray* g_array_insert_vals       (GArray *array, guint index_, gconstpointer data, guint len);
431 GArray* g_array_remove_index      (GArray *array, guint index_);
432 GArray* g_array_remove_index_fast (GArray *array, guint index_);
433
434 #define g_array_append_val(a,v)   (g_array_append_vals((a),&(v),1))
435 #define g_array_insert_val(a,i,v) (g_array_insert_vals((a),(i),&(v),1))
436 #define g_array_index(a,t,i)      *(t*)(((a)->data) + sizeof(t) * (i))
437
438 /*
439  * Pointer Array
440  */
441
442 typedef struct _GPtrArray GPtrArray;
443 struct _GPtrArray {
444         gpointer *pdata;
445         guint len;
446 };
447
448 GPtrArray *g_ptr_array_new                (void);
449 GPtrArray *g_ptr_array_sized_new          (guint reserved_size);
450 void       g_ptr_array_add                (GPtrArray *array, gpointer data);
451 gboolean   g_ptr_array_remove             (GPtrArray *array, gpointer data);
452 gpointer   g_ptr_array_remove_index       (GPtrArray *array, guint index);
453 gboolean   g_ptr_array_remove_fast        (GPtrArray *array, gpointer data);
454 gpointer   g_ptr_array_remove_index_fast  (GPtrArray *array, guint index);
455 void       g_ptr_array_sort               (GPtrArray *array, GCompareFunc compare_func);
456 void       g_ptr_array_sort_with_data     (GPtrArray *array, GCompareDataFunc compare_func, gpointer user_data);
457 void       g_ptr_array_set_size           (GPtrArray *array, gint length);
458 gpointer  *g_ptr_array_free               (GPtrArray *array, gboolean free_seg);
459 void       g_ptr_array_foreach            (GPtrArray *array, GFunc func, gpointer user_data);
460 #define    g_ptr_array_index(array,index) (array)->pdata[(index)]
461
462 /*
463  * Queues
464  */
465 typedef struct {
466         GList *head;
467         GList *tail;
468         guint length;
469 } GQueue;
470
471 gpointer g_queue_pop_head  (GQueue   *queue);
472 void     g_queue_push_head (GQueue   *queue,
473                             gpointer  data);
474 void     g_queue_push_tail (GQueue   *queue,
475                             gpointer  data);
476 gboolean g_queue_is_empty  (GQueue   *queue);
477 GQueue  *g_queue_new       (void);
478 void     g_queue_free      (GQueue   *queue);
479
480 /*
481  * Messages
482  */
483 #ifndef G_LOG_DOMAIN
484 #define G_LOG_DOMAIN ((gchar*) 0)
485 #endif
486
487 typedef enum {
488         G_LOG_FLAG_RECURSION          = 1 << 0,
489         G_LOG_FLAG_FATAL              = 1 << 1,
490         
491         G_LOG_LEVEL_ERROR             = 1 << 2,
492         G_LOG_LEVEL_CRITICAL          = 1 << 3,
493         G_LOG_LEVEL_WARNING           = 1 << 4,
494         G_LOG_LEVEL_MESSAGE           = 1 << 5,
495         G_LOG_LEVEL_INFO              = 1 << 6,
496         G_LOG_LEVEL_DEBUG             = 1 << 7,
497         
498         G_LOG_LEVEL_MASK              = ~(G_LOG_FLAG_RECURSION | G_LOG_FLAG_FATAL)
499 } GLogLevelFlags;
500
501 void           g_print                (const gchar *format, ...);
502 GLogLevelFlags g_log_set_always_fatal (GLogLevelFlags fatal_mask);
503 GLogLevelFlags g_log_set_fatal_mask   (const gchar *log_domain, GLogLevelFlags fatal_mask);
504 void           g_logv                 (const gchar *log_domain, GLogLevelFlags log_level, const gchar *format, va_list args);
505 void           g_log                  (const gchar *log_domain, GLogLevelFlags log_level, const gchar *format, ...);
506
507 #ifdef HAVE_C99_SUPPORT
508 #define g_error(format, ...)    g_log (G_LOG_DOMAIN, G_LOG_LEVEL_ERROR, format, __VA_ARGS__)
509 #define g_critical(format, ...) g_log (G_LOG_DOMAIN, G_LOG_LEVEL_CRITICAL, format, __VA_ARGS__)
510 #define g_warning(format, ...)  g_log (G_LOG_DOMAIN, G_LOG_LEVEL_WARNING, format, __VA_ARGS__)
511 #define g_message(format, ...)  g_log (G_LOG_DOMAIN, G_LOG_LEVEL_MESSAGE, format, __VA_ARGS__)
512 #define g_debug(format, ...)    g_log (G_LOG_DOMAIN, G_LOG_LEVEL_DEBUG, format, __VA_ARGS__)
513
514 #define g_printerr(format, ...) fprintf (stderr, format, __VA_ARGS__)
515 #else
516 #define g_error(...)    g_log (G_LOG_DOMAIN, G_LOG_LEVEL_ERROR, __VA_ARGS__)
517 #define g_critical(...) g_log (G_LOG_DOMAIN, G_LOG_LEVEL_CRITICAL, __VA_ARGS__)
518 #define g_warning(...)  g_log (G_LOG_DOMAIN, G_LOG_LEVEL_WARNING, __VA_ARGS__)
519 #define g_message(...)  g_log (G_LOG_DOMAIN, G_LOG_LEVEL_MESSAGE, __VA_ARGS__)
520 #define g_debug(...)    g_log (G_LOG_DOMAIN, G_LOG_LEVEL_DEBUG, __VA_ARGS__)
521
522 #define g_printerr(...) fprintf (stderr, __VA_ARGS__)
523 #endif
524 #define g_log_set_handler(a,b,c,d)
525 /*
526  * Conversions
527  */
528
529 gpointer g_convert_error_quark(void);
530
531
532 /*
533  * Unicode Manipulation: most of this is not used by Mono by default, it is
534  * only used if the old collation code is activated, so this is only the
535  * bare minimum to build.
536  */
537 typedef guint32 gunichar;
538
539 typedef enum {
540         G_UNICODE_CONTROL,
541         G_UNICODE_FORMAT,
542         G_UNICODE_UNASSIGNED,
543         G_UNICODE_PRIVATE_USE,
544         G_UNICODE_SURROGATE,
545         G_UNICODE_LOWERCASE_LETTER,
546         G_UNICODE_MODIFIER_LETTER,
547         G_UNICODE_OTHER_LETTER,
548         G_UNICODE_TITLECASE_LETTER,
549         G_UNICODE_UPPERCASE_LETTER,
550         G_UNICODE_COMBINING_MARK,
551         G_UNICODE_ENCLOSING_MARK,
552         G_UNICODE_NON_SPACING_MARK,
553         G_UNICODE_DECIMAL_NUMBER,
554         G_UNICODE_LETTER_NUMBER,
555         G_UNICODE_OTHER_NUMBER,
556         G_UNICODE_CONNECT_PUNCTUATION,
557         G_UNICODE_DASH_PUNCTUATION,
558         G_UNICODE_CLOSE_PUNCTUATION,
559         G_UNICODE_FINAL_PUNCTUATION,
560         G_UNICODE_INITIAL_PUNCTUATION,
561         G_UNICODE_OTHER_PUNCTUATION,
562         G_UNICODE_OPEN_PUNCTUATION,
563         G_UNICODE_CURRENCY_SYMBOL,
564         G_UNICODE_MODIFIER_SYMBOL,
565         G_UNICODE_MATH_SYMBOL,
566         G_UNICODE_OTHER_SYMBOL,
567         G_UNICODE_LINE_SEPARATOR,
568         G_UNICODE_PARAGRAPH_SEPARATOR,
569         G_UNICODE_SPACE_SEPARATOR
570 } GUnicodeType;
571
572 gunichar       g_unichar_toupper (gunichar c);
573 gunichar       g_unichar_tolower (gunichar c);
574 gunichar       g_unichar_totitle (gunichar c);
575 GUnicodeType   g_unichar_type    (gunichar c);
576 gboolean       g_unichar_isxdigit (gunichar c);
577 gint           g_unichar_xdigit_value (gunichar c);
578
579 #ifndef MAX
580 #define MAX(a,b) (((a)>(b)) ? (a) : (b))
581 #endif
582
583 #ifndef MIN
584 #define MIN(a,b) (((a)<(b)) ? (a) : (b))
585 #endif
586
587 #ifndef CLAMP
588 #define CLAMP(a,low,high) (((a) < (low)) ? (low) : (((a) > (high)) ? (high) : (a)))
589 #endif
590
591 /* FIXME: Implement these two for gcc */
592 #define G_LIKELY(x) (x)
593 #define G_UNLIKELY(x) (x)
594
595 /*
596  * Unicode conversion
597  */
598
599 #define G_CONVERT_ERROR g_convert_error_quark()
600
601 typedef enum {
602         G_CONVERT_ERROR_NO_CONVERSION,
603         G_CONVERT_ERROR_ILLEGAL_SEQUENCE,
604         G_CONVERT_ERROR_FAILED,
605         G_CONVERT_ERROR_PARTIAL_INPUT,
606         G_CONVERT_ERROR_BAD_URI,
607         G_CONVERT_ERROR_NOT_ABSOLUTE_PATH
608 } GConvertError;
609
610 gchar* g_utf8_strup (const gchar *str, gssize len);
611 gchar* g_utf8_strdown (const gchar *str, gssize len);
612 gunichar2 *g_utf8_to_utf16 (const gchar *str, glong len, glong *items_read, glong *items_written, GError **error);
613 gchar     *g_utf16_to_utf8 (const gunichar2 *str, glong len, glong *items_read, glong *items_written, GError **error);
614 gunichar2 *g_ucs4_to_utf16 (const gunichar *str, glong len, glong *items_read, glong *items_written, GError **error);
615 gunichar  *g_utf16_to_ucs4 (const gunichar2 *str, glong len, glong *items_read, glong *items_written, GError **error);
616
617 #define u8to16(str) g_utf8_to_utf16(str, (glong)strlen(str), NULL, NULL, NULL)
618
619 #ifdef G_OS_WIN32
620 #define u16to8(str) g_utf16_to_utf8(str, (glong)wcslen(str), NULL, NULL, NULL)
621 #else
622 #define u16to8(str) g_utf16_to_utf8(str, (glong)strlen(str), NULL, NULL, NULL)
623 #endif
624
625 /*
626  * Path
627  */
628 gchar  *g_build_path           (const gchar *separator, const gchar *first_element, ...);
629 #define g_build_filename(x, ...) g_build_path(G_DIR_SEPARATOR_S, x, __VA_ARGS__)
630 gchar  *g_path_get_dirname     (const gchar *filename);
631 gchar  *g_path_get_basename    (const char *filename);
632 gchar  *g_find_program_in_path (const gchar *program);
633 gchar  *g_get_current_dir      (void);
634 gboolean g_path_is_absolute    (const char *filename);
635
636 const gchar *g_get_home_dir    (void);
637 const gchar *g_get_tmp_dir     (void);
638 const gchar *g_get_user_name   (void);
639 gchar *g_get_prgname           (void);
640 void  g_set_prgname            (const gchar *prgname);
641
642 /*
643  * Shell
644  */
645
646 gboolean  g_shell_parse_argv (const gchar *command_line, gint *argcp, gchar ***argvp, GError **error);
647 gchar    *g_shell_unquote    (const gchar *quoted_string, GError **error);
648 gchar    *g_shell_quote      (const gchar *unquoted_string);
649
650 /*
651  * Spawn
652  */
653 typedef enum {
654         G_SPAWN_LEAVE_DESCRIPTORS_OPEN = 1,
655         G_SPAWN_DO_NOT_REAP_CHILD      = 1 << 1,
656         G_SPAWN_SEARCH_PATH            = 1 << 2,
657         G_SPAWN_STDOUT_TO_DEV_NULL     = 1 << 3,
658         G_SPAWN_STDERR_TO_DEV_NULL     = 1 << 4,
659         G_SPAWN_CHILD_INHERITS_STDIN   = 1 << 5,
660         G_SPAWN_FILE_AND_ARGV_ZERO     = 1 << 6
661 } GSpawnFlags;
662
663 typedef pid_t GPid;
664
665 typedef void (*GSpawnChildSetupFunc) (gpointer user_data);
666
667 gboolean g_spawn_command_line_sync (const gchar *command_line, gchar **standard_output, gchar **standard_error, gint *exit_status, GError **error);
668 gboolean g_spawn_async_with_pipes  (const gchar *working_directory, gchar **argv, gchar **envp, GSpawnFlags flags, GSpawnChildSetupFunc child_setup,
669                                 gpointer user_data, GPid *child_pid, gint *standard_input, gint *standard_output, gint *standard_error, GError **error);
670
671
672 /*
673  * Timer
674  */
675 typedef struct _GTimer GTimer;
676
677 GTimer *g_timer_new (void);
678 void g_timer_destroy (GTimer *timer);
679 gdouble g_timer_elapsed (GTimer *timer, gulong *microseconds);
680 void g_timer_stop (GTimer *timer);
681 void g_timer_start (GTimer *timer);
682
683 /*
684  * Date and time
685  */
686 typedef struct {
687         glong tv_sec;
688         glong tv_usec;
689 } GTimeVal;
690
691 void g_get_current_time (GTimeVal *result);
692 void g_usleep (gulong microseconds);
693
694 /*
695  * File
696  */
697
698 typedef enum {
699         G_FILE_ERROR_EXIST,
700         G_FILE_ERROR_ISDIR,
701         G_FILE_ERROR_ACCES,
702         G_FILE_ERROR_NAMETOOLONG,
703         G_FILE_ERROR_NOENT,
704         G_FILE_ERROR_NOTDIR,
705         G_FILE_ERROR_NXIO,
706         G_FILE_ERROR_NODEV,
707         G_FILE_ERROR_ROFS,
708         G_FILE_ERROR_TXTBSY,
709         G_FILE_ERROR_FAULT,
710         G_FILE_ERROR_LOOP,
711         G_FILE_ERROR_NOSPC,
712         G_FILE_ERROR_NOMEM,
713         G_FILE_ERROR_MFILE,
714         G_FILE_ERROR_NFILE,
715         G_FILE_ERROR_BADF,
716         G_FILE_ERROR_INVAL,
717         G_FILE_ERROR_PIPE,
718         G_FILE_ERROR_AGAIN,
719         G_FILE_ERROR_INTR,
720         G_FILE_ERROR_IO,
721         G_FILE_ERROR_PERM,
722         G_FILE_ERROR_NOSYS,
723         G_FILE_ERROR_FAILED
724 } GFileError;
725
726 typedef enum {
727         G_FILE_TEST_IS_REGULAR = 1 << 0,
728         G_FILE_TEST_IS_SYMLINK = 1 << 1,
729         G_FILE_TEST_IS_DIR = 1 << 2,
730         G_FILE_TEST_IS_EXECUTABLE = 1 << 3,
731         G_FILE_TEST_EXISTS = 1 << 4
732 } GFileTest;
733
734
735 gboolean   g_file_get_contents (const gchar *filename, gchar **contents, gsize *length, GError **error);
736 GFileError g_file_error_from_errno (gint err_no);
737 gint       g_file_open_tmp (const gchar *tmpl, gchar **name_used, GError **error);
738 gboolean   g_file_test (const gchar *filename, GFileTest test);
739
740 /*
741  * Pattern matching
742  */
743 typedef struct _GPatternSpec GPatternSpec;
744 GPatternSpec * g_pattern_spec_new (const gchar *pattern);
745 void           g_pattern_spec_free (GPatternSpec *pspec);
746 gboolean       g_pattern_match_string (GPatternSpec *pspec, const gchar *string);
747
748 /*
749  * Directory
750  */
751 typedef struct _GDir GDir;
752 GDir        *g_dir_open (const gchar *path, guint flags, GError **error);
753 const gchar *g_dir_read_name (GDir *dir);
754 void         g_dir_rewind (GDir *dir);
755 void         g_dir_close (GDir *dir);
756
757 /*
758  * GMarkup
759  */
760 typedef struct _GMarkupParseContext GMarkupParseContext;
761
762 typedef enum
763 {
764         G_MARKUP_DO_NOT_USE_THIS_UNSUPPORTED_FLAG = 1 << 0,
765         G_MARKUP_TREAT_CDATA_AS_TEXT              = 1 << 1
766 } GMarkupParseFlags;
767
768 typedef struct {
769         void (*start_element)  (GMarkupParseContext *context,
770                                 const gchar *element_name,
771                                 const gchar **attribute_names,
772                                 const gchar **attribute_values,
773                                 gpointer user_data,
774                                 GError **error);
775
776         void (*end_element)    (GMarkupParseContext *context,
777                                 const gchar         *element_name,
778                                 gpointer             user_data,
779                                 GError             **error);
780         
781         void (*text)           (GMarkupParseContext *context,
782                                 const gchar         *text,
783                                 gsize                text_len,  
784                                 gpointer             user_data,
785                                 GError             **error);
786         
787         void (*passthrough)    (GMarkupParseContext *context,
788                                 const gchar         *passthrough_text,
789                                 gsize                text_len,  
790                                 gpointer             user_data,
791                                 GError             **error);
792         void (*error)          (GMarkupParseContext *context,
793                                 GError              *error,
794                                 gpointer             user_data);
795 } GMarkupParser;
796
797 GMarkupParseContext *g_markup_parse_context_new   (const GMarkupParser *parser,
798                                                    GMarkupParseFlags flags,
799                                                    gpointer user_data,
800                                                    GDestroyNotify user_data_dnotify);
801 void                 g_markup_parse_context_free  (GMarkupParseContext *context);
802 gboolean             g_markup_parse_context_parse (GMarkupParseContext *context,
803                                                    const gchar *text, gssize text_len,
804                                                    GError **error);
805 gboolean         g_markup_parse_context_end_parse (GMarkupParseContext *context,
806                                                    GError **error);
807
808 /*
809  * Character set conversion
810  */
811 /*
812 * Index into the table below with the first byte of a UTF-8 sequence to
813 * get the number of trailing bytes that are supposed to follow it.
814 * Note that *legal* UTF-8 values can't have 4 or 5-bytes. The table is
815 * left as-is for anyone who may want to do such conversion, which was
816 * allowed in earlier algorithms.
817 */
818 extern const gchar g_trailingBytesForUTF8[256];
819
820 gboolean  g_get_charset        (G_CONST_RETURN char **charset);
821 gchar    *g_locale_to_utf8     (const gchar *opsysstring, gssize len,
822                                 gsize *bytes_read, gsize *bytes_written,
823                                 GError **error);
824 gchar    *g_locale_from_utf8   (const gchar *utf8string, gssize len, gsize *bytes_read,
825                                 gsize *bytes_written, GError **error);
826 gchar    *g_filename_from_utf8 (const gchar *utf8string, gssize len, gsize *bytes_read,
827                                 gsize *bytes_written, GError **error);
828 gchar    *g_convert            (const gchar *str, gssize len,
829                                 const gchar *to_codeset, const gchar *from_codeset,
830                                 gsize *bytes_read, gsize *bytes_written, GError **error);
831 gboolean  g_utf8_validate      (const gchar *str, gssize max_len, const gchar **end);
832 gunichar  g_utf8_get_char      (const gchar *src);
833 glong     g_utf8_strlen        (const gchar *str, gssize max);
834 #define   g_utf8_next_char(p) p + (g_trailingBytesForUTF8[(guchar)(*p)] + 1)
835
836 /*
837  * Empty thread functions, not used by eglib
838  */
839 #define g_thread_supported()   TRUE
840 #define g_thread_init(x)       G_STMT_START { if (x != NULL) { g_error ("No vtable supported in g_thread_init"); } } G_STMT_END
841
842 #define G_LOCK_DEFINE(name)        int name;
843 #define G_LOCK_DEFINE_STATIC(name) static int name;
844 #define G_LOCK_EXTERN(name)
845 #define G_LOCK(name)
846 #define G_TRYLOCK(name)
847 #define G_UNLOCK(name)
848
849 #define GUINT16_SWAP_LE_BE_CONSTANT(x) ((((guint16) x) >> 8) | ((((guint16) x) << 8)))
850
851 #define GUINT16_SWAP_LE_BE(x) ((guint16) (((guint16) x) >> 8) | ((((guint16)(x)) & 0xff) << 8))
852 #define GUINT32_SWAP_LE_BE(x) ((guint32) \
853                                ( (((guint32) (x)) << 24)| \
854                                  ((((guint32) (x)) & 0xff0000) >> 8) | \
855                                  ((((guint32) (x)) & 0xff00) << 8) | \
856                                  (((guint32) (x)) >> 24)) )
857  
858 #define GUINT64_SWAP_LE_BE(x) ((guint64) (((guint64)(GUINT32_SWAP_LE_BE(((guint64)x) & 0xffffffff))) << 32) | \
859                                GUINT32_SWAP_LE_BE(((guint64)x) >> 32))
860
861                                   
862  
863 #if G_BYTE_ORDER == G_LITTLE_ENDIAN
864 #   define GUINT32_TO_LE(x) (x)
865 #   define GUINT64_TO_LE(x) (x)
866 #   define GUINT16_TO_LE(x) (x)
867 #   define GUINT_TO_LE(x)   (x)
868 #   define GUINT32_TO_BE(x) GUINT32_SWAP_LE_BE(x)
869 #   define GUINT32_FROM_BE(x) GUINT32_SWAP_LE_BE(x)
870 #else
871 #   define GUINT32_TO_LE(x) GUINT32_SWAP_LE_BE(x)
872 #   define GUINT64_TO_LE(x) GUINT64_SWAP_LE_BE(x)
873 #   define GUINT16_TO_LE(x) GUINT16_SWAP_LE_BE(x)
874 #   define GUINT_TO_LE(x)   GUINT32_SWAP_LE_BE(x)
875 #   define GUINT32_TO_BE(x) (x)
876 #   define GUINT32_FROM_BE(x) (x)
877 #endif
878
879 #define GUINT32_FROM_LE(x)  (GUINT32_TO_LE (x))
880 #define GUINT64_FROM_LE(x)  (GUINT64_TO_LE (x))
881 #define GUINT16_FROM_LE(x)  (GUINT16_TO_LE (x))
882 #define GUINT_FROM_LE(x)    (GUINT_TO_LE (x))
883
884 #define _EGLIB_MAJOR  2
885 #define _EGLIB_MIDDLE 4
886 #define _EGLIB_MINOR  0
887  
888 #define GLIB_CHECK_VERSION(a,b,c) ((a < _EGLIB_MAJOR) || (a == _EGLIB_MAJOR && (b < _EGLIB_MIDDLE || (b == _EGLIB_MIDDLE && c <= _EGLIB_MINOR))))
889  
890 #endif
891
892
893