Oops
[mono-project/dkf.git] / eglib / src / glib.h
blobbbb2f6509991b8b9c100ca6168c279e968184256
1 #ifndef __GLIB_H
2 #define __GLIB_H
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>
12 #ifdef _MSC_VER
13 #pragma include_alias(<eglib-config.h>, <eglib-config.hw>)
14 #endif
16 /* VS 2010 and later have stdint.h */
17 #if defined(_MSC_VER) && _MSC_VER < 1600
18 #else
19 #include <stdint.h>
20 #endif
22 #include <eglib-config.h>
23 #ifndef EGLIB_NO_REMAP
24 #include <eglib-remap.h>
25 #endif
27 #ifdef G_HAVE_ALLOCA_H
28 #include <alloca.h>
29 #endif
31 #ifdef WIN32
32 /* For alloca */
33 #include <malloc.h>
34 #endif
36 #ifndef offsetof
37 # define offsetof(s_name,n_name) (size_t)(char *)&(((s_name*)0)->m_name)
38 #endif
40 #define __EGLIB_X11 1
42 #ifdef __cplusplus
43 #define G_BEGIN_DECLS extern "C" {
44 #define G_END_DECLS }
45 #else
46 #define G_BEGIN_DECLS
47 #define G_END_DECLS
48 #endif
50 G_BEGIN_DECLS
52 #ifdef G_OS_WIN32
53 /* MSC and Cross-compilatin will use this */
54 int vasprintf (char **strp, const char *fmt, va_list ap);
55 #endif
59 * Basic data types
61 typedef int gint;
62 typedef unsigned int guint;
63 typedef short gshort;
64 typedef unsigned short gushort;
65 typedef long glong;
66 typedef unsigned long gulong;
67 typedef void * gpointer;
68 typedef const void * gconstpointer;
69 typedef char gchar;
70 typedef unsigned char guchar;
72 #if !G_TYPES_DEFINED
73 /* VS 2010 and later have stdint.h */
74 #if defined(_MSC_VER) && _MSC_VER < 1600
75 typedef __int8 gint8;
76 typedef unsigned __int8 guint8;
77 typedef __int16 gint16;
78 typedef unsigned __int16 guint16;
79 typedef __int32 gint32;
80 typedef unsigned __int32 guint32;
81 typedef __int64 gint64;
82 typedef unsigned __int64 guint64;
83 typedef float gfloat;
84 typedef double gdouble;
85 typedef int gboolean;
86 #else
87 /* Types defined in terms of the stdint.h */
88 typedef int8_t gint8;
89 typedef uint8_t guint8;
90 typedef int16_t gint16;
91 typedef uint16_t guint16;
92 typedef int32_t gint32;
93 typedef uint32_t guint32;
94 typedef int64_t gint64;
95 typedef uint64_t guint64;
96 typedef float gfloat;
97 typedef double gdouble;
98 typedef int32_t gboolean;
99 #endif
100 #endif
102 typedef guint16 gunichar2;
103 typedef guint32 gunichar;
106 * Macros
108 #define G_N_ELEMENTS(s) (sizeof(s) / sizeof ((s) [0]))
110 #define FALSE 0
111 #define TRUE 1
113 #define G_MAXINT INT_MAX
114 #define G_MININT INT_MIN
115 #define G_MAXINT32 INT32_MAX
116 #define G_MAXUINT32 UINT32_MAX
117 #define G_MININT32 INT32_MIN
118 #define G_MININT64 INT64_MIN
119 #define G_MAXINT64 INT64_MAX
120 #define G_MAXUINT64 UINT64_MAX
122 #define G_LITTLE_ENDIAN 1234
123 #define G_BIG_ENDIAN 4321
124 #define G_STMT_START do
125 #define G_STMT_END while (0)
127 #define G_USEC_PER_SEC 1000000
129 #define ABS(a) ((a) > 0 ? (a) : -(a))
131 #define G_STRUCT_OFFSET(p_type,field) offsetof(p_type,field)
133 #define EGLIB_STRINGIFY(x) #x
134 #define EGLIB_TOSTRING(x) EGLIB_STRINGIFY(x)
135 #define G_STRLOC __FILE__ ":" EGLIB_TOSTRING(__LINE__) ":"
137 #define G_CONST_RETURN const
140 * Allocation
142 void g_free (void *ptr);
143 gpointer g_realloc (gpointer obj, gsize size);
144 gpointer g_malloc (gsize x);
145 gpointer g_malloc0 (gsize x);
146 gpointer g_try_malloc (gsize x);
147 gpointer g_try_realloc (gpointer obj, gsize size);
149 #define g_new(type,size) ((type *) g_malloc (sizeof (type) * (size)))
150 #define g_new0(type,size) ((type *) g_malloc0 (sizeof (type)* (size)))
151 #define g_newa(type,size) ((type *) alloca (sizeof (type) * (size)))
153 #define g_memmove(dest,src,len) memmove (dest, src, len)
154 #define g_renew(struct_type, mem, n_structs) g_realloc (mem, sizeof (struct_type) * n_structs)
155 #define g_alloca(size) alloca (size)
157 gpointer g_memdup (gconstpointer mem, guint byte_size);
158 static inline gchar *g_strdup (const gchar *str) { if (str) {return strdup (str);} return NULL; }
159 gchar **g_strdupv (gchar **str_array);
161 typedef struct {
162 gpointer (*malloc) (gsize n_bytes);
163 gpointer (*realloc) (gpointer mem, gsize n_bytes);
164 void (*free) (gpointer mem);
165 gpointer (*calloc) (gsize n_blocks, gsize n_block_bytes);
166 gpointer (*try_malloc) (gsize n_bytes);
167 gpointer (*try_realloc) (gpointer mem, gsize n_bytes);
168 } GMemVTable;
170 #define g_mem_set_vtable(x)
172 struct _GMemChunk {
173 guint alloc_size;
176 typedef struct _GMemChunk GMemChunk;
178 * Misc.
180 #define g_atexit(func) ((void) atexit (func))
182 const gchar * g_getenv(const gchar *variable);
183 gboolean g_setenv(const gchar *variable, const gchar *value, gboolean overwrite);
184 void g_unsetenv(const gchar *variable);
186 gchar* g_win32_getlocale(void);
189 * Precondition macros
191 #define g_warn_if_fail(x) G_STMT_START { if (!(x)) { g_warning ("%s:%d: assertion '%s' failed", __FILE__, __LINE__, #x); } } G_STMT_END
192 #define g_return_if_fail(x) G_STMT_START { if (!(x)) { g_critical ("%s:%d: assertion '%s' failed", __FILE__, __LINE__, #x); return; } } G_STMT_END
193 #define g_return_val_if_fail(x,e) G_STMT_START { if (!(x)) { g_critical ("%s:%d: assertion '%s' failed", __FILE__, __LINE__, #x); return (e); } } G_STMT_END
196 * Errors
198 typedef struct {
199 /* In the real glib, this is a GQuark, but we dont use/need that */
200 gpointer domain;
201 gint code;
202 gchar *message;
203 } GError;
205 void g_clear_error (GError **error);
206 void g_error_free (GError *error);
207 GError *g_error_new (gpointer domain, gint code, const char *format, ...);
208 void g_set_error (GError **err, gpointer domain, gint code, const gchar *format, ...);
209 void g_propagate_error (GError **dest, GError *src);
212 * Strings utility
214 gchar *g_strdup_printf (const gchar *format, ...);
215 gchar *g_strdup_vprintf (const gchar *format, va_list args);
216 gchar *g_strndup (const gchar *str, gsize n);
217 const gchar *g_strerror (gint errnum);
218 gchar *g_strndup (const gchar *str, gsize n);
219 void g_strfreev (gchar **str_array);
220 gchar *g_strconcat (const gchar *first, ...);
221 gchar **g_strsplit (const gchar *string, const gchar *delimiter, gint max_tokens);
222 gchar **g_strsplit_set (const gchar *string, const gchar *delimiter, gint max_tokens);
223 gchar *g_strreverse (gchar *str);
224 gboolean g_str_has_prefix (const gchar *str, const gchar *prefix);
225 gboolean g_str_has_suffix (const gchar *str, const gchar *suffix);
226 guint g_strv_length (gchar **str_array);
227 gchar *g_strjoin (const gchar *separator, ...);
228 gchar *g_strjoinv (const gchar *separator, gchar **str_array);
229 gchar *g_strchug (gchar *str);
230 gchar *g_strchomp (gchar *str);
231 void g_strdown (gchar *string);
232 gchar *g_strnfill (gsize length, gchar fill_char);
234 gchar *g_strdelimit (gchar *string, const gchar *delimiters, gchar new_delimiter);
235 gchar *g_strescape (const gchar *source, const gchar *exceptions);
237 gchar *g_filename_to_uri (const gchar *filename, const gchar *hostname, GError **error);
238 gchar *g_filename_from_uri (const gchar *uri, gchar **hostname, GError **error);
240 gint g_printf (gchar const *format, ...);
241 gint g_fprintf (FILE *file, gchar const *format, ...);
242 gint g_sprintf (gchar *string, gchar const *format, ...);
243 gint g_snprintf (gchar *string, gulong n, gchar const *format, ...);
244 #define g_vprintf vprintf
245 #define g_vfprintf vfprintf
246 #define g_vsprintf vsprintf
247 #define g_vsnprintf vsnprintf
248 #define g_vasprintf vasprintf
250 gsize g_strlcpy (gchar *dest, const gchar *src, gsize dest_size);
251 gchar *g_stpcpy (gchar *dest, const char *src);
254 gchar g_ascii_tolower (gchar c);
255 gchar *g_ascii_strdown (const gchar *str, gssize len);
256 gint g_ascii_strncasecmp (const gchar *s1, const gchar *s2, gsize n);
257 gint g_ascii_strcasecmp (const gchar *s1, const gchar *s2);
258 gint g_ascii_xdigit_value (gchar c);
259 #define g_ascii_isspace(c) (isspace (c) != 0)
260 #define g_ascii_isalpha(c) (isalpha (c) != 0)
261 #define g_ascii_isprint(c) (isprint (c) != 0)
262 #define g_ascii_isxdigit(c) (isxdigit (c) != 0)
264 /* FIXME: g_strcasecmp supports utf8 unicode stuff */
265 #ifdef _MSC_VER
266 #define g_strcasecmp stricmp
267 #define g_ascii_strcasecmp stricmp
268 #define g_strncasecmp strnicmp
269 #define g_strstrip(a) g_strchug (g_strchomp (a))
270 #else
271 #define g_strcasecmp strcasecmp
272 #define g_ascii_strcasecmp strcasecmp
273 #define g_ascii_strtoull strtoull
274 #define g_strncasecmp strncasecmp
275 #define g_strstrip(a) g_strchug (g_strchomp (a))
276 #endif
277 #define g_ascii_strdup strdup
280 #define G_STR_DELIMITERS "_-|> <."
283 * String type
285 typedef struct {
286 char *str;
287 gsize len;
288 gsize allocated_len;
289 } GString;
291 GString *g_string_new (const gchar *init);
292 GString *g_string_new_len (const gchar *init, gssize len);
293 GString *g_string_sized_new (gsize default_size);
294 gchar *g_string_free (GString *string, gboolean free_segment);
295 GString *g_string_append (GString *string, const gchar *val);
296 void g_string_printf (GString *string, const gchar *format, ...);
297 void g_string_append_printf (GString *string, const gchar *format, ...);
298 void g_string_append_vprintf (GString *string, const gchar *format, va_list args);
299 GString *g_string_append_unichar (GString *string, gunichar c);
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 GString *g_string_insert (GString *string, gssize pos, const gchar *val);
306 GString *g_string_set_size (GString *string, gsize len);
307 GString *g_string_erase (GString *string, gssize pos, gssize len);
309 #define g_string_sprintfa g_string_append_printf
311 typedef void (*GFunc) (gpointer data, gpointer user_data);
312 typedef gint (*GCompareFunc) (gconstpointer a, gconstpointer b);
313 typedef gint (*GCompareDataFunc) (gconstpointer a, gconstpointer b, gpointer user_data);
314 typedef void (*GHFunc) (gpointer key, gpointer value, gpointer user_data);
315 typedef gboolean (*GHRFunc) (gpointer key, gpointer value, gpointer user_data);
316 typedef void (*GDestroyNotify) (gpointer data);
317 typedef guint (*GHashFunc) (gconstpointer key);
318 typedef gboolean (*GEqualFunc) (gconstpointer a, gconstpointer b);
319 typedef void (*GFreeFunc) (gpointer data);
322 * Lists
324 typedef struct _GSList GSList;
325 struct _GSList {
326 gpointer data;
327 GSList *next;
330 GSList *g_slist_alloc (void);
331 GSList *g_slist_append (GSList *list,
332 gpointer data);
333 GSList *g_slist_prepend (GSList *list,
334 gpointer data);
335 void g_slist_free (GSList *list);
336 void g_slist_free_1 (GSList *list);
337 GSList *g_slist_copy (GSList *list);
338 GSList *g_slist_concat (GSList *list1,
339 GSList *list2);
340 void g_slist_foreach (GSList *list,
341 GFunc func,
342 gpointer user_data);
343 GSList *g_slist_last (GSList *list);
344 GSList *g_slist_find (GSList *list,
345 gconstpointer data);
346 GSList *g_slist_find_custom (GSList *list,
347 gconstpointer data,
348 GCompareFunc func);
349 GSList *g_slist_remove (GSList *list,
350 gconstpointer data);
351 GSList *g_slist_remove_all (GSList *list,
352 gconstpointer data);
353 GSList *g_slist_reverse (GSList *list);
354 guint g_slist_length (GSList *list);
355 GSList *g_slist_remove_link (GSList *list,
356 GSList *link);
357 GSList *g_slist_delete_link (GSList *list,
358 GSList *link);
359 GSList *g_slist_insert_sorted (GSList *list,
360 gpointer data,
361 GCompareFunc func);
362 GSList *g_slist_insert_before (GSList *list,
363 GSList *sibling,
364 gpointer data);
365 GSList *g_slist_sort (GSList *list,
366 GCompareFunc func);
367 gint g_slist_index (GSList *list,
368 gconstpointer data);
369 GSList *g_slist_nth (GSList *list,
370 guint n);
371 gpointer g_slist_nth_data (GSList *list,
372 guint n);
374 #define g_slist_next(slist) ((slist) ? (((GSList *) (slist))->next) : NULL)
377 typedef struct _GList GList;
378 struct _GList {
379 gpointer data;
380 GList *next;
381 GList *prev;
384 #define g_list_next(list) ((list) ? (((GList *) (list))->next) : NULL)
385 #define g_list_previous(list) ((list) ? (((GList *) (list))->prev) : NULL)
387 GList *g_list_alloc (void);
388 GList *g_list_append (GList *list,
389 gpointer data);
390 GList *g_list_prepend (GList *list,
391 gpointer data);
392 void g_list_free (GList *list);
393 void g_list_free_1 (GList *list);
394 GList *g_list_copy (GList *list);
395 guint g_list_length (GList *list);
396 gint g_list_index (GList *list,
397 gconstpointer data);
398 GList *g_list_nth (GList *list,
399 guint n);
400 gpointer g_list_nth_data (GList *list,
401 guint n);
402 GList *g_list_last (GList *list);
403 GList *g_list_concat (GList *list1,
404 GList *list2);
405 void g_list_foreach (GList *list,
406 GFunc func,
407 gpointer user_data);
408 GList *g_list_first (GList *list);
409 GList *g_list_find (GList *list,
410 gconstpointer data);
411 GList *g_list_find_custom (GList *list,
412 gconstpointer data,
413 GCompareFunc func);
414 GList *g_list_remove (GList *list,
415 gconstpointer data);
416 GList *g_list_remove_all (GList *list,
417 gconstpointer data);
418 GList *g_list_reverse (GList *list);
419 GList *g_list_remove_link (GList *list,
420 GList *link);
421 GList *g_list_delete_link (GList *list,
422 GList *link);
423 GList *g_list_insert_sorted (GList *list,
424 gpointer data,
425 GCompareFunc func);
426 GList *g_list_insert_before (GList *list,
427 GList *sibling,
428 gpointer data);
429 GList *g_list_sort (GList *sort,
430 GCompareFunc func);
433 * Hashtables
435 typedef struct _GHashTable GHashTable;
436 typedef struct _GHashTableIter GHashTableIter;
438 /* Private, but needed for stack allocation */
439 struct _GHashTableIter
441 gpointer dummy [8];
444 GHashTable *g_hash_table_new (GHashFunc hash_func, GEqualFunc key_equal_func);
445 GHashTable *g_hash_table_new_full (GHashFunc hash_func, GEqualFunc key_equal_func,
446 GDestroyNotify key_destroy_func, GDestroyNotify value_destroy_func);
447 void g_hash_table_insert_replace (GHashTable *hash, gpointer key, gpointer value, gboolean replace);
448 guint g_hash_table_size (GHashTable *hash);
449 GList *g_hash_table_get_keys (GHashTable *hash);
450 GList *g_hash_table_get_values (GHashTable *hash);
451 gpointer g_hash_table_lookup (GHashTable *hash, gconstpointer key);
452 gboolean g_hash_table_lookup_extended (GHashTable *hash, gconstpointer key, gpointer *orig_key, gpointer *value);
453 void g_hash_table_foreach (GHashTable *hash, GHFunc func, gpointer user_data);
454 gpointer g_hash_table_find (GHashTable *hash, GHRFunc predicate, gpointer user_data);
455 gboolean g_hash_table_remove (GHashTable *hash, gconstpointer key);
456 gboolean g_hash_table_steal (GHashTable *hash, gconstpointer key);
457 void g_hash_table_remove_all (GHashTable *hash);
458 guint g_hash_table_foreach_remove (GHashTable *hash, GHRFunc func, gpointer user_data);
459 guint g_hash_table_foreach_steal (GHashTable *hash, GHRFunc func, gpointer user_data);
460 void g_hash_table_destroy (GHashTable *hash);
461 void g_hash_table_print_stats (GHashTable *table);
463 void g_hash_table_iter_init (GHashTableIter *iter, GHashTable *hash_table);
464 gboolean g_hash_table_iter_next (GHashTableIter *iter, gpointer *key, gpointer *value);
466 guint g_spaced_primes_closest (guint x);
468 #define g_hash_table_insert(h,k,v) g_hash_table_insert_replace ((h),(k),(v),FALSE)
469 #define g_hash_table_replace(h,k,v) g_hash_table_insert_replace ((h),(k),(v),TRUE)
471 gboolean g_direct_equal (gconstpointer v1, gconstpointer v2);
472 guint g_direct_hash (gconstpointer v1);
473 gboolean g_int_equal (gconstpointer v1, gconstpointer v2);
474 guint g_int_hash (gconstpointer v1);
475 gboolean g_str_equal (gconstpointer v1, gconstpointer v2);
476 guint g_str_hash (gconstpointer v1);
479 * ByteArray
482 typedef struct _GByteArray GByteArray;
483 struct _GByteArray {
484 guint8 *data;
485 gint len;
488 GByteArray *g_byte_array_new (void);
489 GByteArray* g_byte_array_append (GByteArray *array, const guint8 *data, guint len);
490 guint8* g_byte_array_free (GByteArray *array, gboolean free_segment);
493 * Array
496 typedef struct _GArray GArray;
497 struct _GArray {
498 gchar *data;
499 gint len;
502 GArray *g_array_new (gboolean zero_terminated, gboolean clear_, guint element_size);
503 GArray *g_array_sized_new (gboolean zero_terminated, gboolean clear_, guint element_size, guint reserved_size);
504 gchar* g_array_free (GArray *array, gboolean free_segment);
505 GArray *g_array_append_vals (GArray *array, gconstpointer data, guint len);
506 GArray* g_array_insert_vals (GArray *array, guint index_, gconstpointer data, guint len);
507 GArray* g_array_remove_index (GArray *array, guint index_);
508 GArray* g_array_remove_index_fast (GArray *array, guint index_);
509 void g_array_set_size (GArray *array, gint length);
511 #define g_array_append_val(a,v) (g_array_append_vals((a),&(v),1))
512 #define g_array_insert_val(a,i,v) (g_array_insert_vals((a),(i),&(v),1))
513 #define g_array_index(a,t,i) *(t*)(((a)->data) + sizeof(t) * (i))
516 * QSort
519 void g_qsort_with_data (gpointer base, size_t nmemb, size_t size, GCompareDataFunc compare, gpointer user_data);
522 * Pointer Array
525 typedef struct _GPtrArray GPtrArray;
526 struct _GPtrArray {
527 gpointer *pdata;
528 guint len;
531 GPtrArray *g_ptr_array_new (void);
532 GPtrArray *g_ptr_array_sized_new (guint reserved_size);
533 void g_ptr_array_add (GPtrArray *array, gpointer data);
534 gboolean g_ptr_array_remove (GPtrArray *array, gpointer data);
535 gpointer g_ptr_array_remove_index (GPtrArray *array, guint index);
536 gboolean g_ptr_array_remove_fast (GPtrArray *array, gpointer data);
537 gpointer g_ptr_array_remove_index_fast (GPtrArray *array, guint index);
538 void g_ptr_array_sort (GPtrArray *array, GCompareFunc compare_func);
539 void g_ptr_array_sort_with_data (GPtrArray *array, GCompareDataFunc compare_func, gpointer user_data);
540 void g_ptr_array_set_size (GPtrArray *array, gint length);
541 gpointer *g_ptr_array_free (GPtrArray *array, gboolean free_seg);
542 void g_ptr_array_foreach (GPtrArray *array, GFunc func, gpointer user_data);
543 #define g_ptr_array_index(array,index) (array)->pdata[(index)]
546 * Queues
548 typedef struct {
549 GList *head;
550 GList *tail;
551 guint length;
552 } GQueue;
554 gpointer g_queue_pop_head (GQueue *queue);
555 void g_queue_push_head (GQueue *queue,
556 gpointer data);
557 void g_queue_push_tail (GQueue *queue,
558 gpointer data);
559 gboolean g_queue_is_empty (GQueue *queue);
560 GQueue *g_queue_new (void);
561 void g_queue_free (GQueue *queue);
562 void g_queue_foreach (GQueue *queue, GFunc func, gpointer user_data);
565 * Messages
567 #ifndef G_LOG_DOMAIN
568 #define G_LOG_DOMAIN ((gchar*) 0)
569 #endif
571 typedef enum {
572 G_LOG_FLAG_RECURSION = 1 << 0,
573 G_LOG_FLAG_FATAL = 1 << 1,
575 G_LOG_LEVEL_ERROR = 1 << 2,
576 G_LOG_LEVEL_CRITICAL = 1 << 3,
577 G_LOG_LEVEL_WARNING = 1 << 4,
578 G_LOG_LEVEL_MESSAGE = 1 << 5,
579 G_LOG_LEVEL_INFO = 1 << 6,
580 G_LOG_LEVEL_DEBUG = 1 << 7,
582 G_LOG_LEVEL_MASK = ~(G_LOG_FLAG_RECURSION | G_LOG_FLAG_FATAL)
583 } GLogLevelFlags;
585 void g_print (const gchar *format, ...);
586 void g_printerr (const gchar *format, ...);
587 GLogLevelFlags g_log_set_always_fatal (GLogLevelFlags fatal_mask);
588 GLogLevelFlags g_log_set_fatal_mask (const gchar *log_domain, GLogLevelFlags fatal_mask);
589 void g_logv (const gchar *log_domain, GLogLevelFlags log_level, const gchar *format, va_list args);
590 void g_log (const gchar *log_domain, GLogLevelFlags log_level, const gchar *format, ...);
591 void g_assertion_message (const gchar *format, ...) G_GNUC_NORETURN;
593 #ifdef HAVE_C99_SUPPORT
594 /* The for (;;) tells gc thats g_error () doesn't return, avoiding warnings */
595 #define g_error(format, ...) do { g_log (G_LOG_DOMAIN, G_LOG_LEVEL_ERROR, format, __VA_ARGS__); for (;;); } while (0)
596 #define g_critical(format, ...) g_log (G_LOG_DOMAIN, G_LOG_LEVEL_CRITICAL, format, __VA_ARGS__)
597 #define g_warning(format, ...) g_log (G_LOG_DOMAIN, G_LOG_LEVEL_WARNING, format, __VA_ARGS__)
598 #define g_message(format, ...) g_log (G_LOG_DOMAIN, G_LOG_LEVEL_MESSAGE, format, __VA_ARGS__)
599 #define g_debug(format, ...) g_log (G_LOG_DOMAIN, G_LOG_LEVEL_DEBUG, format, __VA_ARGS__)
600 #else /* HAVE_C99_SUPPORT */
601 #define g_error(...) do { g_log (G_LOG_DOMAIN, G_LOG_LEVEL_ERROR, __VA_ARGS__); for (;;); } while (0)
602 #define g_critical(...) g_log (G_LOG_DOMAIN, G_LOG_LEVEL_CRITICAL, __VA_ARGS__)
603 #define g_warning(...) g_log (G_LOG_DOMAIN, G_LOG_LEVEL_WARNING, __VA_ARGS__)
604 #define g_message(...) g_log (G_LOG_DOMAIN, G_LOG_LEVEL_MESSAGE, __VA_ARGS__)
605 #define g_debug(...) g_log (G_LOG_DOMAIN, G_LOG_LEVEL_DEBUG, __VA_ARGS__)
606 #endif /* ndef HAVE_C99_SUPPORT */
607 #define g_log_set_handler(a,b,c,d)
609 #define G_GNUC_INTERNAL
612 * Conversions
615 gpointer g_convert_error_quark(void);
619 * Unicode Manipulation: most of this is not used by Mono by default, it is
620 * only used if the old collation code is activated, so this is only the
621 * bare minimum to build.
624 typedef enum {
625 G_UNICODE_CONTROL,
626 G_UNICODE_FORMAT,
627 G_UNICODE_UNASSIGNED,
628 G_UNICODE_PRIVATE_USE,
629 G_UNICODE_SURROGATE,
630 G_UNICODE_LOWERCASE_LETTER,
631 G_UNICODE_MODIFIER_LETTER,
632 G_UNICODE_OTHER_LETTER,
633 G_UNICODE_TITLECASE_LETTER,
634 G_UNICODE_UPPERCASE_LETTER,
635 G_UNICODE_COMBINING_MARK,
636 G_UNICODE_ENCLOSING_MARK,
637 G_UNICODE_NON_SPACING_MARK,
638 G_UNICODE_DECIMAL_NUMBER,
639 G_UNICODE_LETTER_NUMBER,
640 G_UNICODE_OTHER_NUMBER,
641 G_UNICODE_CONNECT_PUNCTUATION,
642 G_UNICODE_DASH_PUNCTUATION,
643 G_UNICODE_CLOSE_PUNCTUATION,
644 G_UNICODE_FINAL_PUNCTUATION,
645 G_UNICODE_INITIAL_PUNCTUATION,
646 G_UNICODE_OTHER_PUNCTUATION,
647 G_UNICODE_OPEN_PUNCTUATION,
648 G_UNICODE_CURRENCY_SYMBOL,
649 G_UNICODE_MODIFIER_SYMBOL,
650 G_UNICODE_MATH_SYMBOL,
651 G_UNICODE_OTHER_SYMBOL,
652 G_UNICODE_LINE_SEPARATOR,
653 G_UNICODE_PARAGRAPH_SEPARATOR,
654 G_UNICODE_SPACE_SEPARATOR
655 } GUnicodeType;
657 typedef enum {
658 G_UNICODE_BREAK_MANDATORY,
659 G_UNICODE_BREAK_CARRIAGE_RETURN,
660 G_UNICODE_BREAK_LINE_FEED,
661 G_UNICODE_BREAK_COMBINING_MARK,
662 G_UNICODE_BREAK_SURROGATE,
663 G_UNICODE_BREAK_ZERO_WIDTH_SPACE,
664 G_UNICODE_BREAK_INSEPARABLE,
665 G_UNICODE_BREAK_NON_BREAKING_GLUE,
666 G_UNICODE_BREAK_CONTINGENT,
667 G_UNICODE_BREAK_SPACE,
668 G_UNICODE_BREAK_AFTER,
669 G_UNICODE_BREAK_BEFORE,
670 G_UNICODE_BREAK_BEFORE_AND_AFTER,
671 G_UNICODE_BREAK_HYPHEN,
672 G_UNICODE_BREAK_NON_STARTER,
673 G_UNICODE_BREAK_OPEN_PUNCTUATION,
674 G_UNICODE_BREAK_CLOSE_PUNCTUATION,
675 G_UNICODE_BREAK_QUOTATION,
676 G_UNICODE_BREAK_EXCLAMATION,
677 G_UNICODE_BREAK_IDEOGRAPHIC,
678 G_UNICODE_BREAK_NUMERIC,
679 G_UNICODE_BREAK_INFIX_SEPARATOR,
680 G_UNICODE_BREAK_SYMBOL,
681 G_UNICODE_BREAK_ALPHABETIC,
682 G_UNICODE_BREAK_PREFIX,
683 G_UNICODE_BREAK_POSTFIX,
684 G_UNICODE_BREAK_COMPLEX_CONTEXT,
685 G_UNICODE_BREAK_AMBIGUOUS,
686 G_UNICODE_BREAK_UNKNOWN,
687 G_UNICODE_BREAK_NEXT_LINE,
688 G_UNICODE_BREAK_WORD_JOINER,
689 G_UNICODE_BREAK_HANGUL_L_JAMO,
690 G_UNICODE_BREAK_HANGUL_V_JAMO,
691 G_UNICODE_BREAK_HANGUL_T_JAMO,
692 G_UNICODE_BREAK_HANGUL_LV_SYLLABLE,
693 G_UNICODE_BREAK_HANGUL_LVT_SYLLABLE
694 } GUnicodeBreakType;
696 gunichar g_unichar_toupper (gunichar c);
697 gunichar g_unichar_tolower (gunichar c);
698 gunichar g_unichar_totitle (gunichar c);
699 GUnicodeType g_unichar_type (gunichar c);
700 gboolean g_unichar_isspace (gunichar c);
701 gboolean g_unichar_isxdigit (gunichar c);
702 gint g_unichar_xdigit_value (gunichar c);
703 GUnicodeBreakType g_unichar_break_type (gunichar c);
705 #ifndef MAX
706 #define MAX(a,b) (((a)>(b)) ? (a) : (b))
707 #endif
709 #ifndef MIN
710 #define MIN(a,b) (((a)<(b)) ? (a) : (b))
711 #endif
713 #ifndef CLAMP
714 #define CLAMP(a,low,high) (((a) < (low)) ? (low) : (((a) > (high)) ? (high) : (a)))
715 #endif
717 #if defined(__GNUC__) && (__GNUC__ > 2)
718 #define G_LIKELY(expr) (__builtin_expect ((expr) != 0, 1))
719 #define G_UNLIKELY(expr) (__builtin_expect ((expr) != 0, 0))
720 #else
721 #define G_LIKELY(x) (x)
722 #define G_UNLIKELY(x) (x)
723 #endif
725 #define g_assert(x) G_STMT_START { if (G_UNLIKELY (!(x))) g_assertion_message ("* Assertion at %s:%d, condition `%s' not met\n", __FILE__, __LINE__, #x); } G_STMT_END
726 #define g_assert_not_reached() G_STMT_START { g_assertion_message ("* Assertion: should not be reached at %s:%d\n", __FILE__, __LINE__); } G_STMT_END
729 * Unicode conversion
732 #define G_CONVERT_ERROR g_convert_error_quark()
734 typedef enum {
735 G_CONVERT_ERROR_NO_CONVERSION,
736 G_CONVERT_ERROR_ILLEGAL_SEQUENCE,
737 G_CONVERT_ERROR_FAILED,
738 G_CONVERT_ERROR_PARTIAL_INPUT,
739 G_CONVERT_ERROR_BAD_URI,
740 G_CONVERT_ERROR_NOT_ABSOLUTE_PATH
741 } GConvertError;
743 gchar *g_utf8_strup (const gchar *str, gssize len);
744 gchar *g_utf8_strdown (const gchar *str, gssize len);
745 gint g_unichar_to_utf8 (gunichar c, gchar *outbuf);
746 gunichar* g_utf8_to_ucs4_fast (const gchar *str, glong len, glong *items_written);
747 gunichar2 *g_utf8_to_utf16 (const gchar *str, glong len, glong *items_read, glong *items_written, GError **error);
748 gchar *g_utf16_to_utf8 (const gunichar2 *str, glong len, glong *items_read, glong *items_written, GError **error);
749 gunichar *g_utf16_to_ucs4 (const gunichar2 *str, glong len, glong *items_read, glong *items_written, GError **error);
750 gchar *g_ucs4_to_utf8 (const gunichar *str, glong len, glong *items_read, glong *items_written, GError **error);
751 gunichar2 *g_ucs4_to_utf16 (const gunichar *str, glong len, glong *items_read, glong *items_written, GError **error);
753 #define u8to16(str) g_utf8_to_utf16(str, (glong)strlen(str), NULL, NULL, NULL)
755 #ifdef G_OS_WIN32
756 #define u16to8(str) g_utf16_to_utf8((gunichar2 *) (str), (glong)wcslen((wchar_t *) (str)), NULL, NULL, NULL)
757 #else
758 #define u16to8(str) g_utf16_to_utf8(str, (glong)strlen(str), NULL, NULL, NULL)
759 #endif
762 * Path
764 gchar *g_build_path (const gchar *separator, const gchar *first_element, ...);
765 #define g_build_filename(x, ...) g_build_path(G_DIR_SEPARATOR_S, x, __VA_ARGS__)
766 gchar *g_path_get_dirname (const gchar *filename);
767 gchar *g_path_get_basename (const char *filename);
768 gchar *g_find_program_in_path (const gchar *program);
769 gchar *g_get_current_dir (void);
770 gboolean g_path_is_absolute (const char *filename);
772 const gchar *g_get_home_dir (void);
773 const gchar *g_get_tmp_dir (void);
774 const gchar *g_get_user_name (void);
775 gchar *g_get_prgname (void);
776 void g_set_prgname (const gchar *prgname);
779 * Shell
782 gboolean g_shell_parse_argv (const gchar *command_line, gint *argcp, gchar ***argvp, GError **error);
783 gchar *g_shell_unquote (const gchar *quoted_string, GError **error);
784 gchar *g_shell_quote (const gchar *unquoted_string);
787 * Spawn
789 typedef enum {
790 G_SPAWN_LEAVE_DESCRIPTORS_OPEN = 1,
791 G_SPAWN_DO_NOT_REAP_CHILD = 1 << 1,
792 G_SPAWN_SEARCH_PATH = 1 << 2,
793 G_SPAWN_STDOUT_TO_DEV_NULL = 1 << 3,
794 G_SPAWN_STDERR_TO_DEV_NULL = 1 << 4,
795 G_SPAWN_CHILD_INHERITS_STDIN = 1 << 5,
796 G_SPAWN_FILE_AND_ARGV_ZERO = 1 << 6
797 } GSpawnFlags;
799 typedef void (*GSpawnChildSetupFunc) (gpointer user_data);
801 gboolean g_spawn_command_line_sync (const gchar *command_line, gchar **standard_output, gchar **standard_error, gint *exit_status, GError **error);
802 gboolean g_spawn_async_with_pipes (const gchar *working_directory, gchar **argv, gchar **envp, GSpawnFlags flags, GSpawnChildSetupFunc child_setup,
803 gpointer user_data, GPid *child_pid, gint *standard_input, gint *standard_output, gint *standard_error, GError **error);
807 * Timer
809 typedef struct _GTimer GTimer;
811 GTimer *g_timer_new (void);
812 void g_timer_destroy (GTimer *timer);
813 gdouble g_timer_elapsed (GTimer *timer, gulong *microseconds);
814 void g_timer_stop (GTimer *timer);
815 void g_timer_start (GTimer *timer);
818 * Date and time
820 typedef struct {
821 glong tv_sec;
822 glong tv_usec;
823 } GTimeVal;
825 void g_get_current_time (GTimeVal *result);
826 void g_usleep (gulong microseconds);
829 * File
832 gpointer g_file_error_quark (void);
834 #define G_FILE_ERROR g_file_error_quark ()
836 typedef enum {
837 G_FILE_ERROR_EXIST,
838 G_FILE_ERROR_ISDIR,
839 G_FILE_ERROR_ACCES,
840 G_FILE_ERROR_NAMETOOLONG,
841 G_FILE_ERROR_NOENT,
842 G_FILE_ERROR_NOTDIR,
843 G_FILE_ERROR_NXIO,
844 G_FILE_ERROR_NODEV,
845 G_FILE_ERROR_ROFS,
846 G_FILE_ERROR_TXTBSY,
847 G_FILE_ERROR_FAULT,
848 G_FILE_ERROR_LOOP,
849 G_FILE_ERROR_NOSPC,
850 G_FILE_ERROR_NOMEM,
851 G_FILE_ERROR_MFILE,
852 G_FILE_ERROR_NFILE,
853 G_FILE_ERROR_BADF,
854 G_FILE_ERROR_INVAL,
855 G_FILE_ERROR_PIPE,
856 G_FILE_ERROR_AGAIN,
857 G_FILE_ERROR_INTR,
858 G_FILE_ERROR_IO,
859 G_FILE_ERROR_PERM,
860 G_FILE_ERROR_NOSYS,
861 G_FILE_ERROR_FAILED
862 } GFileError;
864 typedef enum {
865 G_FILE_TEST_IS_REGULAR = 1 << 0,
866 G_FILE_TEST_IS_SYMLINK = 1 << 1,
867 G_FILE_TEST_IS_DIR = 1 << 2,
868 G_FILE_TEST_IS_EXECUTABLE = 1 << 3,
869 G_FILE_TEST_EXISTS = 1 << 4
870 } GFileTest;
873 gboolean g_file_set_contents (const gchar *filename, const gchar *contents, gssize length, GError **error);
874 gboolean g_file_get_contents (const gchar *filename, gchar **contents, gsize *length, GError **error);
875 GFileError g_file_error_from_errno (gint err_no);
876 gint g_file_open_tmp (const gchar *tmpl, gchar **name_used, GError **error);
877 gboolean g_file_test (const gchar *filename, GFileTest test);
879 #define g_open open
880 #define g_rename rename
881 #define g_stat stat
882 #define g_unlink unlink
883 #define g_fopen fopen
884 #define g_lstat lstat
885 #define g_rmdir rmdir
886 #define g_mkstemp mkstemp
887 #define g_ascii_isdigit isdigit
888 #define g_ascii_strtod strtod
889 #define g_ascii_isalnum isalnum
892 * Pattern matching
894 typedef struct _GPatternSpec GPatternSpec;
895 GPatternSpec * g_pattern_spec_new (const gchar *pattern);
896 void g_pattern_spec_free (GPatternSpec *pspec);
897 gboolean g_pattern_match_string (GPatternSpec *pspec, const gchar *string);
900 * Directory
902 typedef struct _GDir GDir;
903 GDir *g_dir_open (const gchar *path, guint flags, GError **error);
904 const gchar *g_dir_read_name (GDir *dir);
905 void g_dir_rewind (GDir *dir);
906 void g_dir_close (GDir *dir);
908 int g_mkdir_with_parents (const gchar *pathname, int mode);
909 #define g_mkdir mkdir
912 * GMarkup
914 typedef struct _GMarkupParseContext GMarkupParseContext;
916 typedef enum
918 G_MARKUP_DO_NOT_USE_THIS_UNSUPPORTED_FLAG = 1 << 0,
919 G_MARKUP_TREAT_CDATA_AS_TEXT = 1 << 1
920 } GMarkupParseFlags;
922 typedef struct {
923 void (*start_element) (GMarkupParseContext *context,
924 const gchar *element_name,
925 const gchar **attribute_names,
926 const gchar **attribute_values,
927 gpointer user_data,
928 GError **error);
930 void (*end_element) (GMarkupParseContext *context,
931 const gchar *element_name,
932 gpointer user_data,
933 GError **error);
935 void (*text) (GMarkupParseContext *context,
936 const gchar *text,
937 gsize text_len,
938 gpointer user_data,
939 GError **error);
941 void (*passthrough) (GMarkupParseContext *context,
942 const gchar *passthrough_text,
943 gsize text_len,
944 gpointer user_data,
945 GError **error);
946 void (*error) (GMarkupParseContext *context,
947 GError *error,
948 gpointer user_data);
949 } GMarkupParser;
951 GMarkupParseContext *g_markup_parse_context_new (const GMarkupParser *parser,
952 GMarkupParseFlags flags,
953 gpointer user_data,
954 GDestroyNotify user_data_dnotify);
955 void g_markup_parse_context_free (GMarkupParseContext *context);
956 gboolean g_markup_parse_context_parse (GMarkupParseContext *context,
957 const gchar *text, gssize text_len,
958 GError **error);
959 gboolean g_markup_parse_context_end_parse (GMarkupParseContext *context,
960 GError **error);
963 * Character set conversion
965 typedef struct _GIConv *GIConv;
967 gsize g_iconv (GIConv cd, gchar **inbytes, gsize *inbytesleft, gchar **outbytes, gsize *outbytesleft);
968 GIConv g_iconv_open (const gchar *to_charset, const gchar *from_charset);
969 int g_iconv_close (GIConv cd);
971 gboolean g_get_charset (G_CONST_RETURN char **charset);
972 gchar *g_locale_to_utf8 (const gchar *opsysstring, gssize len,
973 gsize *bytes_read, gsize *bytes_written,
974 GError **error);
975 gchar *g_locale_from_utf8 (const gchar *utf8string, gssize len, gsize *bytes_read,
976 gsize *bytes_written, GError **error);
977 gchar *g_filename_from_utf8 (const gchar *utf8string, gssize len, gsize *bytes_read,
978 gsize *bytes_written, GError **error);
979 gchar *g_convert (const gchar *str, gssize len,
980 const gchar *to_codeset, const gchar *from_codeset,
981 gsize *bytes_read, gsize *bytes_written, GError **error);
984 * Unicode manipulation
987 * Index into the table below with the first byte of a UTF-8 sequence to
988 * get the number of trailing bytes that are supposed to follow it.
989 * Note that *legal* UTF-8 values can't have 4 or 5-bytes. The table is
990 * left as-is for anyone who may want to do such conversion, which was
991 * allowed in earlier algorithms.
993 extern const gchar g_trailingBytesForUTF8[256];
995 gboolean g_utf8_validate (const gchar *str, gssize max_len, const gchar **end);
996 gunichar g_utf8_get_char (const gchar *src);
997 glong g_utf8_strlen (const gchar *str, gssize max);
998 #define g_utf8_next_char(p) p + (g_trailingBytesForUTF8[(guchar)(*p)] + 1)
999 gchar * g_utf8_offset_to_pointer (const gchar *str, glong offset);
1000 glong g_utf8_pointer_to_offset (const gchar *str, const gchar *pos);
1001 gchar * g_utf8_prev_char (const char *str);
1002 gchar * g_utf8_find_prev_char (const char *str, const char *p);
1005 * priorities
1007 #define G_PRIORITY_DEFAULT 0
1008 #define G_PRIORITY_DEFAULT_IDLE 200
1011 * Empty thread functions, not used by eglib
1013 #define g_thread_supported() TRUE
1014 #define g_thread_init(x) G_STMT_START { if (x != NULL) { g_error ("No vtable supported in g_thread_init"); } } G_STMT_END
1016 #define G_LOCK_DEFINE(name) int name;
1017 #define G_LOCK_DEFINE_STATIC(name) static int name;
1018 #define G_LOCK_EXTERN(name)
1019 #define G_LOCK(name)
1020 #define G_TRYLOCK(name)
1021 #define G_UNLOCK(name)
1023 #define GUINT16_SWAP_LE_BE_CONSTANT(x) ((((guint16) x) >> 8) | ((((guint16) x) << 8)))
1025 #define GUINT16_SWAP_LE_BE(x) ((guint16) (((guint16) x) >> 8) | ((((guint16)(x)) & 0xff) << 8))
1026 #define GUINT32_SWAP_LE_BE(x) ((guint32) \
1027 ( (((guint32) (x)) << 24)| \
1028 ((((guint32) (x)) & 0xff0000) >> 8) | \
1029 ((((guint32) (x)) & 0xff00) << 8) | \
1030 (((guint32) (x)) >> 24)) )
1032 #define GUINT64_SWAP_LE_BE(x) ((guint64) (((guint64)(GUINT32_SWAP_LE_BE(((guint64)x) & 0xffffffff))) << 32) | \
1033 GUINT32_SWAP_LE_BE(((guint64)x) >> 32))
1037 #if G_BYTE_ORDER == G_LITTLE_ENDIAN
1038 # define GUINT64_FROM_BE(x) GUINT64_SWAP_LE_BE(x)
1039 # define GUINT32_FROM_BE(x) GUINT32_SWAP_LE_BE(x)
1040 # define GUINT16_FROM_BE(x) GUINT16_SWAP_LE_BE(x)
1041 # define GUINT_FROM_BE(x) GUINT32_SWAP_LE_BE(x)
1042 # define GUINT64_FROM_LE(x) (x)
1043 # define GUINT32_FROM_LE(x) (x)
1044 # define GUINT16_FROM_LE(x) (x)
1045 # define GUINT_FROM_LE(x) (x)
1046 # define GUINT64_TO_BE(x) GUINT64_SWAP_LE_BE(x)
1047 # define GUINT32_TO_BE(x) GUINT32_SWAP_LE_BE(x)
1048 # define GUINT16_TO_BE(x) GUINT16_SWAP_LE_BE(x)
1049 # define GUINT_TO_BE(x) GUINT32_SWAP_LE_BE(x)
1050 # define GUINT64_TO_LE(x) (x)
1051 # define GUINT32_TO_LE(x) (x)
1052 # define GUINT16_TO_LE(x) (x)
1053 # define GUINT_TO_LE(x) (x)
1054 #else
1055 # define GUINT64_FROM_BE(x) (x)
1056 # define GUINT32_FROM_BE(x) (x)
1057 # define GUINT16_FROM_BE(x) (x)
1058 # define GUINT_FROM_BE(x) (x)
1059 # define GUINT64_FROM_LE(x) GUINT64_SWAP_LE_BE(x)
1060 # define GUINT32_FROM_LE(x) GUINT32_SWAP_LE_BE(x)
1061 # define GUINT16_FROM_LE(x) GUINT16_SWAP_LE_BE(x)
1062 # define GUINT_FROM_LE(x) GUINT32_SWAP_LE_BE(x)
1063 # define GUINT64_TO_BE(x) (x)
1064 # define GUINT32_TO_BE(x) (x)
1065 # define GUINT16_TO_BE(x) (x)
1066 # define GUINT_TO_BE(x) (x)
1067 # define GUINT64_TO_LE(x) GUINT64_SWAP_LE_BE(x)
1068 # define GUINT32_TO_LE(x) GUINT32_SWAP_LE_BE(x)
1069 # define GUINT16_TO_LE(x) GUINT16_SWAP_LE_BE(x)
1070 # define GUINT_TO_LE(x) GUINT32_SWAP_LE_BE(x)
1071 #endif
1073 #define GINT64_FROM_BE(x) (GUINT64_TO_BE (x))
1074 #define GINT32_FROM_BE(x) (GUINT32_TO_BE (x))
1075 #define GINT16_FROM_BE(x) (GUINT16_TO_BE (x))
1076 #define GINT64_FROM_LE(x) (GUINT64_TO_LE (x))
1077 #define GINT32_FROM_LE(x) (GUINT32_TO_LE (x))
1078 #define GINT16_FROM_LE(x) (GUINT16_TO_LE (x))
1080 #define _EGLIB_MAJOR 2
1081 #define _EGLIB_MIDDLE 4
1082 #define _EGLIB_MINOR 0
1084 #define GLIB_CHECK_VERSION(a,b,c) ((a < _EGLIB_MAJOR) || (a == _EGLIB_MAJOR && (b < _EGLIB_MIDDLE || (b == _EGLIB_MIDDLE && c <= _EGLIB_MINOR))))
1086 G_END_DECLS
1088 #endif