?  search:
summary | log | graphiclog1 | graphiclog2 | commit | commitdiff | tree | refs | edit | fork
blame | history | raw | HEAD
[netcore] Remove approx. 10 icalls. (#18018)
[mono-project.git] / mono / eglib / glib.h
blob29bb96be47a25ff01be93edffff980109d4c688b
1 #ifndef __GLIB_H
2 #define __GLIB_H
3
4 // Ask stdint.h and inttypes.h for the full C99 features for CentOS 6 g++ 4.4, Android, etc.
5 // See for example:
6 // $HOME/android-toolchain/toolchains/armeabi-v7a-clang/sysroot/usr/include/inttypes.h
7 // $HOME/android-toolchain/toolchains/armeabi-v7a-clang/sysroot/usr/include/stdint.h
8 #ifdef __cplusplus
9 #ifndef __STDC_LIMIT_MACROS
10 #define __STDC_LIMIT_MACROS
11 #endif
12 #ifndef __STDC_CONSTANT_MACROS
13 #define __STDC_CONSTANT_MACROS
14 #endif
15 #ifndef __STDC_FORMAT_MACROS
16 #define __STDC_FORMAT_MACROS
17 #endif
18 #endif // __cplusplus
19
20 #include <stdarg.h>
21 #include <stdlib.h>
22 #include <string.h>
23 #include <stdio.h>
24 #include <stddef.h>
25 #include <ctype.h>
26 #include <limits.h>
27 #include <stdint.h>
28 #include <inttypes.h>
29 #ifdef _MSC_VER
30 #include <eglib-config.hw>
31 #else
32 #include <eglib-config.h>
33 #endif
34
35 // - Pointers should only be converted to or from pointer-sized integers.
36 // - Any size integer can be converted to any other size integer.
37 // - Therefore a pointer-sized integer is the intermediary between
38 // a pointer and any integer type.
39 #define GPOINTER_TO_INT(ptr) ((gint)(gssize)(ptr))
40 #define GPOINTER_TO_UINT(ptr) ((guint)(gsize)(ptr))
41 #define GINT_TO_POINTER(v) ((gpointer)(gssize)(v))
42 #define GUINT_TO_POINTER(v) ((gpointer)(gsize)(v))
43
44 #ifndef EGLIB_NO_REMAP
45 #include <eglib-remap.h>
46 #endif
47
48 #ifdef G_HAVE_ALLOCA_H
49 #include <alloca.h>
50 #endif
51
52 #ifdef WIN32
53 /* For alloca */
54 #include <malloc.h>
55 #endif
56
57 #ifdef G_HAVE_UNISTD_H
58 #include <unistd.h>
59 #endif
60
61 #ifndef offsetof
62 # define offsetof(s_name,n_name) (size_t)(char *)&(((s_name*)0)->m_name)
63 #endif
64
65 #ifdef __cplusplus
66 #define G_BEGIN_DECLS extern "C" {
67 #define G_END_DECLS }
68 #define G_EXTERN_C extern "C"
69 #else
70 #define G_BEGIN_DECLS /* nothing */
71 #define G_END_DECLS /* nothing */
72 #define G_EXTERN_C /* nothing */
73 #endif
74
75 #ifdef __cplusplus
76
77 #define g_cast monoeg_g_cast // in case not inlined (see eglib-remap.h)
78
79 // g_cast converts void* to T*.
80 // e.g. #define malloc(x) (g_cast (malloc (x)))
81 // FIXME It used to do more. Rename?
82 struct g_cast
83 {
84 private:
85 void * const x;
86 public:
87 explicit g_cast (void volatile *y) : x((void*)y) { }
88 // Lack of rvalue constructor inhibits ternary operator.
89 // Either don't use ternary, or cast each side.
90 // sa = (salen <= 128) ? g_alloca (salen) : g_malloc (salen);
91 // w32socket.c:1045:24: error: call to deleted constructor of 'monoeg_g_cast'
92 //g_cast (g_cast&& y) : x(y.x) { }
93 g_cast (g_cast&&) = delete;
94 g_cast () = delete;
95 g_cast (const g_cast&) = delete;
96
97 template <typename TTo>
98 operator TTo* () const
99 {
100 return (TTo*)x;
101 }
102 };
103
104 #else
105
106 // FIXME? Parens are omitted to preserve prior meaning.
107 #define g_cast(x) x
108
109 #endif
110
111 // G++4.4 breaks opeq below without this.
112 #if defined (__GNUC__) || defined (__clang__)
113 #define G_MAY_ALIAS __attribute__((__may_alias__))
114 #else
115 #define G_MAY_ALIAS /* nothing */
116 #endif
117
118 #ifdef __cplusplus
119
120 // Provide for bit operations on enums, but not all integer operations.
121 // This alleviates a fair number of casts in porting C to C++.
122
123 // Forward declare template with no generic implementation.
124 template <size_t> struct g_size_to_int;
125
126 // Template specializations.
127 template <> struct g_size_to_int<1> { typedef int8_t type; };
128 template <> struct g_size_to_int<2> { typedef int16_t type; };
129 template <> struct g_size_to_int<4> { typedef int32_t type; };
130 template <> struct g_size_to_int<8> { typedef int64_t type; };
131
132 // g++4.4 does not accept:
133 //template <typename T>
134 //using g_size_to_int_t = typename g_size_to_int <sizeof (T)>::type;
135 #define g_size_to_int_t(x) g_size_to_int <sizeof (x)>::type
136
137 #define G_ENUM_BINOP(Enum, op, opeq) \
138 inline Enum \
139 operator op (Enum a, Enum b) \
140 { \
141 typedef g_size_to_int_t (Enum) type; \
142 return static_cast<Enum>(static_cast<type>(a) op b); \
143 } \
144 \
145 inline Enum& \
146 operator opeq (Enum& a, Enum b) \
147 { \
148 typedef g_size_to_int_t (Enum) G_MAY_ALIAS type; \
149 return (Enum&)((type&)a opeq b); \
150 } \
151
152 #define G_ENUM_FUNCTIONS(Enum) \
153 extern "C++" { /* in case within extern "C" */ \
154 inline Enum \
155 operator~ (Enum a) \
156 { \
157 typedef g_size_to_int_t (Enum) type; \
158 return static_cast<Enum>(~static_cast<type>(a)); \
159 } \
160 \
161 G_ENUM_BINOP (Enum, |, |=) \
162 G_ENUM_BINOP (Enum, &, &=) \
163 G_ENUM_BINOP (Enum, ^, ^=) \
164 \
165 } /* extern "C++" */
166
167 #else
168 #define G_ENUM_FUNCTIONS(Enum) /* nothing */
169 #endif
170
171 G_BEGIN_DECLS
172
173 /*
174 * Basic data types
175 */
176 typedef int gint;
177 typedef unsigned int guint;
178 typedef short gshort;
179 typedef unsigned short gushort;
180 typedef long glong;
181 typedef unsigned long gulong;
182 typedef void * gpointer;
183 typedef const void * gconstpointer;
184 typedef char gchar;
185 typedef unsigned char guchar;
186
187 /* Types defined in terms of the stdint.h */
188 typedef int8_t gint8;
189 typedef uint8_t guint8;
190 typedef int16_t gint16;
191 typedef uint16_t guint16;
192 typedef int32_t gint32;
193 typedef uint32_t guint32;
194 typedef int64_t gint64;
195 typedef uint64_t guint64;
196 typedef float gfloat;
197 typedef double gdouble;
198 typedef int32_t gboolean;
199
200 #if defined (HOST_WIN32) || defined (_WIN32)
201 G_END_DECLS
202 #include <wchar.h>
203 typedef wchar_t gunichar2;
204 G_BEGIN_DECLS
205 #else
206 typedef guint16 gunichar2;
207 #endif
208 typedef guint32 gunichar;
209
210 /*
211 * Macros
212 */
213 #define G_N_ELEMENTS(s) (sizeof(s) / sizeof ((s) [0]))
214
215 // e.g. strncmp (foo, G_STRING_CONSTANT_AND_LENGTH ("version"))
216 #define G_STRING_CONSTANT_AND_LENGTH(x) (x), G_N_ELEMENTS (x) - 1
217
218 #define FALSE 0
219 #define TRUE 1
220
221 #define G_MINSHORT SHRT_MIN
222 #define G_MAXSHORT SHRT_MAX
223 #define G_MAXUSHORT USHRT_MAX
224 #define G_MAXINT INT_MAX
225 #define G_MININT INT_MIN
226 #define G_MAXINT8 INT8_MAX
227 #define G_MAXUINT8 UINT8_MAX
228 #define G_MININT8 INT8_MIN
229 #define G_MAXINT16 INT16_MAX
230 #define G_MAXUINT16 UINT16_MAX
231 #define G_MININT16 INT16_MIN
232 #define G_MAXINT32 INT32_MAX
233 #define G_MAXUINT32 UINT32_MAX
234 #define G_MININT32 INT32_MIN
235 #define G_MININT64 INT64_MIN
236 #define G_MAXINT64 INT64_MAX
237 #define G_MAXUINT64 UINT64_MAX
238
239 #define G_LITTLE_ENDIAN 1234
240 #define G_BIG_ENDIAN 4321
241 #define G_STMT_START do
242 #define G_STMT_END while (0)
243
244 #define G_USEC_PER_SEC 1000000
245
246 #ifndef ABS
247 #define ABS(a) ((a) > 0 ? (a) : -(a))
248 #endif
249
250 #define ALIGN_TO(val,align) ((((gssize)val) + ((align) - 1)) & ~((align) - 1))
251
252 #define ALIGN_DOWN_TO(val,align) (((gssize)val) & ~((align) - 1))
253
254 #define ALIGN_PTR_TO(ptr,align) (gpointer)((((gssize)(ptr)) + (align - 1)) & (~(align - 1)))
255
256 #define G_STRUCT_OFFSET(p_type,field) offsetof(p_type,field)
257
258 #define EGLIB_STRINGIFY(x) #x
259 #define EGLIB_TOSTRING(x) EGLIB_STRINGIFY(x)
260 #define G_STRLOC __FILE__ ":" EGLIB_TOSTRING(__LINE__) ":"
261
262 #define G_CONST_RETURN const
263
264 #define G_GUINT64_FORMAT PRIu64
265 #define G_GINT64_FORMAT PRIi64
266 #define G_GUINT32_FORMAT PRIu32
267 #define G_GINT32_FORMAT PRIi32
268
269 #ifdef __GNUC__
270 #define G_ATTR_FORMAT_PRINTF(fmt_pos,arg_pos) __attribute__((__format__(__printf__,fmt_pos,arg_pos)))
271 #else
272 #define G_ATTR_FORMAT_PRINTF(fmt_pos,arg_pos)
273 #endif
274
275 /*
276 * Allocation
277 */
278 G_EXTERN_C // Used by MonoPosixHelper or MonoSupportW, at least.
279 void g_free (void *ptr);
280 G_EXTERN_C // Used by MonoPosixHelper or MonoSupportW, at least.
281 gpointer g_realloc (gpointer obj, gsize size);
282 G_EXTERN_C // Used by MonoPosixHelper or MonoSupportW, at least.
283 gpointer g_malloc (gsize x);
284 G_EXTERN_C // Used by MonoPosixHelper or MonoSupportW, at least.
285 gpointer g_malloc0 (gsize x);
286 G_EXTERN_C // Used by profilers, at least.
287 gpointer g_calloc (gsize n, gsize x);
288 gpointer g_try_malloc (gsize x);
289 gpointer g_try_realloc (gpointer obj, gsize size);
290
291 #define g_new(type,size) ((type *) g_malloc (sizeof (type) * (size)))
292 #define g_new0(type,size) ((type *) g_malloc0 (sizeof (type)* (size)))
293 #define g_newa(type,size) ((type *) alloca (sizeof (type) * (size)))
294
295 #define g_memmove(dest,src,len) memmove (dest, src, len)
296 #define g_renew(struct_type, mem, n_structs) ((struct_type*)g_realloc (mem, sizeof (struct_type) * n_structs))
297 #define g_alloca(size) (g_cast (alloca (size)))
298
299 G_EXTERN_C // Used by libtest, at least.
300 gpointer g_memdup (gconstpointer mem, guint byte_size);
301 static inline gchar *g_strdup (const gchar *str) { if (str) { return (gchar*) g_memdup (str, (guint)strlen (str) + 1); } return NULL; }
302 gchar **g_strdupv (gchar **str_array);
303
304 typedef struct {
305 gpointer (*malloc) (gsize n_bytes);
306 gpointer (*realloc) (gpointer mem, gsize n_bytes);
307 void (*free) (gpointer mem);
308 gpointer (*calloc) (gsize n_blocks, gsize n_block_bytes);
309 } GMemVTable;
310
311 void g_mem_set_vtable (GMemVTable* vtable);
312 void g_mem_get_vtable (GMemVTable* vtable);
313
314 struct _GMemChunk {
315 guint alloc_size;
316 };
317
318 typedef struct _GMemChunk GMemChunk;
319 /*
320 * Misc.
321 */
322
323 gboolean g_hasenv(const gchar *variable);
324 gchar * g_getenv(const gchar *variable);
325
326 G_EXTERN_C // sdks/wasm/driver.c is C and uses this
327 gboolean g_setenv(const gchar *variable, const gchar *value, gboolean overwrite);
328
329 void g_unsetenv(const gchar *variable);
330
331 gchar* g_win32_getlocale(void);
332
333 /*
334 * Precondition macros
335 */
336 #define g_warn_if_fail(x) G_STMT_START { if (!(x)) { g_warning ("%s:%d: assertion '%s' failed\n", __FILE__, __LINE__, #x); } } G_STMT_END
337 #define g_return_if_fail(x) G_STMT_START { if (!(x)) { g_critical ("%s:%d: assertion '%s' failed\n", __FILE__, __LINE__, #x); return; } } G_STMT_END
338 #define g_return_val_if_fail(x,e) G_STMT_START { if (!(x)) { g_critical ("%s:%d: assertion '%s' failed\n", __FILE__, __LINE__, #x); return (e); } } G_STMT_END
339
340 /*
341 * Errors
342 */
343 typedef struct {
344 /* In the real glib, this is a GQuark, but we dont use/need that */
345 gpointer domain;
346 gint code;
347 gchar *message;
348 } GError;
349
350 void g_clear_error (GError **gerror);
351 void g_error_free (GError *gerror);
352 GError *g_error_new (gpointer domain, gint code, const char *format, ...);
353 void g_set_error (GError **err, gpointer domain, gint code, const gchar *format, ...);
354 void g_propagate_error (GError **dest, GError *src);
355
356 /*
357 * Strings utility
358 */
359 G_EXTERN_C // Used by libtest, at least.
360 gchar *g_strdup_printf (const gchar *format, ...) G_ATTR_FORMAT_PRINTF(1, 2);
361 gchar *g_strdup_vprintf (const gchar *format, va_list args);
362 gchar *g_strndup (const gchar *str, gsize n);
363 const gchar *g_strerror (gint errnum);
364 gchar *g_strndup (const gchar *str, gsize n);
365 void g_strfreev (gchar **str_array);
366 gchar *g_strconcat (const gchar *first, ...);
367 gchar **g_strsplit (const gchar *string, const gchar *delimiter, gint max_tokens);
368 gchar **g_strsplit_set (const gchar *string, const gchar *delimiter, gint max_tokens);
369 gchar *g_strreverse (gchar *str);
370 gboolean g_str_has_prefix (const gchar *str, const gchar *prefix);
371 gboolean g_str_has_suffix (const gchar *str, const gchar *suffix);
372 guint g_strv_length (gchar **str_array);
373 gchar *g_strjoin (const gchar *separator, ...);
374 gchar *g_strjoinv (const gchar *separator, gchar **str_array);
375 gchar *g_strchug (gchar *str);
376 gchar *g_strchomp (gchar *str);
377 void g_strdown (gchar *string);
378 gchar *g_strnfill (gsize length, gchar fill_char);
379 gsize g_strnlen (const char*, gsize);
380 char *g_str_from_file_region (int fd, guint64 offset, gsize size);
381
382 void g_strdelimit (char *string, char delimiter, char new_delimiter);
383 gchar *g_strescape (const gchar *source, const gchar *exceptions);
384
385 gchar *g_filename_to_uri (const gchar *filename, const gchar *hostname, GError **gerror);
386 gchar *g_filename_from_uri (const gchar *uri, gchar **hostname, GError **gerror);
387
388 gint g_printf (gchar const *format, ...) G_ATTR_FORMAT_PRINTF(1, 2);
389 gint g_fprintf (FILE *file, gchar const *format, ...) G_ATTR_FORMAT_PRINTF(2, 3);
390 gint g_sprintf (gchar *string, gchar const *format, ...) G_ATTR_FORMAT_PRINTF(2, 3);
391 gint g_snprintf (gchar *string, gulong n, gchar const *format, ...) G_ATTR_FORMAT_PRINTF(3, 4);
392 gint g_vasprintf (gchar **ret, const gchar *fmt, va_list ap);
393 #define g_vprintf vprintf
394 #define g_vfprintf vfprintf
395 #define g_vsprintf vsprintf
396 #define g_vsnprintf vsnprintf
397
398 gsize g_strlcpy (gchar *dest, const gchar *src, gsize dest_size);
399 gchar *g_stpcpy (gchar *dest, const char *src);
400
401
402 gchar g_ascii_tolower (gchar c);
403 gchar g_ascii_toupper (gchar c);
404 gchar *g_ascii_strdown (const gchar *str, gssize len);
405 void g_ascii_strdown_no_alloc (char* dst, const char* src, gsize len);
406 gchar *g_ascii_strup (const gchar *str, gssize len);
407 gint g_ascii_strncasecmp (const gchar *s1, const gchar *s2, gsize n);
408 gint g_ascii_strcasecmp (const gchar *s1, const gchar *s2);
409 gint g_ascii_xdigit_value (gchar c);
410 #define g_ascii_isspace(c) (isspace (c) != 0)
411 #define g_ascii_isalpha(c) (isalpha (c) != 0)
412 #define g_ascii_isprint(c) (isprint (c) != 0)
413 #define g_ascii_isxdigit(c) (isxdigit (c) != 0)
414 gboolean g_utf16_ascii_equal (const gunichar2 *utf16, size_t ulen, const char *ascii, size_t alen);
415 gboolean g_utf16_asciiz_equal (const gunichar2 *utf16, const char *ascii);
416
417 static inline
418 gboolean g_ascii_equal (const char *s1, gsize len1, const char *s2, gsize len2)
419 {
420 return len1 == len2 && (s1 == s2 || memcmp (s1, s2, len1) == 0);
421 }
422
423 static inline
424 gboolean g_asciiz_equal (const char *s1, const char *s2)
425 {
426 return s1 == s2 || strcmp (s1, s2) == 0;
427 }
428
429 static inline
430 gboolean
431 g_ascii_equal_caseinsensitive (const char *s1, gsize len1, const char *s2, gsize len2)
432 {
433 return len1 == len2 && (s1 == s2 || g_ascii_strncasecmp (s1, s2, len1) == 0);
434 }
435
436 static inline
437 gboolean
438 g_asciiz_equal_caseinsensitive (const char *s1, const char *s2)
439 {
440 return s1 == s2 || g_ascii_strcasecmp (s1, s2) == 0;
441 }
442
443 /* FIXME: g_strcasecmp supports utf8 unicode stuff */
444 #ifdef _MSC_VER
445 #define g_strcasecmp _stricmp
446 #define g_strncasecmp _strnicmp
447 #define g_strstrip(a) g_strchug (g_strchomp (a))
448 #else
449 #define g_strcasecmp strcasecmp
450 #define g_ascii_strtoull strtoull
451 #define g_strncasecmp strncasecmp
452 #define g_strstrip(a) g_strchug (g_strchomp (a))
453 #endif
454 #define g_ascii_strdup strdup
455
456 /*
457 * String type
458 */
459 typedef struct {
460 char *str;
461 gsize len;
462 gsize allocated_len;
463 } GString;
464
465 GString *g_string_new (const gchar *init);
466 GString *g_string_new_len (const gchar *init, gssize len);
467 GString *g_string_sized_new (gsize default_size);
468 gchar *g_string_free (GString *string, gboolean free_segment);
469 GString *g_string_append (GString *string, const gchar *val);
470
471 void g_string_printf (GString *string, const gchar *format, ...) G_ATTR_FORMAT_PRINTF(2, 3);
472 void g_string_append_printf (GString *string, const gchar *format, ...) G_ATTR_FORMAT_PRINTF(2, 3);
473 void g_string_append_vprintf (GString *string, const gchar *format, va_list args);
474 GString *g_string_append_unichar (GString *string, gunichar c);
475 GString *g_string_append_c (GString *string, gchar c);
476 GString *g_string_append (GString *string, const gchar *val);
477 GString *g_string_append_len (GString *string, const gchar *val, gssize len);
478 GString *g_string_truncate (GString *string, gsize len);
479 GString *g_string_set_size (GString *string, gsize len);
480
481 #define g_string_sprintfa g_string_append_printf
482
483 typedef void (*GFunc) (gpointer data, gpointer user_data);
484 typedef gint (*GCompareFunc) (gconstpointer a, gconstpointer b);
485 typedef gint (*GCompareDataFunc) (gconstpointer a, gconstpointer b, gpointer user_data);
486 typedef void (*GHFunc) (gpointer key, gpointer value, gpointer user_data);
487 typedef gboolean (*GHRFunc) (gpointer key, gpointer value, gpointer user_data);
488 typedef void (*GDestroyNotify) (gpointer data);
489 typedef guint (*GHashFunc) (gconstpointer key);
490 typedef gboolean (*GEqualFunc) (gconstpointer a, gconstpointer b);
491 typedef void (*GFreeFunc) (gpointer data);
492
493 /*
494 * Lists
495 */
496 typedef struct _GSList GSList;
497 struct _GSList {
498 gpointer data;
499 GSList *next;
500 };
501
502 GSList *g_slist_alloc (void);
503 GSList *g_slist_append (GSList *list,
504 gpointer data);
505 GSList *g_slist_prepend (GSList *list,
506 gpointer data);
507 void g_slist_free (GSList *list);
508 void g_slist_free_1 (GSList *list);
509 GSList *g_slist_copy (GSList *list);
510 GSList *g_slist_concat (GSList *list1,
511 GSList *list2);
512 void g_slist_foreach (GSList *list,
513 GFunc func,
514 gpointer user_data);
515 GSList *g_slist_last (GSList *list);
516 GSList *g_slist_find (GSList *list,
517 gconstpointer data);
518 GSList *g_slist_find_custom (GSList *list,
519 gconstpointer data,
520 GCompareFunc func);
521 GSList *g_slist_remove (GSList *list,
522 gconstpointer data);
523 GSList *g_slist_remove_all (GSList *list,
524 gconstpointer data);
525 GSList *g_slist_reverse (GSList *list);
526 guint g_slist_length (GSList *list);
527 GSList *g_slist_remove_link (GSList *list,
528 GSList *link);
529 GSList *g_slist_delete_link (GSList *list,
530 GSList *link);
531 GSList *g_slist_insert_sorted (GSList *list,
532 gpointer data,
533 GCompareFunc func);
534 GSList *g_slist_insert_before (GSList *list,
535 GSList *sibling,
536 gpointer data);
537 GSList *g_slist_sort (GSList *list,
538 GCompareFunc func);
539 gint g_slist_index (GSList *list,
540 gconstpointer data);
541 GSList *g_slist_nth (GSList *list,
542 guint n);
543 gpointer g_slist_nth_data (GSList *list,
544 guint n);
545
546 #define g_slist_next(slist) ((slist) ? (((GSList *) (slist))->next) : NULL)
547
548
549 typedef struct _GList GList;
550 struct _GList {
551 gpointer data;
552 GList *next;
553 GList *prev;
554 };
555
556 #define g_list_next(list) ((list) ? (((GList *) (list))->next) : NULL)
557 #define g_list_previous(list) ((list) ? (((GList *) (list))->prev) : NULL)
558
559 GList *g_list_alloc (void);
560 GList *g_list_append (GList *list,
561 gpointer data);
562 GList *g_list_prepend (GList *list,
563 gpointer data);
564 void g_list_free (GList *list);
565 void g_list_free_1 (GList *list);
566 GList *g_list_copy (GList *list);
567 guint g_list_length (GList *list);
568 gint g_list_index (GList *list,
569 gconstpointer data);
570 GList *g_list_nth (GList *list,
571 guint n);
572 gpointer g_list_nth_data (GList *list,
573 guint n);
574 GList *g_list_last (GList *list);
575 GList *g_list_concat (GList *list1,
576 GList *list2);
577 void g_list_foreach (GList *list,
578 GFunc func,
579 gpointer user_data);
580 GList *g_list_first (GList *list);
581 GList *g_list_find (GList *list,
582 gconstpointer data);
583 GList *g_list_find_custom (GList *list,
584 gconstpointer data,
585 GCompareFunc func);
586 GList *g_list_remove (GList *list,
587 gconstpointer data);
588 GList *g_list_remove_all (GList *list,
589 gconstpointer data);
590 GList *g_list_reverse (GList *list);
591 GList *g_list_remove_link (GList *list,
592 GList *link);
593 GList *g_list_delete_link (GList *list,
594 GList *link);
595 GList *g_list_insert_sorted (GList *list,
596 gpointer data,
597 GCompareFunc func);
598 GList *g_list_insert_before (GList *list,
599 GList *sibling,
600 gpointer data);
601 GList *g_list_sort (GList *sort,
602 GCompareFunc func);
603
604 /*
605 * Hashtables
606 */
607 typedef struct _GHashTable GHashTable;
608 typedef struct _GHashTableIter GHashTableIter;
609
610 /* Private, but needed for stack allocation */
611 struct _GHashTableIter
612 {
613 gpointer dummy [8];
614 };
615
616 G_EXTERN_C // Used by MonoPosixHelper or MonoSupportW, at least.
617 GHashTable *g_hash_table_new (GHashFunc hash_func, GEqualFunc key_equal_func);
618 GHashTable *g_hash_table_new_full (GHashFunc hash_func, GEqualFunc key_equal_func,
619 GDestroyNotify key_destroy_func, GDestroyNotify value_destroy_func);
620 G_EXTERN_C // Used by MonoPosixHelper or MonoSupportW, at least.
621 void g_hash_table_insert_replace (GHashTable *hash, gpointer key, gpointer value, gboolean replace);
622 guint g_hash_table_size (GHashTable *hash);
623 GList *g_hash_table_get_keys (GHashTable *hash);
624 GList *g_hash_table_get_values (GHashTable *hash);
625 gboolean g_hash_table_contains (GHashTable *hash, gconstpointer key);
626 G_EXTERN_C // Used by MonoPosixHelper or MonoSupportW, at least.
627 gpointer g_hash_table_lookup (GHashTable *hash, gconstpointer key);
628 gboolean g_hash_table_lookup_extended (GHashTable *hash, gconstpointer key, gpointer *orig_key, gpointer *value);
629 G_EXTERN_C // Used by MonoPosixHelper or MonoSupportW, at least.
630 void g_hash_table_foreach (GHashTable *hash, GHFunc func, gpointer user_data);
631 gpointer g_hash_table_find (GHashTable *hash, GHRFunc predicate, gpointer user_data);
632 G_EXTERN_C // Used by MonoPosixHelper or MonoSupportW, at least.
633 gboolean g_hash_table_remove (GHashTable *hash, gconstpointer key);
634 gboolean g_hash_table_steal (GHashTable *hash, gconstpointer key);
635 void g_hash_table_remove_all (GHashTable *hash);
636 guint g_hash_table_foreach_remove (GHashTable *hash, GHRFunc func, gpointer user_data);
637 guint g_hash_table_foreach_steal (GHashTable *hash, GHRFunc func, gpointer user_data);
638 G_EXTERN_C // Used by MonoPosixHelper or MonoSupportW, at least.
639 void g_hash_table_destroy (GHashTable *hash);
640 void g_hash_table_print_stats (GHashTable *table);
641
642 void g_hash_table_iter_init (GHashTableIter *iter, GHashTable *hash_table);
643 gboolean g_hash_table_iter_next (GHashTableIter *iter, gpointer *key, gpointer *value);
644
645 guint g_spaced_primes_closest (guint x);
646
647 #define g_hash_table_insert(h,k,v) g_hash_table_insert_replace ((h),(k),(v),FALSE)
648 #define g_hash_table_replace(h,k,v) g_hash_table_insert_replace ((h),(k),(v),TRUE)
649 #define g_hash_table_add(h,k) g_hash_table_insert_replace ((h),(k),(k),TRUE)
650
651 G_EXTERN_C // Used by MonoPosixHelper or MonoSupportW, at least.
652 gboolean g_direct_equal (gconstpointer v1, gconstpointer v2);
653 G_EXTERN_C // Used by MonoPosixHelper or MonoSupportW, at least.
654 guint g_direct_hash (gconstpointer v1);
655 gboolean g_int_equal (gconstpointer v1, gconstpointer v2);
656 guint g_int_hash (gconstpointer v1);
657 gboolean g_str_equal (gconstpointer v1, gconstpointer v2);
658 guint g_str_hash (gconstpointer v1);
659
660 /*
661 * ByteArray
662 */
663
664 typedef struct _GByteArray GByteArray;
665 struct _GByteArray {
666 guint8 *data;
667 gint len;
668 };
669
670 GByteArray *g_byte_array_new (void);
671 GByteArray* g_byte_array_append (GByteArray *array, const guint8 *data, guint len);
672 guint8* g_byte_array_free (GByteArray *array, gboolean free_segment);
673 void g_byte_array_set_size (GByteArray *array, gint length);
674
675 /*
676 * Array
677 */
678
679 typedef struct _GArray GArray;
680 struct _GArray {
681 gchar *data;
682 gint len;
683 };
684
685 GArray *g_array_new (gboolean zero_terminated, gboolean clear_, guint element_size);
686 GArray *g_array_sized_new (gboolean zero_terminated, gboolean clear_, guint element_size, guint reserved_size);
687 gchar* g_array_free (GArray *array, gboolean free_segment);
688 GArray *g_array_append_vals (GArray *array, gconstpointer data, guint len);
689 GArray* g_array_insert_vals (GArray *array, guint index_, gconstpointer data, guint len);
690 GArray* g_array_remove_index (GArray *array, guint index_);
691 GArray* g_array_remove_index_fast (GArray *array, guint index_);
692 void g_array_set_size (GArray *array, gint length);
693
694 #define g_array_append_val(a,v) (g_array_append_vals((a),&(v),1))
695 #define g_array_insert_val(a,i,v) (g_array_insert_vals((a),(i),&(v),1))
696 #define g_array_index(a,t,i) *(t*)(((a)->data) + sizeof(t) * (i))
697 //FIXME previous missing parens
698
699 /*
700 * QSort
701 */
702
703 void g_qsort_with_data (gpointer base, size_t nmemb, size_t size, GCompareDataFunc compare, gpointer user_data);
704
705 /*
706 * Pointer Array
707 */
708
709 typedef struct _GPtrArray GPtrArray;
710 struct _GPtrArray {
711 gpointer *pdata;
712 guint len;
713 };
714
715 GPtrArray *g_ptr_array_new (void);
716 GPtrArray *g_ptr_array_sized_new (guint reserved_size);
717 void g_ptr_array_add (GPtrArray *array, gpointer data);
718 gboolean g_ptr_array_remove (GPtrArray *array, gpointer data);
719 gpointer g_ptr_array_remove_index (GPtrArray *array, guint index);
720 gboolean g_ptr_array_remove_fast (GPtrArray *array, gpointer data);
721 gpointer g_ptr_array_remove_index_fast (GPtrArray *array, guint index);
722 void g_ptr_array_sort (GPtrArray *array, GCompareFunc compare_func);
723 void g_ptr_array_sort_with_data (GPtrArray *array, GCompareDataFunc compare_func, gpointer user_data);
724 void g_ptr_array_set_size (GPtrArray *array, gint length);
725 gpointer *g_ptr_array_free (GPtrArray *array, gboolean free_seg);
726 void g_ptr_array_foreach (GPtrArray *array, GFunc func, gpointer user_data);
727 guint g_ptr_array_capacity (GPtrArray *array);
728 #define g_ptr_array_index(array,index) (array)->pdata[(index)]
729 //FIXME previous missing parens
730
731 /*
732 * Queues
733 */
734 typedef struct {
735 GList *head;
736 GList *tail;
737 guint length;
738 } GQueue;
739
740 gpointer g_queue_pop_head (GQueue *queue);
741 void g_queue_push_head (GQueue *queue,
742 gpointer data);
743 void g_queue_push_tail (GQueue *queue,
744 gpointer data);
745 gboolean g_queue_is_empty (GQueue *queue);
746 GQueue *g_queue_new (void);
747 void g_queue_free (GQueue *queue);
748 void g_queue_foreach (GQueue *queue, GFunc func, gpointer user_data);
749
750 /*
751 * Messages
752 */
753 #ifndef G_LOG_DOMAIN
754 #define G_LOG_DOMAIN ((gchar*) 0)
755 #endif
756
757 typedef enum {
758 G_LOG_FLAG_RECURSION = 1 << 0,
759 G_LOG_FLAG_FATAL = 1 << 1,
760
761 G_LOG_LEVEL_ERROR = 1 << 2,
762 G_LOG_LEVEL_CRITICAL = 1 << 3,
763 G_LOG_LEVEL_WARNING = 1 << 4,
764 G_LOG_LEVEL_MESSAGE = 1 << 5,
765 G_LOG_LEVEL_INFO = 1 << 6,
766 G_LOG_LEVEL_DEBUG = 1 << 7,
767
768 G_LOG_LEVEL_MASK = ~(G_LOG_FLAG_RECURSION | G_LOG_FLAG_FATAL)
769 } GLogLevelFlags;
770
771 G_ENUM_FUNCTIONS (GLogLevelFlags)
772
773 void g_printv (const gchar *format, va_list args);
774 void g_print (const gchar *format, ...);
775 void g_printerr (const gchar *format, ...);
776 GLogLevelFlags g_log_set_always_fatal (GLogLevelFlags fatal_mask);
777 GLogLevelFlags g_log_set_fatal_mask (const gchar *log_domain, GLogLevelFlags fatal_mask);
778 void g_logv (const gchar *log_domain, GLogLevelFlags log_level, const gchar *format, va_list args);
779 G_EXTERN_C // Used by MonoPosixHelper or MonoSupportW, at least.
780 void g_log (const gchar *log_domain, GLogLevelFlags log_level, const gchar *format, ...);
781 G_EXTERN_C // Used by MonoPosixHelper or MonoSupportW, at least.
782 void g_assertion_message (const gchar *format, ...) G_GNUC_NORETURN;
783 void mono_assertion_message_disabled (const char *file, int line) G_GNUC_NORETURN;
784 void mono_assertion_message (const char *file, int line, const char *condition) G_GNUC_NORETURN;
785 void mono_assertion_message_unreachable (const char *file, int line) G_GNUC_NORETURN;
786 const char * g_get_assertion_message (void);
787
788 #ifdef HAVE_C99_SUPPORT
789 /* The for (;;) tells gc thats g_error () doesn't return, avoiding warnings */
790 #define g_error(format, ...) do { g_log (G_LOG_DOMAIN, G_LOG_LEVEL_ERROR, format, __VA_ARGS__); for (;;); } while (0)
791 #define g_critical(format, ...) g_log (G_LOG_DOMAIN, G_LOG_LEVEL_CRITICAL, format, __VA_ARGS__)
792 #define g_warning(format, ...) g_log (G_LOG_DOMAIN, G_LOG_LEVEL_WARNING, format, __VA_ARGS__)
793 #define g_message(format, ...) g_log (G_LOG_DOMAIN, G_LOG_LEVEL_MESSAGE, format, __VA_ARGS__)
794 #define g_debug(format, ...) g_log (G_LOG_DOMAIN, G_LOG_LEVEL_DEBUG, format, __VA_ARGS__)
795 #else /* HAVE_C99_SUPPORT */
796 #define g_error(...) do { g_log (G_LOG_DOMAIN, G_LOG_LEVEL_ERROR, __VA_ARGS__); for (;;); } while (0)
797 #define g_critical(...) g_log (G_LOG_DOMAIN, G_LOG_LEVEL_CRITICAL, __VA_ARGS__)
798 #define g_warning(...) g_log (G_LOG_DOMAIN, G_LOG_LEVEL_WARNING, __VA_ARGS__)
799 #define g_message(...) g_log (G_LOG_DOMAIN, G_LOG_LEVEL_MESSAGE, __VA_ARGS__)
800 #define g_debug(...) g_log (G_LOG_DOMAIN, G_LOG_LEVEL_DEBUG, __VA_ARGS__)
801 #endif /* ndef HAVE_C99_SUPPORT */
802
803 typedef void (*GLogFunc) (const gchar *log_domain, GLogLevelFlags log_level, const gchar *message, gpointer user_data);
804 typedef void (*GPrintFunc) (const gchar *string);
805 typedef void (*GAbortFunc) (void);
806
807 void g_assertion_disable_global (GAbortFunc func);
808 void g_assert_abort (void);
809 void g_log_default_handler (const gchar *log_domain, GLogLevelFlags log_level, const gchar *message, gpointer unused_data);
810 GLogFunc g_log_set_default_handler (GLogFunc log_func, gpointer user_data);
811 GPrintFunc g_set_print_handler (GPrintFunc func);
812 GPrintFunc g_set_printerr_handler (GPrintFunc func);
813 /*
814 * Conversions
815 */
816
817 gpointer g_convert_error_quark(void);
818
819
820 /*
821 * Unicode Manipulation: most of this is not used by Mono by default, it is
822 * only used if the old collation code is activated, so this is only the
823 * bare minimum to build.
824 */
825
826 typedef enum {
827 G_UNICODE_CONTROL,
828 G_UNICODE_FORMAT,
829 G_UNICODE_UNASSIGNED,
830 G_UNICODE_PRIVATE_USE,
831 G_UNICODE_SURROGATE,
832 G_UNICODE_LOWERCASE_LETTER,
833 G_UNICODE_MODIFIER_LETTER,
834 G_UNICODE_OTHER_LETTER,
835 G_UNICODE_TITLECASE_LETTER,
836 G_UNICODE_UPPERCASE_LETTER,
837 G_UNICODE_COMBINING_MARK,
838 G_UNICODE_ENCLOSING_MARK,
839 G_UNICODE_NON_SPACING_MARK,
840 G_UNICODE_DECIMAL_NUMBER,
841 G_UNICODE_LETTER_NUMBER,
842 G_UNICODE_OTHER_NUMBER,
843 G_UNICODE_CONNECT_PUNCTUATION,
844 G_UNICODE_DASH_PUNCTUATION,
845 G_UNICODE_CLOSE_PUNCTUATION,
846 G_UNICODE_FINAL_PUNCTUATION,
847 G_UNICODE_INITIAL_PUNCTUATION,
848 G_UNICODE_OTHER_PUNCTUATION,
849 G_UNICODE_OPEN_PUNCTUATION,
850 G_UNICODE_CURRENCY_SYMBOL,
851 G_UNICODE_MODIFIER_SYMBOL,
852 G_UNICODE_MATH_SYMBOL,
853 G_UNICODE_OTHER_SYMBOL,
854 G_UNICODE_LINE_SEPARATOR,
855 G_UNICODE_PARAGRAPH_SEPARATOR,
856 G_UNICODE_SPACE_SEPARATOR
857 } GUnicodeType;
858
859 typedef enum {
860 G_UNICODE_BREAK_MANDATORY,
861 G_UNICODE_BREAK_CARRIAGE_RETURN,
862 G_UNICODE_BREAK_LINE_FEED,
863 G_UNICODE_BREAK_COMBINING_MARK,
864 G_UNICODE_BREAK_SURROGATE,
865 G_UNICODE_BREAK_ZERO_WIDTH_SPACE,
866 G_UNICODE_BREAK_INSEPARABLE,
867 G_UNICODE_BREAK_NON_BREAKING_GLUE,
868 G_UNICODE_BREAK_CONTINGENT,
869 G_UNICODE_BREAK_SPACE,
870 G_UNICODE_BREAK_AFTER,
871 G_UNICODE_BREAK_BEFORE,
872 G_UNICODE_BREAK_BEFORE_AND_AFTER,
873 G_UNICODE_BREAK_HYPHEN,
874 G_UNICODE_BREAK_NON_STARTER,
875 G_UNICODE_BREAK_OPEN_PUNCTUATION,
876 G_UNICODE_BREAK_CLOSE_PUNCTUATION,
877 G_UNICODE_BREAK_QUOTATION,
878 G_UNICODE_BREAK_EXCLAMATION,
879 G_UNICODE_BREAK_IDEOGRAPHIC,
880 G_UNICODE_BREAK_NUMERIC,
881 G_UNICODE_BREAK_INFIX_SEPARATOR,
882 G_UNICODE_BREAK_SYMBOL,
883 G_UNICODE_BREAK_ALPHABETIC,
884 G_UNICODE_BREAK_PREFIX,
885 G_UNICODE_BREAK_POSTFIX,
886 G_UNICODE_BREAK_COMPLEX_CONTEXT,
887 G_UNICODE_BREAK_AMBIGUOUS,
888 G_UNICODE_BREAK_UNKNOWN,
889 G_UNICODE_BREAK_NEXT_LINE,
890 G_UNICODE_BREAK_WORD_JOINER,
891 G_UNICODE_BREAK_HANGUL_L_JAMO,
892 G_UNICODE_BREAK_HANGUL_V_JAMO,
893 G_UNICODE_BREAK_HANGUL_T_JAMO,
894 G_UNICODE_BREAK_HANGUL_LV_SYLLABLE,
895 G_UNICODE_BREAK_HANGUL_LVT_SYLLABLE
896 } GUnicodeBreakType;
897
898 gunichar g_unichar_toupper (gunichar c);
899 gunichar g_unichar_tolower (gunichar c);
900 gunichar g_unichar_totitle (gunichar c);
901 GUnicodeType g_unichar_type (gunichar c);
902 gboolean g_unichar_isspace (gunichar c);
903 gboolean g_unichar_isxdigit (gunichar c);
904 gint g_unichar_xdigit_value (gunichar c);
905 GUnicodeBreakType g_unichar_break_type (gunichar c);
906
907 #ifndef MAX
908 #define MAX(a,b) (((a)>(b)) ? (a) : (b))
909 #endif
910
911 #ifndef MIN
912 #define MIN(a,b) (((a)<(b)) ? (a) : (b))
913 #endif
914
915 #ifndef CLAMP
916 #define CLAMP(a,low,high) (((a) < (low)) ? (low) : (((a) > (high)) ? (high) : (a)))
917 #endif
918
919 #if defined(__GNUC__) && (__GNUC__ > 2)
920 #define G_LIKELY(expr) (__builtin_expect ((expr) != 0, 1))
921 #define G_UNLIKELY(expr) (__builtin_expect ((expr) != 0, 0))
922 #else
923 #define G_LIKELY(x) (x)
924 #define G_UNLIKELY(x) (x)
925 #endif
926
927 #if defined(_MSC_VER)
928 #define eg_unreachable() __assume(0)
929 #elif defined(__GNUC__) && ((__GNUC__ > 4) || (__GNUC__ == 4 && (__GNUC_MINOR__ >= 5)))
930 #define eg_unreachable() __builtin_unreachable()
931 #else
932 #define eg_unreachable()
933 #endif
934
935 /* g_assert is a boolean expression; the precise value is not preserved, just true or false. */
936 #ifdef DISABLE_ASSERT_MESSAGES
937 // This is smaller than the equivalent mono_assertion_message (..."disabled");
938 #define g_assert(x) (G_LIKELY((x)) ? 1 : (mono_assertion_message_disabled (__FILE__, __LINE__), 0))
939 #else
940 #define g_assert(x) (G_LIKELY((x)) ? 1 : (mono_assertion_message (__FILE__, __LINE__, #x), 0))
941 #endif
942
943 #ifdef __cplusplus
944 #define g_static_assert(x) static_assert (x, "")
945 #else
946 #define g_static_assert(x) g_assert (x)
947 #endif
948
949 #define g_assert_not_reached() G_STMT_START { mono_assertion_message_unreachable (__FILE__, __LINE__); eg_unreachable(); } G_STMT_END
950
951 #if ENABLE_NETCORE
952 #define g_assert_netcore() /* nothing */
953 #define g_assert_not_netcore() g_assert (!"This function should only be called on mono-notnetcore.")
954 #else
955 #define g_assert_netcore() g_assert (!"This function should only be called on mono-netcore.")
956 #define g_assert_not_netcore() /* nothing */
957 #endif
958
959 /* f is format -- like printf and scanf
960 * Where you might have said:
961 * if (!(expr))
962 * g_error("%s invalid bar:%d", __func__, bar)
963 *
964 * You can say:
965 * g_assertf(expr, "bar:%d", bar);
966 *
967 * The usual assertion text of file/line/expr/newline are builtin, and __func__.
968 *
969 * g_assertf is a boolean expression -- the precise value is not preserved, just true or false.
970 *
971 * Other than expr, the parameters are not evaluated unless expr is false.
972 *
973 * format must be a string literal, in order to be concatenated.
974 * If this is too restrictive, g_error remains.
975 */
976 #if defined(_MSC_VER) && (_MSC_VER < 1910)
977 #define g_assertf(x, format, ...) (G_LIKELY((x)) ? 1 : (g_assertion_message ("* Assertion at %s:%d, condition `%s' not met, function:%s, " format "\n", __FILE__, __LINE__, #x, __func__, __VA_ARGS__), 0))
978 #else
979 #define g_assertf(x, format, ...) (G_LIKELY((x)) ? 1 : (g_assertion_message ("* Assertion at %s:%d, condition `%s' not met, function:%s, " format "\n", __FILE__, __LINE__, #x, __func__, ##__VA_ARGS__), 0))
980 #endif
981
982 /*
983 * Unicode conversion
984 */
985
986 #define G_CONVERT_ERROR g_convert_error_quark()
987
988 typedef enum {
989 G_CONVERT_ERROR_NO_CONVERSION,
990 G_CONVERT_ERROR_ILLEGAL_SEQUENCE,
991 G_CONVERT_ERROR_FAILED,
992 G_CONVERT_ERROR_PARTIAL_INPUT,
993 G_CONVERT_ERROR_BAD_URI,
994 G_CONVERT_ERROR_NOT_ABSOLUTE_PATH
995 } GConvertError;
996
997 gchar *g_utf8_strup (const gchar *str, gssize len);
998 gchar *g_utf8_strdown (const gchar *str, gssize len);
999 gint g_unichar_to_utf8 (gunichar c, gchar *outbuf);
1000 gunichar *g_utf8_to_ucs4_fast (const gchar *str, glong len, glong *items_written);
1001 gunichar *g_utf8_to_ucs4 (const gchar *str, glong len, glong *items_read, glong *items_written, GError **err);
1002 G_EXTERN_C // Used by libtest, at least.
1003 gunichar2 *g_utf8_to_utf16 (const gchar *str, glong len, glong *items_read, glong *items_written, GError **err);
1004 gunichar2 *eg_utf8_to_utf16_with_nuls (const gchar *str, glong len, glong *items_read, glong *items_written, GError **err);
1005 gunichar2 *eg_wtf8_to_utf16 (const gchar *str, glong len, glong *items_read, glong *items_written, GError **err);
1006 G_EXTERN_C // Used by libtest, at least.
1007 gchar *g_utf16_to_utf8 (const gunichar2 *str, glong len, glong *items_read, glong *items_written, GError **err);
1008 gunichar *g_utf16_to_ucs4 (const gunichar2 *str, glong len, glong *items_read, glong *items_written, GError **err);
1009 gchar *g_ucs4_to_utf8 (const gunichar *str, glong len, glong *items_read, glong *items_written, GError **err);
1010 gunichar2 *g_ucs4_to_utf16 (const gunichar *str, glong len, glong *items_read, glong *items_written, GError **err);
1011 size_t g_utf16_len (const gunichar2 *);
1012
1013 #define u8to16(str) g_utf8_to_utf16(str, (glong)strlen(str), NULL, NULL, NULL)
1014
1015 #ifdef G_OS_WIN32
1016 #define u16to8(str) g_utf16_to_utf8((gunichar2 *) (str), (glong)wcslen((wchar_t *) (str)), NULL, NULL, NULL)
1017 #else
1018 #define u16to8(str) g_utf16_to_utf8(str, (glong)strlen(str), NULL, NULL, NULL)
1019 #endif
1020
1021 /*
1022 * Path
1023 */
1024 gchar *g_build_path (const gchar *separator, const gchar *first_element, ...);
1025 #define g_build_filename(x, ...) g_build_path(G_DIR_SEPARATOR_S, x, __VA_ARGS__)
1026 gchar *g_path_get_dirname (const gchar *filename);
1027 gchar *g_path_get_basename (const char *filename);
1028 gchar *g_find_program_in_path (const gchar *program);
1029 gchar *g_get_current_dir (void);
1030 gboolean g_path_is_absolute (const char *filename);
1031
1032 const gchar *g_get_home_dir (void);
1033 const gchar *g_get_tmp_dir (void);
1034 const gchar *g_get_user_name (void);
1035 gchar *g_get_prgname (void);
1036 void g_set_prgname (const gchar *prgname);
1037
1038 gboolean g_ensure_directory_exists (const gchar *filename);
1039
1040 /*
1041 * Shell
1042 */
1043
1044 gboolean g_shell_parse_argv (const gchar *command_line, gint *argcp, gchar ***argvp, GError **gerror);
1045 gchar *g_shell_unquote (const gchar *quoted_string, GError **gerror);
1046 gchar *g_shell_quote (const gchar *unquoted_string);
1047
1048 /*
1049 * Spawn
1050 */
1051 typedef enum {
1052 G_SPAWN_LEAVE_DESCRIPTORS_OPEN = 1,
1053 G_SPAWN_DO_NOT_REAP_CHILD = 1 << 1,
1054 G_SPAWN_SEARCH_PATH = 1 << 2,
1055 G_SPAWN_STDOUT_TO_DEV_NULL = 1 << 3,
1056 G_SPAWN_STDERR_TO_DEV_NULL = 1 << 4,
1057 G_SPAWN_CHILD_INHERITS_STDIN = 1 << 5,
1058 G_SPAWN_FILE_AND_ARGV_ZERO = 1 << 6
1059 } GSpawnFlags;
1060
1061 typedef void (*GSpawnChildSetupFunc) (gpointer user_data);
1062
1063 gboolean g_spawn_command_line_sync (const gchar *command_line, gchar **standard_output, gchar **standard_error, gint *exit_status, GError **gerror);
1064 gboolean g_spawn_async_with_pipes (const gchar *working_directory, gchar **argv, gchar **envp, GSpawnFlags flags, GSpawnChildSetupFunc child_setup,
1065 gpointer user_data, GPid *child_pid, gint *standard_input, gint *standard_output, gint *standard_error, GError **gerror);
1066
1067 int eg_getdtablesize (void);
1068
1069 /*
1070 * Timer
1071 */
1072 typedef struct _GTimer GTimer;
1073
1074 GTimer *g_timer_new (void);
1075 void g_timer_destroy (GTimer *timer);
1076 gdouble g_timer_elapsed (GTimer *timer, gulong *microseconds);
1077 void g_timer_stop (GTimer *timer);
1078 void g_timer_start (GTimer *timer);
1079
1080 /*
1081 * Date and time
1082 */
1083 typedef struct {
1084 glong tv_sec;
1085 glong tv_usec;
1086 } GTimeVal;
1087
1088 void g_get_current_time (GTimeVal *result);
1089 void g_usleep (gulong microseconds);
1090
1091 /*
1092 * File
1093 */
1094
1095 gpointer g_file_error_quark (void);
1096
1097 #define G_FILE_ERROR g_file_error_quark ()
1098
1099 typedef enum {
1100 G_FILE_ERROR_EXIST,
1101 G_FILE_ERROR_ISDIR,
1102 G_FILE_ERROR_ACCES,
1103 G_FILE_ERROR_NAMETOOLONG,
1104 G_FILE_ERROR_NOENT,
1105 G_FILE_ERROR_NOTDIR,
1106 G_FILE_ERROR_NXIO,
1107 G_FILE_ERROR_NODEV,
1108 G_FILE_ERROR_ROFS,
1109 G_FILE_ERROR_TXTBSY,
1110 G_FILE_ERROR_FAULT,
1111 G_FILE_ERROR_LOOP,
1112 G_FILE_ERROR_NOSPC,
1113 G_FILE_ERROR_NOMEM,
1114 G_FILE_ERROR_MFILE,
1115 G_FILE_ERROR_NFILE,
1116 G_FILE_ERROR_BADF,
1117 G_FILE_ERROR_INVAL,
1118 G_FILE_ERROR_PIPE,
1119 G_FILE_ERROR_AGAIN,
1120 G_FILE_ERROR_INTR,
1121 G_FILE_ERROR_IO,
1122 G_FILE_ERROR_PERM,
1123 G_FILE_ERROR_NOSYS,
1124 G_FILE_ERROR_FAILED
1125 } GFileError;
1126
1127 typedef enum {
1128 G_FILE_TEST_IS_REGULAR = 1 << 0,
1129 G_FILE_TEST_IS_SYMLINK = 1 << 1,
1130 G_FILE_TEST_IS_DIR = 1 << 2,
1131 G_FILE_TEST_IS_EXECUTABLE = 1 << 3,
1132 G_FILE_TEST_EXISTS = 1 << 4
1133 } GFileTest;
1134
1135 G_ENUM_FUNCTIONS (GFileTest)
1136
1137 gboolean g_file_set_contents (const gchar *filename, const gchar *contents, gssize length, GError **gerror);
1138 gboolean g_file_get_contents (const gchar *filename, gchar **contents, gsize *length, GError **gerror);
1139 GFileError g_file_error_from_errno (gint err_no);
1140 gint g_file_open_tmp (const gchar *tmpl, gchar **name_used, GError **gerror);
1141 gboolean g_file_test (const gchar *filename, GFileTest test);
1142
1143 #ifdef G_OS_WIN32
1144 #define g_open _open
1145 #else
1146 #define g_open open
1147 #endif
1148 #define g_rename rename
1149 #define g_stat stat
1150 #ifdef G_OS_WIN32
1151 #define g_access _access
1152 #else
1153 #define g_access access
1154 #endif
1155 #ifdef G_OS_WIN32
1156 #define g_mktemp _mktemp
1157 #else
1158 #define g_mktemp mktemp
1159 #endif
1160 #ifdef G_OS_WIN32
1161 #define g_unlink _unlink
1162 #else
1163 #define g_unlink unlink
1164 #endif
1165 #ifdef G_OS_WIN32
1166 #define g_write _write
1167 #else
1168 #define g_write write
1169 #endif
1170 #ifdef G_OS_WIN32
1171 #define g_read _read
1172 #else
1173 #define g_read read
1174 #endif
1175
1176 #define g_fopen fopen
1177 #define g_lstat lstat
1178 #define g_rmdir rmdir
1179 #define g_mkstemp mkstemp
1180 #define g_ascii_isdigit isdigit
1181 #define g_ascii_strtod strtod
1182 #define g_ascii_isalnum isalnum
1183
1184 gchar *g_mkdtemp (gchar *tmpl);
1185
1186 /*
1187 * Low-level write-based printing functions
1188 */
1189
1190 static inline int
1191 g_async_safe_fgets (char *str, int num, int handle, gboolean *newline)
1192 {
1193 memset (str, 0, num);
1194 // Make sure we don't overwrite the last index so that we are
1195 // guaranteed to be NULL-terminated
1196 int without_padding = num - 1;
1197 int i=0;
1198 while (i < without_padding && g_read (handle, &str [i], sizeof(char))) {
1199 if (str [i] == '\n') {
1200 str [i] = '\0';
1201 *newline = TRUE;
1202 }
1203
1204 if (!isprint (str [i]))
1205 str [i] = '\0';
1206
1207 if (str [i] == '\0')
1208 break;
1209
1210 i++;
1211 }
1212
1213 return i;
1214 }
1215
1216 static inline gint
1217 g_async_safe_vfprintf (int handle, gchar const *format, va_list args)
1218 {
1219 char print_buff [1024];
1220 print_buff [0] = '\0';
1221 g_vsnprintf (print_buff, sizeof(print_buff), format, args);
1222 int ret = g_write (handle, print_buff, (guint32) strlen (print_buff));
1223
1224 return ret;
1225 }
1226
1227 static inline gint
1228 g_async_safe_fprintf (int handle, gchar const *format, ...)
1229 {
1230 va_list args;
1231 va_start (args, format);
1232 int ret = g_async_safe_vfprintf (handle, format, args);
1233 va_end (args);
1234 return ret;
1235 }
1236
1237 static inline gint
1238 g_async_safe_vprintf (gchar const *format, va_list args)
1239 {
1240 return g_async_safe_vfprintf (1, format, args);
1241 }
1242
1243 static inline gint
1244 g_async_safe_printf (gchar const *format, ...)
1245 {
1246 va_list args;
1247 va_start (args, format);
1248 int ret = g_async_safe_vfprintf (1, format, args);
1249 va_end (args);
1250
1251 return ret;
1252 }
1253
1254
1255 /*
1256 * Pattern matching
1257 */
1258 typedef struct _GPatternSpec GPatternSpec;
1259 GPatternSpec * g_pattern_spec_new (const gchar *pattern);
1260 void g_pattern_spec_free (GPatternSpec *pspec);
1261 gboolean g_pattern_match_string (GPatternSpec *pspec, const gchar *string);
1262
1263 /*
1264 * Directory
1265 */
1266 typedef struct _GDir GDir;
1267 GDir *g_dir_open (const gchar *path, guint flags, GError **gerror);
1268 const gchar *g_dir_read_name (GDir *dir);
1269 void g_dir_rewind (GDir *dir);
1270 void g_dir_close (GDir *dir);
1271
1272 int g_mkdir_with_parents (const gchar *pathname, int mode);
1273 #define g_mkdir mkdir
1274
1275 /*
1276 * GMarkup
1277 */
1278 typedef struct _GMarkupParseContext GMarkupParseContext;
1279
1280 typedef enum
1281 {
1282 G_MARKUP_DO_NOT_USE_THIS_UNSUPPORTED_FLAG = 1 << 0,
1283 G_MARKUP_TREAT_CDATA_AS_TEXT = 1 << 1
1284 } GMarkupParseFlags;
1285
1286 typedef struct {
1287 void (*start_element) (GMarkupParseContext *context,
1288 const gchar *element_name,
1289 const gchar **attribute_names,
1290 const gchar **attribute_values,
1291 gpointer user_data,
1292 GError **gerror);
1293
1294 void (*end_element) (GMarkupParseContext *context,
1295 const gchar *element_name,
1296 gpointer user_data,
1297 GError **gerror);
1298
1299 void (*text) (GMarkupParseContext *context,
1300 const gchar *text,
1301 gsize text_len,
1302 gpointer user_data,
1303 GError **gerror);
1304
1305 void (*passthrough) (GMarkupParseContext *context,
1306 const gchar *passthrough_text,
1307 gsize text_len,
1308 gpointer user_data,
1309 GError **gerror);
1310 void (*error) (GMarkupParseContext *context,
1311 GError *gerror,
1312 gpointer user_data);
1313 } GMarkupParser;
1314
1315 GMarkupParseContext *g_markup_parse_context_new (const GMarkupParser *parser,
1316 GMarkupParseFlags flags,
1317 gpointer user_data,
1318 GDestroyNotify user_data_dnotify);
1319 void g_markup_parse_context_free (GMarkupParseContext *context);
1320 gboolean g_markup_parse_context_parse (GMarkupParseContext *context,
1321 const gchar *text, gssize text_len,
1322 GError **gerror);
1323 gboolean g_markup_parse_context_end_parse (GMarkupParseContext *context,
1324 GError **gerror);
1325
1326 /*
1327 * Character set conversion
1328 */
1329 typedef struct _GIConv *GIConv;
1330
1331 gsize g_iconv (GIConv cd, gchar **inbytes, gsize *inbytesleft, gchar **outbytes, gsize *outbytesleft);
1332 GIConv g_iconv_open (const gchar *to_charset, const gchar *from_charset);
1333 int g_iconv_close (GIConv cd);
1334
1335 gboolean g_get_charset (G_CONST_RETURN char **charset);
1336 gchar *g_locale_to_utf8 (const gchar *opsysstring, gssize len,
1337 gsize *bytes_read, gsize *bytes_written,
1338 GError **gerror);
1339 gchar *g_locale_from_utf8 (const gchar *utf8string, gssize len, gsize *bytes_read,
1340 gsize *bytes_written, GError **gerror);
1341 gchar *g_filename_from_utf8 (const gchar *utf8string, gssize len, gsize *bytes_read,
1342 gsize *bytes_written, GError **gerror);
1343 gchar *g_convert (const gchar *str, gssize len,
1344 const gchar *to_codeset, const gchar *from_codeset,
1345 gsize *bytes_read, gsize *bytes_written, GError **gerror);
1346
1347 /*
1348 * Unicode manipulation
1349 */
1350 extern const guchar g_utf8_jump_table[256];
1351
1352 gboolean g_utf8_validate (const gchar *str, gssize max_len, const gchar **end);
1353 gunichar g_utf8_get_char_validated (const gchar *str, gssize max_len);
1354 #define g_utf8_next_char(p) ((p) + g_utf8_jump_table[(guchar)(*p)])
1355 gunichar g_utf8_get_char (const gchar *src);
1356 glong g_utf8_strlen (const gchar *str, gssize max);
1357 gchar *g_utf8_offset_to_pointer (const gchar *str, glong offset);
1358 glong g_utf8_pointer_to_offset (const gchar *str, const gchar *pos);
1359
1360 /*
1361 * priorities
1362 */
1363 #define G_PRIORITY_DEFAULT 0
1364 #define G_PRIORITY_DEFAULT_IDLE 200
1365
1366 #define GUINT16_SWAP_LE_BE_CONSTANT(x) ((((guint16) x) >> 8) | ((((guint16) x) << 8)))
1367
1368 #define GUINT16_SWAP_LE_BE(x) ((guint16) (((guint16) x) >> 8) | ((((guint16)(x)) & 0xff) << 8))
1369 #define GUINT32_SWAP_LE_BE(x) ((guint32) \
1370 ( (((guint32) (x)) << 24)| \
1371 ((((guint32) (x)) & 0xff0000) >> 8) | \
1372 ((((guint32) (x)) & 0xff00) << 8) | \
1373 (((guint32) (x)) >> 24)) )
1374
1375 #define GUINT64_SWAP_LE_BE(x) ((guint64) (((guint64)(GUINT32_SWAP_LE_BE(((guint64)x) & 0xffffffff))) << 32) | \
1376 GUINT32_SWAP_LE_BE(((guint64)x) >> 32))
1377
1378
1379
1380 #if G_BYTE_ORDER == G_LITTLE_ENDIAN
1381 # define GUINT64_FROM_BE(x) GUINT64_SWAP_LE_BE(x)
1382 # define GUINT32_FROM_BE(x) GUINT32_SWAP_LE_BE(x)
1383 # define GUINT16_FROM_BE(x) GUINT16_SWAP_LE_BE(x)
1384 # define GUINT_FROM_BE(x) GUINT32_SWAP_LE_BE(x)
1385 # define GUINT64_FROM_LE(x) (x)
1386 # define GUINT32_FROM_LE(x) (x)
1387 # define GUINT16_FROM_LE(x) (x)
1388 # define GUINT_FROM_LE(x) (x)
1389 # define GUINT64_TO_BE(x) GUINT64_SWAP_LE_BE(x)
1390 # define GUINT32_TO_BE(x) GUINT32_SWAP_LE_BE(x)
1391 # define GUINT16_TO_BE(x) GUINT16_SWAP_LE_BE(x)
1392 # define GUINT_TO_BE(x) GUINT32_SWAP_LE_BE(x)
1393 # define GUINT64_TO_LE(x) (x)
1394 # define GUINT32_TO_LE(x) (x)
1395 # define GUINT16_TO_LE(x) (x)
1396 # define GUINT_TO_LE(x) (x)
1397 #else
1398 # define GUINT64_FROM_BE(x) (x)
1399 # define GUINT32_FROM_BE(x) (x)
1400 # define GUINT16_FROM_BE(x) (x)
1401 # define GUINT_FROM_BE(x) (x)
1402 # define GUINT64_FROM_LE(x) GUINT64_SWAP_LE_BE(x)
1403 # define GUINT32_FROM_LE(x) GUINT32_SWAP_LE_BE(x)
1404 # define GUINT16_FROM_LE(x) GUINT16_SWAP_LE_BE(x)
1405 # define GUINT_FROM_LE(x) GUINT32_SWAP_LE_BE(x)
1406 # define GUINT64_TO_BE(x) (x)
1407 # define GUINT32_TO_BE(x) (x)
1408 # define GUINT16_TO_BE(x) (x)
1409 # define GUINT_TO_BE(x) (x)
1410 # define GUINT64_TO_LE(x) GUINT64_SWAP_LE_BE(x)
1411 # define GUINT32_TO_LE(x) GUINT32_SWAP_LE_BE(x)
1412 # define GUINT16_TO_LE(x) GUINT16_SWAP_LE_BE(x)
1413 # define GUINT_TO_LE(x) GUINT32_SWAP_LE_BE(x)
1414 #endif
1415
1416 #define GINT64_FROM_BE(x) (GUINT64_TO_BE (x))
1417 #define GINT32_FROM_BE(x) (GUINT32_TO_BE (x))
1418 #define GINT16_FROM_BE(x) (GUINT16_TO_BE (x))
1419 #define GINT64_FROM_LE(x) (GUINT64_TO_LE (x))
1420 #define GINT32_FROM_LE(x) (GUINT32_TO_LE (x))
1421 #define GINT16_FROM_LE(x) (GUINT16_TO_LE (x))
1422
1423 #define _EGLIB_MAJOR 2
1424 #define _EGLIB_MIDDLE 4
1425 #define _EGLIB_MINOR 0
1426
1427 #define GLIB_CHECK_VERSION(a,b,c) ((a < _EGLIB_MAJOR) || (a == _EGLIB_MAJOR && (b < _EGLIB_MIDDLE || (b == _EGLIB_MIDDLE && c <= _EGLIB_MINOR))))
1428
1429 #define G_HAVE_API_SUPPORT(x) (x)
1430 #define G_UNSUPPORTED_API "%s:%d: '%s' not supported.", __FILE__, __LINE__
1431 #define g_unsupported_api(name) G_STMT_START { g_warning (G_UNSUPPORTED_API, name); } G_STMT_END
1432
1433 #if _WIN32
1434 // g_free the result
1435 // No MAX_PATH limit.
1436 gboolean
1437 mono_get_module_filename (gpointer mod, gunichar2 **pstr, guint32 *plength);
1438
1439 // g_free the result
1440 // No MAX_PATH limit.
1441 gboolean
1442 mono_get_module_filename_ex (gpointer process, gpointer mod, gunichar2 **pstr, guint32 *plength);
1443
1444 // g_free the result
1445 // No MAX_PATH limit.
1446 gboolean
1447 mono_get_module_basename (gpointer process, gpointer mod, gunichar2 **pstr, guint32 *plength);
1448
1449 // g_free the result
1450 // No MAX_PATH limit.
1451 gboolean
1452 mono_get_current_directory (gunichar2 **pstr, guint32 *plength);
1453 #endif
1454
1455 G_END_DECLS // FIXME: There is more extern C than there should be.
1456
1457 static inline
1458 void
1459 mono_qsort (void* base, size_t num, size_t size, int (*compare)(const void*, const void*))
1460 {
1461 g_assert (compare);
1462 g_assert (size);
1463 if (num < 2 || !size || !base)
1464 return;
1465 qsort (base, num, size, compare);
1466 }
1467
1468 #define MONO_DECL_CALLBACK(prefix, ret, name, sig) ret (*name) sig;
1469 #define MONO_INIT_CALLBACK(prefix, ret, name, sig) prefix ## _ ## name,
1470
1471 // For each allocator; i.e. returning gpointer that needs to be cast.
1472 // Macros do not recurse, so naming function and macro the same is ok.
1473 // However these are also already macros.
1474 #undef g_malloc
1475 #undef g_realloc
1476 #undef g_malloc0
1477 #undef g_calloc
1478 #undef g_try_malloc
1479 #undef g_try_realloc
1480 #undef g_memdup
1481 #define g_malloc(x) (g_cast (monoeg_malloc (x)))
1482 #define g_realloc(obj, size) (g_cast (monoeg_realloc ((obj), (size))))
1483 #define g_malloc0(x) (g_cast (monoeg_malloc0 (x)))
1484 #define g_calloc(x, y) (g_cast (monoeg_g_calloc ((x), (y))))
1485 #define g_try_malloc(x) (g_cast (monoeg_try_malloc (x)))
1486 #define g_try_realloc(obj, size) (g_cast (monoeg_try_realloc ((obj), (size))))
1487 #define g_memdup(mem, size) (g_cast (monoeg_g_memdup ((mem), (size))))
1488
1489 #endif // __GLIB_H
Mirror of the official Mono project git repository