diff options
Diffstat (limited to 'vapi/glib-2.0.vapi')
-rw-r--r-- | vapi/glib-2.0.vapi | 623 |
1 files changed, 522 insertions, 101 deletions
diff --git a/vapi/glib-2.0.vapi b/vapi/glib-2.0.vapi index af183d685..b240b6b4d 100644 --- a/vapi/glib-2.0.vapi +++ b/vapi/glib-2.0.vapi @@ -301,11 +301,14 @@ public struct ulong { public struct size_t { [CCode (cname = "0UL")] public const ulong MIN; + [Version (since = "2.4")] [CCode (cname = "G_MAXSIZE")] public const ulong MAX; + [Version (since = "2.6")] [CCode (cname = "G_GSIZE_FORMAT")] public const string FORMAT; + [Version (since = "2.6")] [CCode (cname = "G_GSIZE_MODIFIER")] public const string FORMAT_MODIFIER; @@ -328,11 +331,14 @@ public struct size_t { [CCode (cname = "gssize", cheader_filename = "glib.h", type_id = "G_TYPE_LONG", marshaller_type_name = "LONG", get_value_function = "g_value_get_long", set_value_function = "g_value_set_long", default_value = "0L")] [IntegerType (rank = 8)] public struct ssize_t { + [Version (since = "2.14")] [CCode (cname = "G_MINSSIZE")] public const long MIN; + [Version (since = "2.14")] [CCode (cname = "G_MAXSSIZE")] public const long MAX; + [Version (since = "2.6")] [CCode (cname = "G_GSSIZE_FORMAT")] public const string FORMAT; [CCode (cname = "G_GSIZE_MODIFIER")] @@ -350,12 +356,69 @@ public struct ssize_t { } [SimpleType] +[GIR (name = "gulong")] +[CCode (cname = "guintptr", cheader_filename = "glib.h", type_id = "G_TYPE_ULONG", marshaller_type_name = "ULONG", get_value_function = "g_value_get_ulong", set_value_function = "g_value_set_ulong", default_value = "0UL")] +[IntegerType (rank = 9)] +public struct uintptr { + [CCode (cname = "0UL")] + public const ulong MIN; + [CCode (cname = "G_MAXSIZE")] + public const ulong MAX; + + [CCode (cname = "G_GUINTPTR_FORMAT")] + public const string FORMAT; + [CCode (cname = "G_GINTPTR_MODIFIER")] + public const string FORMAT_MODIFIER; + + [CCode (cname = "g_strdup_printf", instance_pos = -1)] + public string to_string (string format = "%" + FORMAT); + + [CCode (cname = "GSIZE_TO_POINTER")] + public void* to_pointer (); + + [CCode (cname = "MIN")] + public static uintptr min (uintptr a, uintptr b); + [CCode (cname = "MAX")] + public static uintptr max (uintptr a, uintptr b); + [CCode (cname = "CLAMP")] + public uintptr clamp (uintptr low, uintptr high); +} + +[SimpleType] +[GIR (name = "glong")] +[CCode (cname = "gintptr", cheader_filename = "glib.h", type_id = "G_TYPE_LONG", marshaller_type_name = "LONG", get_value_function = "g_value_get_long", set_value_function = "g_value_set_long", default_value = "0L")] +[IntegerType (rank = 8)] +public struct intptr { + [CCode (cname = "G_MINSSIZE")] + public const long MIN; + [CCode (cname = "G_MAXSSIZE")] + public const long MAX; + + [CCode (cname = "G_GINTPTR_FORMAT")] + public const string FORMAT; + [CCode (cname = "G_GINTPTR_MODIFIER")] + public const string FORMAT_MODIFIER; + + [CCode (cname = "g_strdup_printf", instance_pos = -1)] + public string to_string (string format = "%" + FORMAT); + + [CCode (cname = "MIN")] + public static intptr min (intptr a, intptr b); + [CCode (cname = "MAX")] + public static intptr max (intptr a, intptr b); + [CCode (cname = "CLAMP")] + public intptr clamp (intptr low, intptr high); +} + +[SimpleType] [GIR (name = "gint8")] [CCode (cname = "gint8", cheader_filename = "glib.h", type_id = "G_TYPE_CHAR", marshaller_type_name = "CHAR", get_value_function = "g_value_get_char", set_value_function = "g_value_set_char", default_value = "0", type_signature = "y")] [IntegerType (rank = 1, min = -128, max = 127)] public struct int8 { + [Version (since = "2.4")] [CCode (cname = "G_MININT8")] public const int8 MIN; + [Version (since = "2.4")] [CCode (cname = "G_MAXINT8")] public const int8 MAX; @@ -377,6 +440,7 @@ public struct int8 { public struct uint8 { [CCode (cname = "0U")] public const uint8 MIN; + [Version (since = "2.4")] [CCode (cname = "G_MAXUINT8")] public const uint8 MAX; @@ -396,13 +460,16 @@ public struct uint8 { [CCode (cname = "gint16", cheader_filename = "glib.h", default_value = "0", type_signature = "n", has_type_id = false)] [IntegerType (rank = 4, min = -32768, max = 32767)] public struct int16 { + [Version (since = "2.4")] [CCode (cname = "G_MININT16")] public const int16 MIN; + [Version (since = "2.4")] [CCode (cname = "G_MAXINT16")] public const int16 MAX; [CCode (cname = "G_GINT16_FORMAT")] public const string FORMAT; + [Version (since = "2.4")] [CCode (cname = "G_GINT16_MODIFIER")] public const string FORMAT_MODIFIER; @@ -434,6 +501,7 @@ public struct int16 { public struct uint16 { [CCode (cname = "0U")] public const uint16 MIN; + [Version (since = "2.4")] [CCode (cname = "G_MAXUINT16")] public const uint16 MAX; @@ -480,13 +548,16 @@ public struct uint16 { [CCode (cname = "gint32", cheader_filename = "glib.h", type_id = "G_TYPE_INT", marshaller_type_name = "INT", get_value_function = "g_value_get_int", set_value_function = "g_value_set_int", default_value = "0", type_signature = "i")] [IntegerType (rank = 6)] public struct int32 { + [Version (since = "2.4")] [CCode (cname = "G_MININT32")] public const int32 MIN; + [Version (since = "2.4")] [CCode (cname = "G_MAXINT32")] public const int32 MAX; [CCode (cname = "G_GINT32_FORMAT")] public const string FORMAT; + [Version (since = "2.4")] [CCode (cname = "G_GINT32_MODIFIER")] public const string FORMAT_MODIFIER; @@ -518,6 +589,7 @@ public struct int32 { public struct uint32 { [CCode (cname = "0U")] public const uint32 MIN; + [Version (since = "2.4")] [CCode (cname = "G_MAXUINT32")] public const uint32 MAX; @@ -571,6 +643,7 @@ public struct int64 { [CCode (cname = "G_GINT64_FORMAT")] public const string FORMAT; + [Version (since = "2.4")] [CCode (cname = "G_GINT64_MODIFIER")] public const string FORMAT_MODIFIER; @@ -602,9 +675,12 @@ public struct int64 { [CCode (cname = "g_ascii_strtoll")] static int64 ascii_strtoll (string nptr, out char* endptr, uint _base); + [Version (since = "2.12")] public static int64 parse (string str) { return ascii_strtoll (str, null, 0); } + + [Version (since = "2.12")] public static bool try_parse (string str, out int64 result = null) { char* endptr; result = ascii_strtoll (str, out endptr, 0); @@ -831,6 +907,7 @@ public struct unichar { public bool isdigit (); public bool isgraph (); public bool islower (); + [Version (since = "2.14")] public bool ismark (); public bool isprint (); public bool ispunct (); @@ -840,7 +917,9 @@ public struct unichar { public bool istitle (); public bool isdefined (); public bool iswide (); + [Version (since = "2.12")] public bool iswide_cjk (); + [Version (since = "2.14")] public bool iszerowidth (); public unichar toupper (); public unichar tolower (); @@ -849,6 +928,7 @@ public struct unichar { public int xdigit_value (); public GLib.UnicodeType type (); public GLib.UnicodeBreakType break_type (); + [Version (since = "2.14")] public GLib.UnicodeScript get_script(); public int to_utf8 (string? outbuf); @@ -859,8 +939,11 @@ public struct unichar { return str; } + [Version (since = "2.30")] public bool compose (unichar b, out unichar ch); + [Version (since = "2.30")] public bool decompose (out unichar a, out unichar b); + [Version (since = "2.30")] public size_t fully_decompose (bool compat, unichar[] result); [CCode (cname = "MIN")] @@ -879,10 +962,10 @@ public struct unichar { [GIR (name = "utf8")] [CCode (cname = "gchar", const_cname = "const gchar", copy_function = "g_strdup", free_function = "g_free", cheader_filename = "stdlib.h,string.h,glib.h", type_id = "G_TYPE_STRING", marshaller_type_name = "STRING", param_spec_function = "g_param_spec_string", get_value_function = "g_value_get_string", set_value_function = "g_value_set_string", take_value_function = "g_value_take_string", type_signature = "s")] public class string { - [Deprecated (replacement = "string.index_of")] + [Version (replacement = "string.index_of")] [CCode (cname = "strstr")] public unowned string? str (string needle); - [Deprecated (replacement = "string.last_index_of")] + [Version (replacement = "string.last_index_of")] [CCode (cname = "g_strrstr")] public unowned string? rstr (string needle); [CCode (cname = "g_strrstr_len")] @@ -937,8 +1020,10 @@ public class string { } } + [Version (since = "2.2")] [CCode (cname = "g_str_has_prefix")] public bool has_prefix (string prefix); + [Version (since = "2.2")] [CCode (cname = "g_str_has_suffix")] public bool has_suffix (string suffix); [CCode (cname = "g_strdup_printf"), PrintfFormat] @@ -955,6 +1040,7 @@ public class string { public string compress (); [CCode (cname = "g_strsplit", array_length = false, array_null_terminated = true)] public string[] split (string delimiter, int max_tokens = 0); + [Version (since = "2.4")] [CCode (cname = "g_strsplit_set", array_length = false, array_null_terminated = true)] public string[] split_set (string delimiters, int max_tokens = 0); [CCode (cname = "g_stpcpy")] @@ -1029,13 +1115,13 @@ public class string { [CCode (cname = "g_utf8_get_char_validated")] public unichar get_char_validated (ssize_t max_len = -1); - [Deprecated (replacement = "string.index_of_nth_char")] + [Version (replacement = "string.index_of_nth_char")] [CCode (cname = "g_utf8_offset_to_pointer")] public unowned string utf8_offset (long offset); public unowned string offset (long offset) { return (string) ((char*) this + offset); } - [Deprecated (replacement = "string.char_count")] + [Version (replacement = "string.char_count")] public long pointer_to_offset (string pos) { return (long) ((char*) pos - (char*) this); } @@ -1062,15 +1148,16 @@ public class string { } } - [Deprecated (replacement = "string.length")] + [Version (replacement = "string.length")] [CCode (cname = "strlen")] public long len (); - [Deprecated (replacement = "string.index_of_char")] + [Version (replacement = "string.index_of_char")] [CCode (cname = "g_utf8_strchr")] public unowned string chr (ssize_t len, unichar c); - [Deprecated (replacement = "string.last_index_of_char")] + [Version (replacement = "string.last_index_of_char")] [CCode (cname = "g_utf8_strrchr")] public unowned string rchr (ssize_t len, unichar c); + [Version (since = "2.2")] [CCode (cname = "g_utf8_strreverse")] public string reverse (ssize_t len = -1); [CCode (cname = "g_utf8_validate")] @@ -1088,6 +1175,7 @@ public class string { public int collate (string str2); [CCode (cname = "g_utf8_collate_key")] public string collate_key (ssize_t len = -1); + [Version (since = "2.8")] [CCode (cname = "g_utf8_collate_key_for_filename")] public string collate_key_for_filename (ssize_t len = -1); @@ -1129,32 +1217,38 @@ public class string { [CCode (cname = "g_str_hash")] public uint hash (); + [Version (since = "2.40")] [CCode (cname = "g_str_is_ascii")] public bool is_ascii (); + [Version (since = "2.40")] [CCode (instance_pos = "1.5", cname = "g_str_match_string")] public bool match_string (string search_term, bool accept_alternates); - [Deprecated (replacement = "int.parse")] + [Version (since = "2.40")] + [CCode (cname = "g_str_to_ascii")] + public string to_ascii (string? from_locale = null); + [Version (replacement = "int.parse")] [CCode (cname = "atoi")] public int to_int (); - [Deprecated (replacement = "long.parse")] + [Version (replacement = "long.parse")] [CCode (cname = "strtol")] public long to_long (out unowned string endptr = null, int _base = 0); - [Deprecated (replacement = "double.parse")] + [Version (replacement = "double.parse")] [CCode (cname = "g_ascii_strtod")] public double to_double (out unowned string endptr = null); - [Deprecated (replacement = "uint64.parse")] + [Version (replacement = "uint64.parse")] [CCode (cname = "strtoul")] public ulong to_ulong (out unowned string endptr = null, int _base = 0); - [Deprecated (replacement = "int64.parse")] + [Version (replacement = "int64.parse")] [CCode (cname = "g_ascii_strtoll")] public int64 to_int64 (out unowned string endptr = null, int _base = 0); - [Deprecated (replacement = "uint64.parse")] + [Version (replacement = "uint64.parse", since = "2.2")] [CCode (cname = "g_ascii_strtoull")] public uint64 to_uint64 (out unowned string endptr = null, int _base = 0); [CCode (cname = "g_str_tokenize_and_fold", array_length = false, array_null_terminated = true)] + [Version (since = "2.40")] public string[] tokenize_and_fold (string transit_locale, [CCode (array_length = false, array_null_terminated = true)] out string[] ascii_alternates); - [Deprecated (replacement = "bool.parse")] + [Version (replacement = "bool.parse")] public bool to_bool () { if (this == "true") { return true; @@ -1163,7 +1257,7 @@ public class string { } } - [Deprecated (replacement = "string.length")] + [Version (replacement = "string.length")] [CCode (cname = "strlen")] public size_t size (); @@ -1185,7 +1279,7 @@ public class string { [CCode (cname = "g_strdup")] public string dup (); - [Deprecated (replacement = "string.substring")] + [Version (replacement = "string.substring")] [CCode (cname = "g_strndup")] public string ndup (size_t n); @@ -1509,21 +1603,20 @@ namespace GLib { /* Atomic Operations */ + [Version (since = "2.4")] namespace AtomicInt { public static int get ([CCode (type = "volatile gint *")] ref int atomic); public static void set ([CCode (type = "volatile gint *")] ref int atomic, int newval); -#if GLIB_2_30 + [Version (since = "2.30")] public static int add ([CCode (type = "volatile gint *")] ref int atomic, int val); -#else - public static void add ([CCode (type = "volatile gint *")] ref int atomic, int val); -#endif - [Deprecated (since = "2.30", replacement = "add")] + [Version (deprecated_since = "2.30", replacement = "add")] public static int exchange_and_add ([CCode (type = "volatile gint *")] ref int atomic, int val); public static bool compare_and_exchange ([CCode (type = "volatile gint *")] ref int atomic, int oldval, int newval); public static void inc ([CCode (type = "volatile gint *")] ref int atomic); public static bool dec_and_test ([CCode (type = "volatile gint *")] ref int atomic); } + [Version (since = "2.4")] namespace AtomicPointer { public static void* get ([CCode (type = "volatile gpointer *")] void** atomic); public static void set ([CCode (type = "volatile gpointer *")] void** atomic, void* newval); @@ -1563,6 +1656,7 @@ namespace GLib { public void wakeup (); public bool acquire (); public void release (); + [Version (since = "2.10")] public bool is_owner (); public bool wait (Cond cond, Mutex mutex); public bool prepare (out int priority); @@ -1575,14 +1669,21 @@ namespace GLib { public void add_poll (ref PollFD fd, int priority); public void remove_poll (ref PollFD fd); public int depth (); + [Version (since = "2.12")] [CCode (cname = "g_main_current_source")] public static unowned Source current_source (); + [Version (since = "2.22")] public static unowned MainContext? get_thread_default (); + [Version (since = "2.32")] public static MainContext ref_thread_default (); + [Version (since = "2.22")] public void push_thread_default (); + [Version (since = "2.22")] public void pop_thread_default (); + [Version (since = "2.28")] [CCode (cname = "g_main_context_invoke_full")] public void invoke (owned SourceFunc function, [CCode (pos = 0.1)] int priority = Priority.DEFAULT); + [Version (since = "2.28")] public void invoke_full (int priority, owned SourceFunc function); } @@ -1592,6 +1693,7 @@ namespace GLib { [CCode (cname = "GSource")] public class TimeoutSource : Source { public TimeoutSource (uint interval); + [Version (since = "2.14")] public TimeoutSource.seconds (uint interval); } @@ -1599,8 +1701,10 @@ namespace GLib { [CCode (cname = "g_timeout_add_full")] public static uint add (uint interval, owned SourceFunc function, [CCode (pos = 0.1)] int priority = Priority.DEFAULT); public static uint add_full (int priority, uint interval, owned SourceFunc function); + [Version (since = "2.14")] [CCode (cname = "g_timeout_add_seconds_full")] public static uint add_seconds (uint interval, owned SourceFunc function, [CCode (pos = 0.1)] int priority = Priority.DEFAULT); + [Version (since = "2.14")] public static uint add_seconds_full (int priority, uint interval, owned SourceFunc function); } @@ -1629,8 +1733,10 @@ namespace GLib { } namespace ChildWatch { + [Version (since = "2.4")] [CCode (cname = "g_child_watch_add_full")] public static uint add (Pid pid, owned ChildWatchFunc function, [CCode (pos = 0.1)] int priority = Priority.DEFAULT_IDLE); + [Version (since = "2.4")] public static uint add_full (int priority, Pid pid, owned ChildWatchFunc function); } @@ -1644,43 +1750,56 @@ namespace GLib { [CCode (ref_function = "g_source_ref", unref_function = "g_source_unref")] public abstract class Source { protected Source (); + [Version (since = "2.12")] public void set_funcs (SourceFuncs funcs); public uint attach (MainContext? context); public void destroy (); + [Version (since = "2.12")] public bool is_destroyed (); public void set_priority (int priority); public int get_priority (); public void set_can_recurse (bool can_recurse); public bool get_can_recurse (); public uint get_id (); + [Version (since = "2.26")] public unowned string? get_name (); + [Version (since = "2.26")] public void set_name (string? name); + [Version (since = "2.26")] public static void set_name_by_id (uint tag, string? name); public unowned MainContext get_context (); public void set_callback (owned SourceFunc func); public void set_callback_indirect (void* callback_data, SourceCallbackFuncs callback_funcs); + [Version (since = "2.36")] public void* add_unix_fd (int fd, IOCondition events); + [Version (since = "2.36")] public void remove_unix_fd (void* tag); + [Version (since = "2.36")] public void modify_unix_fd (void* tag, IOCondition new_events); + [Version (since = "2.36")] public IOCondition query_unix_fd (void* tag); public void add_poll (ref PollFD fd); public void remove_poll (ref PollFD fd); + [Version (since = "2.28")] public void add_child_source (Source child_source); + [Version (since = "2.28")] public void remove_child_source (Source child_source); + [Version (since = "2.28")] public int64 get_time (); - [Deprecated (since = "2.28", replacement = "get_time")] + [Version (deprecated_since = "2.28", replacement = "get_time")] public void get_current_time (out TimeVal timeval); + [Version (since = "2.36")] public void set_ready_time (int64 ready_time); public int64 get_ready_time (); public static bool remove (uint id); public static bool remove_by_funcs_user_data (void* user_data); public static bool remove_by_user_data (void* user_data); -#if GLIB_2_32 + [Version (since = "2.32")] [CCode (cname = "G_SOURCE_CONTINUE")] public static const bool CONTINUE; + [Version (since = "2.32")] [CCode (cname = "G_SOURCE_REMOVE")] public static const bool REMOVE; -#endif protected abstract bool prepare (out int timeout_); protected abstract bool check (); @@ -1732,6 +1851,7 @@ namespace GLib { public delegate G ThreadFunc<G> (); public delegate void Func<G> (G data); + [Version (since = "2.36")] public uint get_num_processors (); [CCode (has_type_id = false)] @@ -1743,52 +1863,53 @@ namespace GLib { } [Compact] -#if GLIB_2_32 + [Version (since = "2.32")] [CCode (ref_function = "g_thread_ref", unref_function = "g_thread_unref")] -#endif public class Thread<T> { -#if GLIB_2_32 + [Version (since = "2.32")] public Thread (string? name, owned ThreadFunc<T> func); + [Version (since = "2.32")] [CCode (cname = "g_thread_try_new")] public Thread.try (string? name, owned ThreadFunc<T> func) throws GLib.Error; -#endif public static bool supported (); - [Deprecated (since = "2.32", replacement = "new Thread<T> ()")] + [Version (deprecated_since = "2.32", replacement = "new Thread<T> ()")] [CCode (simple_generics = true)] public static unowned Thread<T> create<T> (owned ThreadFunc<T> func, bool joinable) throws ThreadError; - [Deprecated (since = "2.32", replacement = "new Thread<T> ()")] + [Version (deprecated_since = "2.32", replacement = "new Thread<T> ()")] [CCode (simple_generics = true)] public static unowned Thread<T> create_full<T> (owned ThreadFunc<T> func, ulong stack_size, bool joinable, bool bound, ThreadPriority priority) throws ThreadError; [CCode (simple_generics = true)] public static unowned Thread<T> self<T> (); [DestroysInstance] public T join (); - [Deprecated (since = "2.32")] + [Version (deprecated_since = "2.32")] public void set_priority (ThreadPriority priority); public static void yield (); public static void exit (T retval); - [Deprecated (since = "2.32")] + [Version (deprecated_since = "2.32", since = "2.10")] public static void @foreach (Func<Thread> thread_func); [CCode (cname = "g_usleep")] public static void usleep (ulong microseconds); } -#if GLIB_2_32 + [Version (since = "2.32")] [CCode (destroy_function = "g_mutex_clear", lvalue_access = false)] public struct Mutex { -#else - [Compact] - [CCode (free_function = "g_mutex_free")] - [Deprecated (since = "glib-2.32", replacement = "Mutex (with --target-glib=2.32)")] - public class Mutex { -#endif public Mutex (); public void @lock (); public bool trylock (); public void unlock (); } + [Version (since = "2.44")] + [CCode (destroy_function = "g_mutex_locker_free")] + public struct MutexLocker { + public MutexLocker (Mutex mutex); + public void free (); + } + + [Version (since = "2.32")] [CCode (destroy_function = "g_rec_mutex_clear")] public struct RecMutex { public RecMutex (); @@ -1797,6 +1918,7 @@ namespace GLib { public void unlock (); } + [Version (since = "2.32")] [CCode (destroy_function = "g_rw_lock_clear")] public struct RWLock { public RWLock (); @@ -1808,8 +1930,8 @@ namespace GLib { public void reader_unlock (); } + [Version (deprecated_since = "glib-2.32", replacement = "Mutex")] [CCode (destroy_function = "g_static_mutex_free", default_value = "G_STATIC_MUTEX_INIT")] - [Deprecated (since = "glib-2.32", replacement = "Mutex")] public struct StaticMutex { public StaticMutex (); public void lock (); @@ -1818,8 +1940,8 @@ namespace GLib { public void lock_full (); } + [Version (deprecated_since = "glib-2.32", replacement = "RecMutex")] [CCode (destroy_function = "g_static_rec_mutex_free", default_value = "G_STATIC_REC_MUTEX_INIT")] - [Deprecated (since = "glib-2.32", replacement = "RecMutex")] public struct StaticRecMutex { public StaticRecMutex (); public void lock (); @@ -1828,8 +1950,8 @@ namespace GLib { public void lock_full (); } + [Version (deprecated_since = "glib-2.32", replacement = "RWLock")] [CCode (destroy_function = "g_static_rw_lock_free", default_value = "G_STATIC_RW_LOCK_INIT")] - [Deprecated (since = "glib-2.32", replacement = "RWLock")] public struct StaticRWLock { public StaticRWLock (); public void reader_lock (); @@ -1850,39 +1972,37 @@ namespace GLib { } [CCode (destroy_function = "g_static_private_free", default_value = "G_STATIC_PRIVATE_INIT")] - [Deprecated (since = "glib-2.32")] + [Version (deprecated_since = "glib-2.32")] public struct StaticPrivate { public StaticPrivate (); public void* get (); public void set (void* data, DestroyNotify? destroy_func); } -#if GLIB_2_32 + [Version (since = "2.32")] [CCode (destroy_function = "g_cond_clear", lvalue_access = false)] public struct Cond { -#else - [Compact] - [CCode (free_function = "g_cond_free")] - [Deprecated (since = "glib-2.32", replacement = "Cond (with --target-glib=2.32)")] - public class Cond { -#endif public Cond (); public void @signal (); public void broadcast (); public void wait (Mutex mutex); - [Deprecated (since = "2.32", replacement = "wait_until")] + [Version (deprecated_since = "2.32", replacement = "wait_until")] public bool timed_wait (Mutex mutex, TimeVal abs_time); + [Version (since = "2.32")] public bool wait_until (Mutex mutex, int64 end_time); } [CCode (cname = "GThreadFunc")] public delegate G OnceFunc<G> (); + [Version (since = "2.4")] [CCode (default_value = "G_ONCE_INIT")] public struct Once<G> { [CCode (cname = "g_once")] public unowned G once (OnceFunc<G> function); + [Version (since = "2.14")] public static bool init_enter ([CCode (ctype="volatile gsize *")] size_t *value); + [Version (since = "2.14")] public static void init_leave ([CCode (ctype="volatile gsize *")] size_t *value, size_t set_value); public OnceStatus status; } @@ -1902,17 +2022,18 @@ namespace GLib { [Compact] [CCode (free_function = "g_thread_pool_free")] public class ThreadPool<T> { - [Deprecated (since = "vala-0.18", replacement = "ThreadPool.with_owned_data")] + [Version (deprecated_since = "vala-0.18", replacement = "ThreadPool.with_owned_data")] public ThreadPool (Func<T> func, int max_threads, bool exclusive) throws ThreadError; [CCode (cname = "g_thread_pool_new")] public ThreadPool.with_owned_data (ThreadPoolFunc<T> func, int max_threads, bool exclusive) throws ThreadError; - [Deprecated (since = "vala-0.18", replacement = "add")] + [Version (deprecated_since = "vala-0.18", replacement = "add")] public void push (T data) throws ThreadError; [CCode (cname = "g_thread_pool_push")] public void add (owned T data) throws ThreadError; public void set_max_threads (int max_threads) throws ThreadError; public int get_max_threads (); public uint get_num_threads (); + [Version (since = "2.46")] public bool move_to_front (T data); public uint unprocessed (); [CCode (cname = "g_thread_pool_free")] @@ -1928,8 +2049,11 @@ namespace GLib { public static int get_max_unused_threads (); public static uint get_num_unused_threads (); public static void stop_unused_threads (); + [Version (since = "2.10")] public void set_sort_function (CompareDataFunc<T> func); + [Version (since = "2.10")] public static void set_max_idle_time (uint interval); + [Version (since = "2.10")] public static uint get_max_idle_time (); } @@ -1938,25 +2062,33 @@ namespace GLib { [Compact] [CCode (ref_function = "g_async_queue_ref", unref_function = "g_async_queue_unref")] public class AsyncQueue<G> { + [Version (since = "2.16")] [CCode (cname = "g_async_queue_new_full", simple_generics = true)] public AsyncQueue (); public void push (owned G data); + [Version (since = "2.10")] public void push_sorted (owned G data, CompareDataFunc<G> func); public G pop (); public G? try_pop (); public G? timed_pop (ref TimeVal end_time); public int length (); + [Version (since = "2.10")] public void sort (CompareDataFunc<G> func); public void @lock (); public void unlock (); public void ref_unlocked (); public void unref_and_unlock (); + [Version (since = "2.46")] public void push_front (owned G data); + [Version (since = "2.46")] public void push_front_unlocked (owned G data); public void push_unlocked (owned G data); + [Version (since = "2.10")] public void push_sorted_unlocked (owned G data, CompareDataFunc<G> func); public G pop_unlocked (); + [Version (since = "2.46")] public bool remove (G data); + [Version (since = "2.46")] public bool remove_unlocked (G data); public G? try_pop_unlocked (); public G? timed_pop_unlocked (ref TimeVal end_time); @@ -1973,6 +2105,7 @@ namespace GLib { public static void* realloc (void* mem, size_t n_bytes); public static void* try_malloc (size_t n_bytes); + [Version (since = "2.8")] public static void* try_malloc0 (size_t n_bytes); public static void* try_realloc (void* mem, size_t n_bytes); @@ -2001,9 +2134,11 @@ namespace GLib { public static void* dup (void* mem, uint n); } + [Version (since = "2.10")] namespace Slice { public static void* alloc (size_t block_size); public static void* alloc0 (size_t block_size); + [Version (since = "2.14")] public static void* copy (size_t block_size, void* mem_block); [CCode (cname = "g_slice_free1")] public static void free (size_t block_size, void* mem_block); @@ -2169,24 +2304,31 @@ namespace GLib { [NoReturn] [CCode (sentinel = "")] public static void return_val_if_reached (...); + [Version (since = "2.16")] public static void warn_if_fail (bool expr); + [Version (since = "2.16")] public static void warn_if_reached (); [Assert] public static void assert (bool expr); [Assert] + [Version (since = "2.46")] public static void assert_cmpmem (uint8[] m1, uint8[] m2); [Assert] public static void assert_error (Error? error, Quark error_domain, int error_code); [Assert] + [Version (since = "2.38")] public static void assert_false (bool expr); [Assert] + [Version (since = "2.38")] public static void assert_true (bool expr); [Assert] + [Version (since = "2.38")] public static void assert_null (void* expr); [Assert] public static void assert_no_error (Error? error); [Assert] + [Version (since = "2.40")] public static void assert_nonnull (void* expr); [NoReturn] public static void assert_not_reached (); @@ -2236,16 +2378,20 @@ namespace GLib { public void error (string format, ...); [Diagnostics] [PrintfFormat] + [Version (since = "2.6")] public void debug (string format, ...); [Diagnostics] [PrintfFormat] + [Version (since = "2.40")] public void info (string format, ...); public delegate void LogFunc (string? log_domain, LogLevelFlags log_levels, string message); namespace Log { public static uint set_handler (string? log_domain, LogLevelFlags log_levels, LogFunc log_func); + [Version (since = "2.46")] public static void set_handler_full (string? log_domain, LogLevelFlags log_levels, owned LogFunc log_func); + [Version (since = "2.6")] public static void set_default_handler (LogFunc log_func); [CCode (delegate_target = false)] public static GLib.LogFunc default_handler; @@ -2268,8 +2414,14 @@ namespace GLib { /* String Utility Functions */ + public string strdup (string str); + [CCode (array_length = false, array_null_terminated = true)] + public string[] strdupv ([CCode (array_length = false, array_null_terminated = true)] string[] str_array); + public void strfreev (string** str_array); + [Version (since = "2.6")] public uint strv_length ([CCode (array_length = false, array_null_terminated = true)] string[] str_array); + [Version (since = "2.44")] public bool strv_contains ([CCode (array_length = false, array_null_terminated = true)] string[] str_array, string str); [CCode (cname = "errno", cheader_filename = "errno.h")] @@ -2295,7 +2447,9 @@ namespace GLib { public static string from_utf8 (string utf8string, ssize_t len, out size_t bytes_read, out size_t bytes_written) throws ConvertError; public static string from_uri (string uri, out string hostname = null) throws ConvertError; public static string to_uri (string filename, string? hostname = null) throws ConvertError; + [Version (since = "2.6")] public static string display_name (string filename); + [Version (since = "2.6")] public static string display_basename (string filename); } @@ -2310,6 +2464,7 @@ namespace GLib { /* Base64 Encoding */ + [Version (since = "2.12")] namespace Base64 { public static size_t encode_step (uchar[] _in, bool break_lines, char* _out, ref int state, ref int save); public static size_t encode_close (bool break_lines, char* _out, ref int state, ref int save); @@ -2321,6 +2476,7 @@ namespace GLib { /* Data Checksums */ + [Version (since = "2.16")] [CCode (cprefix = "G_CHECKSUM_", has_type_id = false)] public enum ChecksumType { MD5, @@ -2332,6 +2488,7 @@ namespace GLib { } [Compact] + [Version (since = "2.16")] [CCode (free_function = "g_checksum_free")] public class Checksum { public Checksum (ChecksumType checksum_type); @@ -2343,6 +2500,7 @@ namespace GLib { public static string compute_for_data (ChecksumType checksum_type, uchar[] data); [CCode (cname = "g_compute_checksum_for_string")] public static string compute_for_string (ChecksumType checksum_type, string str, size_t length = -1); + [Version (since = "2.34")] [CCode (cname = "g_compute_checksum_for_bytes")] public static string compute_for_bytes (ChecksumType checksum_type, Bytes data); } @@ -2350,6 +2508,7 @@ namespace GLib { /* Secure HMAC Digests */ [Compact] + [Version (since = "2.30")] [CCode (ref_function = "g_hmac_ref", unref_function = "g_hmac_unref")] public class Hmac { public Hmac (ChecksumType digest_type, [CCode (array_length_type = "gsize")] uint8[] key); @@ -2357,8 +2516,10 @@ namespace GLib { public void update ([CCode (array_length_type = "gssize")] uint8[] data); public unowned string get_string (); public void get_digest ([CCode (array_length = false)] uint8[] buffer, ref size_t digest_len); + [Version (since = "2.30")] [CCode (cname = "g_compute_hmac_for_data")] public static string compute_for_data (ChecksumType checksum_type, uint8[] key, uint8[] data); + [Version (since = "2.30")] [CCode (cname = "g_compute_hmac_for_string")] public static string compute_for_string (ChecksumType checksum_type, uint8[] key, string str, size_t length = -1); } @@ -2375,12 +2536,16 @@ namespace GLib { [CCode (cname = "g_get_current_time")] public void get_current_time (); public void add (long microseconds); + [Version (since = "2.12")] [CCode (instance_pos = -1)] public bool from_iso8601 (string iso_date); + [Version (since = "2.12")] public string to_iso8601 (); } + [Version (since = "2.28")] public static int64 get_monotonic_time (); + [Version (since = "2.28")] public static int64 get_real_time (); public struct DateDay : uchar { @@ -2457,7 +2622,9 @@ namespace GLib { public void set_year (DateYear year); public void set_dmy (DateDay day, int month, DateYear y); public void set_julian (uint julian_day); + [Version (since = "2.10")] public void set_time_t (time_t timet); + [Version (since = "2.10")] public void set_time_val (TimeVal timeval); public void set_parse (string str); public void add_days (uint n_days); @@ -2480,6 +2647,7 @@ namespace GLib { public bool is_last_of_month (); public uint get_monday_week_of_year (); public uint get_sunday_week_of_year (); + [Version (since = "2.6")] public uint get_iso8601_week_of_year (); [CCode (instance_pos = -1)] public size_t strftime (char[] s, string format); @@ -2550,6 +2718,7 @@ namespace GLib { } [SimpleType] + [Version (since = "2.26")] [CCode (cheader_filename = "glib.h", type_id = "G_TYPE_INT64", marshaller_type_name = "INT64", get_value_function = "g_value_get_int64", set_value_function = "g_value_set_int64", default_value = "0LL", type_signature = "x")] [IntegerType (rank = 10)] public struct TimeSpan : int64 { @@ -2561,6 +2730,7 @@ namespace GLib { } [Compact] + [Version (since = "2.26")] [CCode (ref_function = "g_date_time_ref", unref_function = "g_date_time_unref", type_id = "G_TYPE_DATE_TIME")] public class DateTime { public DateTime.now (TimeZone tz); @@ -2620,6 +2790,7 @@ namespace GLib { } [Compact] + [Version (since = "2.26")] [CCode (ref_function = "g_time_zone_ref", unref_function = "g_time_zone_unref")] public class TimeZone { public TimeZone (string identifier); @@ -2638,9 +2809,11 @@ namespace GLib { [CCode (copy_function = "g_rand_copy", free_function = "g_rand_free")] public class Rand { public Rand.with_seed (uint32 seed); + [Version (since = "2.4")] public Rand.with_seed_array ([CCode (array_length = false)] uint32[] seed, uint seed_length); public Rand (); public void set_seed (uint32 seed); + [Version (since = "2.4")] public void set_seed_array ([CCode (array_length = false)] uint32[] seed, uint seed_length); public bool boolean (); [CCode (cname = "g_rand_int")] @@ -2665,8 +2838,10 @@ namespace GLib { /* Miscellaneous Utility Functions */ namespace Environment { + [Version (since = "2.2")] [CCode (cname = "g_get_application_name")] public static unowned string? get_application_name (); + [Version (since = "2.2")] [CCode (cname = "g_set_application_name")] public static void set_application_name (string application_name); [CCode (cname = "g_get_prgname")] @@ -2675,30 +2850,40 @@ namespace GLib { public static void set_prgname (string application_name); [CCode (cname = "g_getenv")] public static unowned string? get_variable (string variable); + [Version (since = "2.4")] [CCode (cname = "g_setenv")] public static bool set_variable (string variable, string value, bool overwrite); + [Version (since = "2.4")] [CCode (cname = "g_unsetenv")] public static void unset_variable (string variable); + [Version (since = "2.8")] [CCode (cname = "g_listenv", array_length = false, array_null_terminated = true)] public static string[] list_variables (); [CCode (cname = "g_get_user_name")] public static unowned string get_user_name (); [CCode (cname = "g_get_real_name")] public static unowned string get_real_name (); + [Version (since = "2.6")] [CCode (cname = "g_get_user_cache_dir")] public static unowned string get_user_cache_dir (); + [Version (since = "2.6")] [CCode (cname = "g_get_user_data_dir")] public static unowned string get_user_data_dir (); + [Version (since = "2.6")] [CCode (cname = "g_get_user_config_dir")] public static unowned string get_user_config_dir (); [CCode (cname = "g_get_user_runtime_dir")] public static unowned string get_user_runtime_dir (); + [Version (since = "2.14")] [CCode (cname = "g_get_user_special_dir")] public static unowned string get_user_special_dir (UserDirectory directory); + [Version (since = "2.6")] [CCode (cname = "g_get_system_data_dirs", array_length = false, array_null_terminated = true)] public static unowned string[] get_system_data_dirs (); + [Version (since = "2.6")] [CCode (cname = "g_get_system_config_dirs", array_length = false, array_null_terminated = true)] public static unowned string[] get_system_config_dirs (); + [Version (since = "2.8")] [CCode (cname = "g_get_host_name")] public static unowned string get_host_name (); [CCode (cname = "g_get_home_dir")] @@ -2709,24 +2894,30 @@ namespace GLib { public static string get_current_dir (); [CCode (cname = "g_find_program_in_path")] public static string? find_program_in_path (string program); - [Deprecated (since = "2.32")] + [Version (deprecated_since = "2.32")] [CCode (cname = "g_atexit")] public static void atexit (VoidFunc func); + [Version (since = "2.8")] [CCode (cname = "g_chdir")] public static int set_current_dir (string path); } namespace Environ { + [Version (since = "2.28")] [CCode (cname = "g_get_environ", array_length = false, array_null_terminated = true)] public static string[] get (); + [Version (since = "2.32")] [CCode (cname = "g_environ_getenv")] public static unowned string? get_variable ([CCode (array_length = false, array_null_terminated = true)] string[]? envp, string variable); + [Version (since = "2.32")] [CCode (cname = "g_environ_setenv", array_length = false, array_null_terminated = true)] public static string[] set_variable ([CCode (array_length = false, array_null_terminated = true)] owned string[]? envp, string variable, string value, bool overwrite = true); + [Version (since = "2.32")] [CCode (cname = "g_environ_unsetenv", array_length = false, array_null_terminated = true)] public static string[] unset_variable ([CCode (array_length = false, array_null_terminated = true)] owned string[]? envp, string variable); } + [Version (since = "2.14")] [CCode (has_type_id = false)] public enum UserDirectory { DESKTOP, @@ -2763,6 +2954,7 @@ namespace GLib { public const char DIR_SEPARATOR; [CCode (cname = "G_DIR_SEPARATOR_S")] public const string DIR_SEPARATOR_S; + [Version (since = "2.6")] [CCode (cname = "G_IS_DIR_SEPARATOR")] public static bool is_dir_separator (unichar c); [CCode (cname = "G_SEARCHPATH_SEPARATOR")] @@ -2786,12 +2978,14 @@ namespace GLib { [CCode (has_target = false)] public delegate void VoidFunc (); - [Deprecated (since = "2.16", replacement = "format_size")] + [Version (deprecated_since = "2.30", replacement = "format_size", since = "2.16")] public string format_size_for_display (int64 size); + [Version (since = "2.30")] [CCode (cname = "g_format_size_full")] public string format_size (uint64 size, FormatSizeFlags flags = FormatSizeFlags.DEFAULT); + [Version (since = "2.30")] [CCode (cprefix = "G_FORMAT_SIZE_", has_type_id = false)] [Flags] public enum FormatSizeFlags { @@ -2950,7 +3144,7 @@ namespace GLib { /* Automatic String Completion */ - [Deprecated (since = "2.26")] + [Version (deprecated_since = "2.26")] [Compact] [CCode (free_function = "g_completion_free")] public class Completion { @@ -2964,6 +3158,7 @@ namespace GLib { public void remove_items (List<void*> items); public void clear_items (); public unowned List<void*> complete (string prefix, out string? new_prefix = null); + [Version (since = "2.4")] public unowned List<void*> complete_utf8 (string prefix, out string? new_prefix = null); } @@ -2980,6 +3175,7 @@ namespace GLib { public Timer (); public void start (); public void stop (); + [Version (since = "2.4")] public void @continue (); public double elapsed (out ulong microseconds = null); public void reset (); @@ -3038,6 +3234,7 @@ namespace GLib { public static bool spawn_command_line_sync (string command_line, out string standard_output = null, out string standard_error = null, out int exit_status = null) throws SpawnError; [CCode (cname = "g_spawn_close_pid")] public static void close_pid (Pid pid); + [Version (since = "2.34")] [CCode (cname = "g_spawn_check_exit_status")] public static bool check_exit_status (int exit_status) throws GLib.Error; @@ -3150,6 +3347,7 @@ namespace GLib { [CCode (cname = "EOF", cheader_filename = "stdio.h")] public const int EOF; + [Version (since = "2.6")] [CCode (cname = "g_fopen", cheader_filename = "glib/gstdio.h")] public static FileStream? open (string path, string mode); [CCode (cname = "fdopen")] @@ -3221,6 +3419,7 @@ namespace GLib { [CCode (lower_case_cprefix = "g_file_", cheader_filename = "glib/gstdio.h")] namespace FileUtils { public static bool get_contents (string filename, out string contents, out size_t length = null) throws FileError; + [Version (since = "2.8")] public static bool set_contents (string filename, string contents, ssize_t length = -1) throws FileError; [CCode (cname = "g_file_get_contents")] public static bool get_data (string filename, [CCode (type = "gchar**", array_length_type = "size_t")] out uint8[] contents) throws FileError; @@ -3228,19 +3427,24 @@ namespace GLib { public static bool set_data (string filename, [CCode (type = "const char*", array_length_type = "size_t")] uint8[] contents) throws FileError; public static bool test (string filename, FileTest test); public static int open_tmp (string tmpl, out string name_used) throws FileError; + [Version (since = "2.4")] public static string read_link (string filename) throws FileError; public static int error_from_errno (int err_no); [CCode (cname = "g_mkstemp")] public static int mkstemp (string tmpl); + [Version (since = "2.6")] [CCode (cname = "g_rename")] public static int rename (string oldfilename, string newfilename); + [Version (since = "2.6")] [CCode (cname = "g_remove")] public static int remove (string filename); [CCode (cname = "g_unlink")] public static int unlink (string filename); + [Version (since = "2.8")] [CCode (cname = "g_chmod")] public static int chmod (string filename, int mode); + [Version (since = "2.18")] [CCode (cname = "g_utime")] public static int utime (string filename, UTimBuf? times = null); @@ -3249,12 +3453,17 @@ namespace GLib { [CCode (cname = "close", cheader_filename = "unistd.h")] public static int close (int fd); + + [Version (since = "2.36")] + [CCode (cname = "g_close")] + public static bool close_checked (int fd) throws FileError; } [CCode (cname = "struct stat", cheader_filename = "sys/stat.h,glib/gstdio.h")] public struct Stat { [CCode (cname = "g_stat", instance_pos = -1)] public Stat (string filename); + [Version (since = "2.6")] [CCode (cname = "g_lstat", instance_pos = -1)] public Stat.l (string filename); } @@ -3269,24 +3478,31 @@ namespace GLib { [CCode (cheader_filename = "glib/gstdio.h")] namespace DirUtils { + [Version (since = "2.6")] [CCode (cname = "g_mkdir")] public static int create (string pathname, int mode); + [Version (since = "2.8")] [CCode (cname = "g_mkdir_with_parents")] public static int create_with_parents (string pathname, int mode); + [Version (since = "2.30")] [CCode (cname = "mkdtemp")] public static string mkdtemp (owned string template); + [Version (since = "2.30")] [CCode (cname = "g_dir_make_tmp")] public static string make_tmp (string tmpl) throws FileError; + [Version (since = "2.6")] [CCode (cname = "g_rmdir")] public static int remove (string filename); } [Compact] + [Version (since = "2.22")] [CCode (ref_function = "g_mapped_file_ref", unref_function = "g_mapped_file_unref")] public class MappedFile { public MappedFile (string filename, bool writable) throws FileError; public size_t get_length (); public unowned char* get_contents (); + [Version (since = "2.34")] public Bytes get_bytes (); } @@ -3308,10 +3524,15 @@ namespace GLib { public const string RESERVED_CHARS_GENERIC_DELIMITERS; public const string RESERVED_CHARS_SUBCOMPONENT_DELIMITERS; + [Version (since = "2.16")] public static string? parse_scheme (string uri); + [Version (since = "2.16")] public static string escape_string (string unescaped, string? reserved_chars_allowed = null, bool allow_utf8 = true); + [Version (since = "2.16")] public static string? unescape_string (string escaped_string, string? illegal_characters = null); + [Version (since = "2.16")] public static string? unescape_segment (string? escaped_string, string? escaped_string_end, string? illegal_characters = null); + [Version (since = "2.6")] [CCode (array_length = false, array_null_terminated = true)] public static string[] list_extract_uris (string uri_list); } @@ -3339,27 +3560,38 @@ namespace GLib { } [Compact] + [Version (since = "2.6")] [CCode (free_function = "g_option_context_free")] public class OptionContext { public OptionContext (string? parameter_string = null); + [Version (since = "2.12")] public void set_summary (string summary); + [Version (since = "2.12")] public unowned string get_summary (); + [Version (since = "2.12")] public void set_description (string description); + [Version (since = "2.12")] public void get_description (); + [Version (since = "2.12")] public void set_translate_func (TranslateFunc func, DestroyNotify? destroy_notify); + [Version (since = "2.12")] public void set_translation_domain (string domain); public bool parse ([CCode (array_length_pos = 0.9)] ref unowned string[] argv) throws OptionError; + [Version (since = "2.40")] public bool parse_strv ([CCode (array_length = false, array_null_terminated = true)] ref string[] argv) throws OptionError; public void set_help_enabled (bool help_enabled); public bool get_help_enabled (); public void set_ignore_unknown_options (bool ignore_unknown); public bool get_ignore_unknown_options (); + [Version (since = "2.14")] public string get_help (bool main_help, OptionGroup? group); public void add_main_entries ([CCode (array_length = false)] OptionEntry[] entries, string? translation_domain); public void add_group (owned OptionGroup group); public void set_main_group (owned OptionGroup group); public unowned OptionGroup get_main_group (); + [Version (since = "2.44")] public void set_strict_posix (bool strict_posix); + [Version (since = "2.44")] public bool get_strict_posix (); } @@ -3404,8 +3636,10 @@ namespace GLib { [Compact] #if GLIB_2_44 + [Version (since = "2.44")] [CCode (ref_function = "g_option_group_ref", unref_function = "g_option_group_unref", type_id = "G_TYPE_OPTION_GROUP")] #else + [Version (since = "2.6")] [CCode (free_function = "g_option_group_free")] #endif public class OptionGroup { @@ -3424,6 +3658,7 @@ namespace GLib { /* Perl-compatible regular expressions */ + [Version (since = "2.14")] public errordomain RegexError { COMPILE, OPTIMIZE, @@ -3484,6 +3719,7 @@ namespace GLib { CHARACTER_VALUE_TOO_LARGE } + [Version (since = "2.14")] [CCode (cprefix = "G_REGEX_", has_type_id = false)] [Flags] public enum RegexCompileFlags { @@ -3506,6 +3742,7 @@ namespace GLib { JAVASCRIPT_COMPAT } + [Version (since = "2.14")] [CCode (cprefix = "G_REGEX_MATCH_", has_type_id = false)] [Flags] public enum RegexMatchFlags { @@ -3527,13 +3764,19 @@ namespace GLib { } [Compact] + [Version (since = "2.14")] [CCode (ref_function = "g_regex_ref", unref_function = "g_regex_unref", type_id = "G_TYPE_REGEX")] public class Regex { public Regex (string pattern, RegexCompileFlags compile_options = 0, RegexMatchFlags match_options = 0) throws RegexError; public unowned string get_pattern (); + [Version (since = "2.26")] public RegexCompileFlags get_compile_flags (); + [Version (since = "2.34")] + public bool get_has_cr_or_lf (); + [Version (since = "2.26")] public RegexMatchFlags get_match_flags (); public int get_max_backref (); + [Version (since = "2.38")] public int get_max_lookbehind (); public int get_capture_count (); public int get_string_number (string name); @@ -3555,14 +3798,12 @@ namespace GLib { public static bool check_replacement (out bool has_references = null) throws RegexError; } + [Version (since = "2.14")] public delegate bool RegexEvalCallback (MatchInfo match_info, StringBuilder result); [Compact] -#if GLIB_2_30 + [Version (since = "2.30")] [CCode (ref_function = "g_match_info_ref", unref_function = "g_match_info_unref", type_id = "G_TYPE_MATCH_INFO")] -#else - [CCode (free_function = "g_match_info_free")] -#endif public class MatchInfo { public unowned Regex get_regex (); public unowned string get_string (); @@ -3601,6 +3842,7 @@ namespace GLib { [Compact] #if GLIB_2_36 + [Version (since = "2.36")] [CCode (ref_function = "g_markup_parse_context_ref", unref_function = "g_markup_parse_context_unref", type_id = "G_TYPE_MARKUP_PARSE_CONTEXT")] #else [CCode (free_function = "g_markup_parse_context_free")] @@ -3609,11 +3851,16 @@ namespace GLib { public MarkupParseContext (MarkupParser parser, MarkupParseFlags _flags, void* user_data, DestroyNotify? user_data_dnotify); public bool parse (string text, ssize_t text_len) throws MarkupError; public bool end_parse () throws MarkupError; + [Version (since = "2.2")] public unowned string get_element (); + [Version (since = "2.16")] public unowned SList<string> get_element_stack (); public void get_position (out int line_number, out int char_number); + [Version (since = "2.18")] public void push (MarkupParser parser, void* user_data); + [Version (since = "2.18")] public void* pop (); + [Version (since = "2.18")] public void* get_user_data (); } @@ -3652,9 +3899,12 @@ namespace GLib { } public static string escape_text (string text, ssize_t length = -1); + [Version (since = "2.4")] [PrintfFormat] public static string printf_escaped (string format, ...); + [Version (since = "2.4")] public static string vprintf_escaped (string format, va_list args); + [Version (since = "2.16")] [CCode (sentinel = "G_MARKUP_COLLECT_INVALID")] public static bool collect_attributes (string element_name, string[] attribute_names, string[] attribute_values, ...) throws MarkupError; } @@ -3671,15 +3921,13 @@ namespace GLib { } [Compact] -#if GLIB_2_32 + [Version (since = "2.32")] [CCode (ref_function = "g_key_file_ref", unref_function = "g_key_file_unref", type_id = "G_TYPE_KEY_FILE")] -#else - [CCode (free_function = "g_key_file_free")] -#endif public class KeyFile { public KeyFile (); public void set_list_separator (char separator); public bool load_from_file (string file, KeyFileFlags @flags) throws KeyFileError, FileError; + [Version (since = "2.14")] public bool load_from_dirs (string file, [CCode (array_length = false, array_null_terminated = true)] string[] search_dirs, out string full_path, KeyFileFlags @flags) throws KeyFileError, FileError; public bool load_from_data (string data, size_t length, KeyFileFlags @flags) throws KeyFileError; public bool load_from_data_dirs (string file, out string full_path, KeyFileFlags @flags) throws KeyFileError, FileError; @@ -3697,8 +3945,11 @@ namespace GLib { public string get_locale_string (string group_name, string key, string? locale = null) throws KeyFileError; public bool get_boolean (string group_name, string key) throws KeyFileError; public int get_integer (string group_name, string key) throws KeyFileError; + [Version (since = "2.26")] public int64 get_int64 (string group_name, string key) throws KeyFileError; + [Version (since = "2.26")] public uint64 get_uint64 (string group_name, string key) throws KeyFileError; + [Version (since = "2.12")] public double get_double (string group_name, string key) throws KeyFileError; [CCode (array_length_type = "gsize")] public string[] get_string_list (string group_name, string key) throws KeyFileError; @@ -3708,22 +3959,28 @@ namespace GLib { public bool[] get_boolean_list (string group_name, string key) throws KeyFileError; [CCode (array_length_type = "gsize")] public int[] get_integer_list (string group_name, string key) throws KeyFileError; + [Version (since = "2.12")] [CCode (array_length_type = "gsize")] public double[] get_double_list (string group_name, string key) throws KeyFileError; public string get_comment (string? group_name, string? key) throws KeyFileError; + [Version (since = "2.40")] public bool save_to_file (string filename) throws GLib.FileError; public void set_value (string group_name, string key, string value); public void set_string (string group_name, string key, string str); public void set_locale_string (string group_name, string key, string locale, string str); public void set_boolean (string group_name, string key, bool value); public void set_integer (string group_name, string key, int value); + [Version (since = "2.26")] public void set_int64 (string group_name, string key, int64 value); + [Version (since = "2.26")] public void set_uint64 (string group_name, string key, uint64 value); + [Version (since = "2.12")] public void set_double (string group_name, string key, double value); public void set_string_list (string group_name, string key, [CCode (type = "const gchar* const*")] string[] list); public void set_locale_string_list (string group_name, string key, string locale, string[] list); public void set_boolean_list (string group_name, string key, bool[] list); public void set_integer_list (string group_name, string key, int[] list); + [Version (since = "2.12")] public void set_double_list (string group_name, string key, double[] list); public void set_comment (string? group_name, string? key, string comment) throws KeyFileError; public void remove_group (string group_name) throws KeyFileError; @@ -3739,6 +3996,7 @@ namespace GLib { KEEP_TRANSLATIONS } + [Version (since = "2.14")] [CCode (cprefix = "G_KEY_FILE_DESKTOP_")] namespace KeyFileDesktop { public const string GROUP; @@ -3774,6 +4032,7 @@ namespace GLib { /* Bookmark file parser */ [Compact] + [Version (since = "2.12")] [CCode (free_function = "g_bookmark_file_free")] public class BookmarkFile { public BookmarkFile (); @@ -3837,9 +4096,12 @@ namespace GLib { } [PrintfFormat] + [Version (since = "2.16")] public static void minimized_result (double minimized_quantity, string format, ...); [PrintfFormat] + [Version (since = "2.16")] public static void maximized_result (double maximized_quantity, string format, ...); + [Version (since = "2.16")] public static void init ([CCode (array_length_pos = 0.9)] ref unowned string[] args, ...); public static bool quick (); public static bool slow (); @@ -3847,45 +4109,82 @@ namespace GLib { public static bool perf (); public static bool verbose (); public static bool quiet (); + [Version (since = "2.16")] public static int run (); -#if GLIB_2_26 + [Version (since = "2.16")] public static void add_func (string testpath, TestFunc test_funcvoid); -#else - public static void add_func (string testpath, Callback test_funcvoid); -#endif + [Version (since = "2.16")] public static void add_data_func (string testpath, [CCode (delegate_target_pos = 1.9)] TestDataFunc test_funcvoid); + [Version (since = "2.34")] + public static void add_data_func_full (string testpath, [CCode (delegate_target_pos = 1.9)] owned TestDataFunc test_func); + [Version (since = "2.34")] + public static void assert_expected_messages (); + [Version (since = "2.38")] public static string build_filename (GLib.Test.FileType file_type, params string[] path_segments); + [Version (since = "2.34")] + public static void expect_message (string? log_domain, LogLevelFlags log_level, string pattern); + [Version (since = "2.30")] public static void fail (); + [Version (since = "2.38")] public static bool failed (); + [Version (since = "2.38")] public static unowned string get_dir (GLib.Test.FileType file_type); + [Version (since = "2.38")] public static unowned string get_filename (GLib.Test.FileType file_type, params string[] path_segments); + [Version (since = "2.38")] public static void incomplete (string msg); + [Version (since = "2.36")] + public static bool initialized (); [PrintfFormat] + [Version (since = "2.16")] public static void message (string format, ...); + [Version (since = "2.38")] public static void set_nonfatal_assertions (); + [Version (since = "2.38")] public static void skip (string msg); + [Version (since = "2.38")] public static bool subprocess (); + [Version (since = "2.16")] public static void bug_base (string uri_pattern); + [Version (since = "2.16")] public static void bug (string bug_uri_snippet); + [Version (since = "2.16")] public static void timer_start (); + [Version (since = "2.16")] public static double timer_elapsed (); + [Version (since = "2.16")] public static double timer_last (); - [Deprecated (since = "2.38", replacement = "trap_subprocess")] + [Version (since = "2.16", deprecated_since = "2.38", replacement = "trap_subprocess")] public static bool trap_fork (uint64 usec_timeout, TestTrapFlags test_trap_flags); + [Version (since = "2.16")] public static bool trap_has_passed (); + [Version (since = "2.16")] public static bool trap_reached_timeout (); + [Version (since = "2.38")] public static void trap_subprocess (string test_path, uint64 usec_timeout, TestSubprocessFlags test_flags); + [Version (since = "2.16")] public static void trap_assert_passed (); + [Version (since = "2.16")] public static void trap_assert_failed (); + [Version (since = "2.16")] public static void trap_assert_stdout (string soutpattern); + [Version (since = "2.16")] public static void trap_assert_stdout_unmatched (string soutpattern); + [Version (since = "2.16")] public static void trap_assert_stderr (string serrpattern); + [Version (since = "2.16")] public static void trap_assert_stderr_unmatched (string serrpattern); + [Version (since = "2.16")] public static bool rand_bit (); + [Version (since = "2.16")] public static int32 rand_int (); + [Version (since = "2.16")] public static int32 rand_int_range (int32 begin, int32 end); + [Version (since = "2.16")] public static double rand_double (); + [Version (since = "2.16")] public static double rand_double_range (double begin, double end); + [Version (since = "2.22")] public static void log_set_fatal_handler (LogFatalFunc log_func); } @@ -3894,36 +4193,35 @@ namespace GLib { [Compact] [CCode (cname = "GTestCase", ref_function = "", unref_function = "")] public class TestCase { + [Version (since = "2.16")] [CCode (cname = "g_test_create_case")] -#if GLIB_2_26 public TestCase (string test_name, [CCode (delegate_target_pos = 1.9)] TestFixtureFunc data_setup, [CCode (delegate_target_pos = 1.9)] TestFixtureFunc data_func, [CCode (delegate_target_pos = 1.9)] TestFixtureFunc data_teardown, [CCode (pos = 1.8)] size_t data_size = 0); -#else - public TestCase (string test_name, [CCode (delegate_target_pos = 1.9, type = "void (*) (void)")] TestFunc data_setup, [CCode (delegate_target_pos = 1.9, type = "void (*) (void)")] TestFunc data_func, [CCode (delegate_target_pos = 1.9, type = "void (*) (void)")] TestFunc data_teardown, [CCode (pos = 1.8)] size_t data_size = 0); -#endif } [Compact] [CCode (cname = "GTestSuite", ref_function = "", unref_function = "")] public class TestSuite { + [Version (since = "2.16")] [CCode (cname = "g_test_create_suite")] public TestSuite (string name); + [Version (since = "2.16")] [CCode (cname = "g_test_get_root")] public static TestSuite get_root (); + [Version (since = "2.16")] [CCode (cname = "g_test_suite_add")] public void add (TestCase test_case); + [Version (since = "2.16")] [CCode (cname = "g_test_suite_add_suite")] public void add_suite (TestSuite test_suite); } -#if GLIB_2_26 + [Version (since = "2.26")] [CCode (has_target = false)] public delegate void TestFunc (); + [Version (since = "2.26")] public delegate void TestDataFunc (); + [Version (since = "2.26")] public delegate void TestFixtureFunc (void* fixture); -#else - public delegate void TestFunc (void* fixture); - public delegate void TestDataFunc (); -#endif [CCode (cprefix = "G_TEST_SUBPROCESS_INHERIT_", has_type_id = false)] [Flags] @@ -3969,10 +4267,13 @@ namespace GLib { public uint length (); public List<unowned G> copy (); + [Version (since = "2.34")] + public List<G> copy_deep (CopyFunc<G> func); [ReturnsModifiedPointer ()] public void reverse (); [ReturnsModifiedPointer ()] public void sort (CompareFunc<G> compare_func); + [Version (since = "2.10")] [ReturnsModifiedPointer ()] public void insert_sorted_with_data (owned G data, CompareDataFunc<G> compare_func); [ReturnsModifiedPointer ()] @@ -4028,8 +4329,11 @@ namespace GLib { public uint length (); public SList<unowned G> copy (); + [Version (since = "2.34")] + public SList<G> copy_deep (CopyFunc<G> func); [ReturnsModifiedPointer ()] public void reverse (); + [Version (since = "2.10")] [ReturnsModifiedPointer ()] public void insert_sorted_with_data (owned G data, CompareDataFunc<G> compare_func); [ReturnsModifiedPointer ()] @@ -4061,9 +4365,12 @@ namespace GLib { public delegate int CompareDataFunc<G> (G a, G b); + [Version (since = "2.16")] [CCode (cname = "g_strcmp0")] public static GLib.CompareFunc<string> strcmp; + public delegate G CopyFunc<G> (G src); + [CCode (cname = "GCompareFunc", has_target = false)] public delegate int SearchFunc<G,T> (G a, T b); @@ -4078,38 +4385,56 @@ namespace GLib { public Queue (); + [Version (since = "2.14")] public void clear (); public bool is_empty (); + [Version (since = "2.4")] public uint get_length (); + [Version (since = "2.4")] public void reverse (); public Queue copy (); + [Version (since = "2.4")] public unowned List<G> find (G data); + [Version (since = "2.4")] public unowned List<G> find_custom (G data, CompareFunc<G> func); [CCode (cname = "g_queue_find_custom", simple_generics = true)] public unowned List<G> search<T> (T data, SearchFunc<T,G> func); + [Version (since = "2.4")] public void sort (CompareDataFunc<G> compare_func); public void push_head (owned G data); public void push_tail (owned G data); + [Version (since = "2.4")] public void push_nth (owned G data, int n); public G pop_head (); public G pop_tail (); + [Version (since = "2.4")] public G pop_nth (uint n); public unowned G peek_head (); public unowned G peek_tail (); + [Version (since = "2.4")] public unowned G peek_nth (uint n); + [Version (since = "2.4")] public int index (G data); + [Version (since = "2.4")] public void remove (G data); + [Version (since = "2.4")] public void remove_all (G data); + [Version (since = "2.4")] public void delete_link (List<G> link); + [Version (since = "2.4")] public void unlink (List<G> link); + [Version (since = "2.4")] public void insert_before (List<G> sibling, owned G data); + [Version (since = "2.4")] public void insert_after (List<G> sibling, owned G data); + [Version (since = "2.4")] public void insert_sorted (owned G data, CompareDataFunc<G> func); } /* Sequences */ [Compact] + [Version (since = "2.14")] [CCode (free_function = "g_sequence_free")] public class Sequence<G> { [CCode (simple_generics = true)] @@ -4124,39 +4449,44 @@ namespace GLib { public SequenceIter<G> append (owned G data); public SequenceIter<G> prepend (owned G data); public SequenceIter<G> insert_sorted (owned G data, CompareDataFunc<G> cmp_func); + [Version (since = "2.48")] + public bool is_empty (); public SequenceIter<G> insert_sorted_iter (owned G data, SequenceIterCompareFunc<G> iter_cmp); public SequenceIter<G> search (G data, CompareDataFunc<G> cmp_func); public SequenceIter<G> search_iter (G data, SequenceIterCompareFunc<G> iter_cmp); + [Version (since = "2.28")] public SequenceIter<G> lookup (G data, CompareDataFunc<G> cmp_func); + [Version (since = "2.28")] public SequenceIter<G> lookup_iter (G data, SequenceIterCompareFunc<G> iter_cmp); - [Deprecated (since = "vala-0.26", replacement = "SequenceIter.foreach_range")] + [Version (deprecated_since = "vala-0.26", replacement = "SequenceIter.foreach_range")] public static void foreach_range (SequenceIter<G> begin, SequenceIter<G> end, Func<G> func); - [Deprecated (since = "vala-0.26", replacement = "SequenceIter.insert_before")] + [Version (deprecated_since = "vala-0.26", replacement = "SequenceIter.insert_before")] public static SequenceIter<G> insert_before (SequenceIter<G> iter, owned G data); - [Deprecated (since = "vala-0.26", replacement = "SequenceIter.move_to")] + [Version (deprecated_since = "vala-0.26", replacement = "SequenceIter.move_to")] public static void move (SequenceIter<G> src, SequenceIter<G> dest); - [Deprecated (since = "vala-0.26", replacement = "SequenceIter.swap")] + [Version (deprecated_since = "vala-0.26", replacement = "SequenceIter.swap")] public static void swap (SequenceIter<G> src, SequenceIter<G> dest); - [Deprecated (since = "vala-0.26", replacement = "SequenceIter.sort_changed")] + [Version (deprecated_since = "vala-0.26", replacement = "SequenceIter.sort_changed")] public static void sort_changed (SequenceIter<G> iter, CompareDataFunc<G> cmp_func); - [Deprecated (since = "vala-0.26", replacement = "SequenceIter.sort_changed_iter")] + [Version (deprecated_since = "vala-0.26", replacement = "SequenceIter.sort_changed_iter")] public static void sort_changed_iter (SequenceIter<G> iter, SequenceIterCompareFunc<G> iter_cmp); - [Deprecated (since = "vala-0.26", replacement = "SequenceIter.remove")] + [Version (deprecated_since = "vala-0.26", replacement = "SequenceIter.remove")] public static void remove (SequenceIter<G> iter); - [Deprecated (since = "vala-0.26", replacement = "SequenceIter.remove_range")] + [Version (deprecated_since = "vala-0.26", replacement = "SequenceIter.remove_range")] public static void remove_range (SequenceIter<G> begin, SequenceIter<G> end); - [Deprecated (since = "vala-0.26", replacement = "SequenceIter.move_range")] + [Version (deprecated_since = "vala-0.26", replacement = "SequenceIter.move_range")] public static void move_range (SequenceIter<G> dest, SequenceIter<G> begin, SequenceIter<G> end); - [Deprecated (since = "vala-0.26", replacement = "SequenceIter.get")] + [Version (deprecated_since = "vala-0.26", replacement = "SequenceIter.get")] public static unowned G get (SequenceIter<G> iter); - [Deprecated (since = "vala-0.26", replacement = "SequenceIter.set")] + [Version (deprecated_since = "vala-0.26", replacement = "SequenceIter.set")] public static void set (SequenceIter<G> iter, owned G data); - [Deprecated (since = "vala-0.26", replacement = "SequenceIter.range_get_midpoint")] + [Version (deprecated_since = "vala-0.26", replacement = "SequenceIter.range_get_midpoint")] public static SequenceIter<G> range_get_midpoint (SequenceIter<G> begin, SequenceIter<G> end); } [Compact] + [Version (since = "2.14")] [CCode (ref_function = "", unref_function = "")] public class SequenceIter<G> { public bool is_begin (); @@ -4206,29 +4536,36 @@ namespace GLib { public HashTable.full (HashFunc<K>? hash_func, EqualFunc<K>? key_equal_func, DestroyNotify? key_destroy_func, DestroyNotify? value_destroy_func); public void insert (owned K key, owned V value); public void replace (owned K key, owned V value); - [Deprecated (since = "vala-0.26", replacement = "GenericSet.add")] + [Version (since = "2.32", deprecated_since = "vala-0.26", replacement = "GenericSet.add")] public void add (owned K key); public unowned V? lookup (K key); public bool lookup_extended (K lookup_key, out unowned K orig_key, out unowned V value); + [Version (since = "2.32")] public bool contains (K key); public bool remove (K key); + [Version (since = "2.12")] public void remove_all (); public uint foreach_remove (HRFunc<K,V> predicate); [CCode (cname = "g_hash_table_lookup")] public unowned V? @get (K key); [CCode (cname = "g_hash_table_insert")] public void @set (owned K key, owned V value); + [Version (since = "2.14")] public List<unowned K> get_keys (); #if VALA_0_26 + [Version (since = "2.40")] public (unowned K)[] get_keys_as_array (); #endif + [Version (since = "2.14")] public List<unowned V> get_values (); public void @foreach (HFunc<K,V> func); [CCode (cname = "g_hash_table_foreach")] public void for_each (HFunc<K,V> func); + [Version (since = "2.4")] public unowned V? find (HRFunc<K,V> predicate); public uint size (); public bool steal (K key); + [Version (since = "2.12")] public void steal_all (); [CCode (cname = "_vala_g_hash_table_take")] public V? take (K key, out bool exists = null) { @@ -4244,6 +4581,7 @@ namespace GLib { } } + [Version (since = "2.16")] public struct HashTableIter<K,V> { public HashTableIter (GLib.HashTable<K,V> table); public bool next ([CCode (type = "gpointer*")] out unowned K key, [CCode (type = "gpointer*")] out unowned V value); @@ -4252,6 +4590,7 @@ namespace GLib { public unowned GLib.HashTable<K,V> get_hash_table (); } + [Version (since = "2.32")] [Compact, CCode (cname = "GHashTable", lower_case_cprefix = "g_hash_table_", ref_function = "g_hash_table_ref", unref_function = "g_hash_table_unref", type_id = "G_TYPE_HASH_TABLE", type_signature = "a{%s}")] public class GenericSet<T> { [CCode (cname = "g_hash_table_new_full", simple_generics = true)] @@ -4273,6 +4612,7 @@ namespace GLib { } } + [Version (since = "2.32")] [CCode (cname = "GHashTableIter", lower_case_cprefix = "g_hash_table_iter_")] public struct GenericSetIter<T> { [CCode (cname = "_vala_hash_set_next_value")] @@ -4301,8 +4641,10 @@ namespace GLib { public static GLib.EqualFunc<void*> direct_equal; [CCode (cname = "g_int64_hash")] public static GLib.HashFunc<int64?> int64_hash; + [Version (since = "2.22")] [CCode (cname = "g_int64_equal")] public static GLib.EqualFunc<int64?> int64_equal; + [Version (since = "2.22")] [CCode (cname = "g_int_hash")] public static GLib.HashFunc<int?> int_hash; [CCode (cname = "g_int_equal")] @@ -4341,7 +4683,9 @@ namespace GLib { public unowned StringBuilder insert (ssize_t pos, string val); public unowned StringBuilder insert_len (ssize_t pos, string val, ssize_t len); public unowned StringBuilder insert_unichar (ssize_t pos, unichar wc); + [Version (since = "2.14")] public unowned StringBuilder overwrite (size_t pos, string val); + [Version (since = "2.14")] public unowned StringBuilder overwrite_len (size_t pos, string val, ssize_t len); public unowned StringBuilder erase (ssize_t pos = 0, ssize_t len = -1); public unowned StringBuilder truncate (size_t len = 0); @@ -4350,7 +4694,9 @@ namespace GLib { public void printf (string format, ...); [PrintfFormat] public void append_printf (string format, ...); + [Version (since = "2.14")] public void vprintf (string format, va_list args); + [Version (since = "2.14")] public void append_vprintf (string format, va_list args); public string str; @@ -4365,7 +4711,8 @@ namespace GLib { } } - public static Bytes free_to_bytes (StringBuilder str); + [Version (since = "2.34")] + public static Bytes free_to_bytes (owned StringBuilder str); } /* String Chunks */ @@ -4376,20 +4723,25 @@ namespace GLib { public StringChunk (size_t size); public unowned string insert (string str); public unowned string insert_const (string str); + [Version (since = "2.4")] public unowned string insert_len (string str, ssize_t len); + [Version (since = "2.14")] public void clear (); } /* Pointer Arrays */ - [Compact, Deprecated (since = "vala-0.26", replacement="GenericArray")] + [Compact] + [Version (since = "2.22", deprecated_since = "vala-0.26", replacement="GenericArray")] [CCode (ref_function = "g_ptr_array_ref", unref_function = "g_ptr_array_unref", type_id = "G_TYPE_PTR_ARRAY")] public class PtrArray { public PtrArray (); + [Version (since = "2.22")] public PtrArray.with_free_func (GLib.DestroyNotify? element_free_func); [CCode (cname = "g_ptr_array_sized_new")] public PtrArray.sized (uint reserved_size); public void add (void* data); + [Version (since = "2.4")] public void foreach (GLib.Func<void*> func); [CCode (cname = "g_ptr_array_index")] public void* index(uint index); @@ -4397,9 +4749,11 @@ namespace GLib { public void* remove_index (uint index); public bool remove_fast (void *data); public void remove_index_fast (uint index); + [Version (since = "2.4")] public void remove_range (uint index, uint length); public void sort (CompareFunc<void**> compare_func); public void sort_with_data (CompareDataFunc<void**> compare_func); + [Version (since = "2.22")] public void set_free_func (GLib.DestroyNotify? element_free_function); public void set_size (int length); @@ -4411,17 +4765,14 @@ namespace GLib { [CCode (cname = "GPtrArray", cprefix = "g_ptr_array_", ref_function = "g_ptr_array_ref", unref_function = "g_ptr_array_unref", type_id = "G_TYPE_PTR_ARRAY")] [GIR (name = "PtrArray")] public class GenericArray<G> { -#if GLIB_2_30 + [Version (since = "2.30")] [CCode (cname = "g_ptr_array_new_full", simple_generics = true)] public GenericArray (uint reserved_size = 0); -#else - [CCode (cname = "g_ptr_array_new_with_free_func", simple_generics = true)] - public GenericArray (); -#endif public void add (owned G data); public void foreach (GLib.Func<G> func); [CCode (cname = "g_ptr_array_index")] public unowned G get (uint index); + [Version (since = "2.40")] public void insert (int index, owned G data); public bool remove (G data); public void remove_index (uint index); @@ -4460,6 +4811,7 @@ namespace GLib { } [Compact] + [Version (since = "2.32")] [CCode (cprefix = "g_bytes_", ref_function = "g_bytes_ref", unref_function = "g_bytes_unref", type_id = "G_TYPE_BYTES")] public class Bytes { public Bytes ([CCode (array_length_type = "gsize")] uint8[] data); @@ -4502,17 +4854,21 @@ namespace GLib { /* Byte Arrays */ [Compact] + [Version (since = "2.22")] [CCode (cprefix = "g_byte_array_", ref_function = "g_byte_array_ref", unref_function = "g_byte_array_unref", type_id = "G_TYPE_BYTE_ARRAY")] public class ByteArray { public ByteArray (); [CCode (cname = "g_byte_array_sized_new")] public ByteArray.sized (uint reserved_size); + [Version (since = "2.32")] public ByteArray.take (owned uint8[] data); public void append (uint8[] data); + [Version (since = "2.32")] public static GLib.Bytes free_to_bytes (owned GLib.ByteArray array); public void prepend (uint8[] data); public void remove_index (uint index); public void remove_index_fast (uint index); + [Version (since = "2.4")] public void remove_range (uint index, uint length); public void sort (CompareFunc<int8> compare_func); public void sort_with_data (CompareDataFunc<int8> compare_func); @@ -4543,6 +4899,7 @@ namespace GLib { public class Node<G> { public Node(owned G? data = null); public Node<unowned G> copy (); + public Node<G> copy_deep (CopyFunc<G> copy_func); public unowned Node<G> insert (int position, owned Node<G> node); public unowned Node<G> insert_before (Node<G> sibling, owned Node<G> node); public unowned Node<G> insert_after (Node<G> sibling, owned Node<G> node); @@ -4611,11 +4968,15 @@ namespace GLib { public struct Datalist<G> { public Datalist (); public void clear (); + [Version (since = "2.34")] + public G id_dup_data (Quark key_id, DuplicateFunc dup_func); public unowned G id_get_data (Quark key_id); public void id_set_data (Quark key_id, owned G data); public void id_set_data_full (Quark key_id, owned G data, DestroyNotify? destroy_func); public void id_remove_data (Quark key_id); public G id_remove_no_notify (Quark key_id); + [Version (since = "2.34")] + public bool id_replace_data (Quark key_id, G oldval, owned G newval, GLib.DestroyNotify? destroy, out GLib.DestroyNotify? old_destroy); public void @foreach (DataForeachFunc func); public unowned G get_data (string key); public void set_data_full (string key, owned G data, DestroyNotify? destry_func); @@ -4625,10 +4986,12 @@ namespace GLib { } public delegate void DataForeachFunc<G> (Quark key_id, G data); + public delegate G DuplicateFunc<G> (G data); /* GArray */ [Compact] + [Version (since = "2.22")] [CCode (ref_function = "g_array_ref", unref_function = "g_array_unref", type_id = "G_TYPE_ARRAY")] public class Array<G> { [CCode (cname = "len")] @@ -4670,11 +5033,12 @@ namespace GLib { public delegate int TreeSearchFunc<K> (K key); [Compact] + [Version (since = "2.22")] [CCode (ref_function = "g_tree_ref", unref_function = "g_tree_unref")] public class Tree<K,V> { [CCode (cname = "g_tree_new_full", simple_generics = true)] public Tree (CompareDataFunc<K> key_compare_func); - [Deprecated (since = "vala-0.20", replacement = "Tree ()")] + [Version (deprecated_since = "vala-0.20", replacement = "Tree ()")] public Tree.with_data (CompareDataFunc<K> key_compare_func); public Tree.full (CompareDataFunc<K> key_compare_func, DestroyNotify? key_destroy_func, DestroyNotify? value_destroy_func); public void insert (owned K key, owned V value); @@ -4693,26 +5057,36 @@ namespace GLib { /* Internationalization */ + [Version (since = "2.4")] [CCode (cname = "_", cheader_filename = "glib.h,glib/gi18n-lib.h")] public static unowned string _ (string str); + [Version (since = "2.4")] [CCode (cname = "Q_", cheader_filename = "glib.h,glib/gi18n-lib.h")] public static unowned string Q_ (string str); + [Version (since = "2.4")] [CCode (cname = "N_", cheader_filename = "glib.h,glib/gi18n-lib.h")] public static unowned string N_ (string str); + [Version (since = "2.16")] [CCode (cname = "C_", cheader_filename = "glib.h,glib/gi18n-lib.h")] public static unowned string C_ (string context, string str); + [Version (since = "2.18")] [CCode (cname = "NC_", cheader_filename = "glib.h,glib/gi18n-lib.h")] public static unowned string NC_ (string context, string str); [CCode (cname = "ngettext", cheader_filename = "glib.h,glib/gi18n-lib.h")] public static unowned string ngettext (string msgid, string msgid_plural, ulong n); + [Version (since = "2.18")] [CCode (cname = "g_dgettext", cheader_filename = "glib/gi18n-lib.h")] public static unowned string dgettext (string? domain, string msgid); + [Version (since = "2.26")] [CCode (cname = "g_dcgettext", cheader_filename = "glib/gi18n-lib.h")] public static unowned string dcgettext (string? domain, string msgid, int category); + [Version (since = "2.18")] [CCode (cname = "g_dngettext", cheader_filename = "glib/gi18n-lib.h")] public static unowned string dngettext (string? domain, string msgid, string msgid_plural, ulong n); + [Version (since = "2.16")] [CCode (cname = "g_dpgettext", cheader_filename = "glib/gi18n-lib.h")] public static unowned string dpgettext (string? domain, string msgctxid, size_t msgidoffset); + [Version (since = "2.18")] [CCode (cname = "g_dpgettext2", cheader_filename = "glib/gi18n-lib.h")] public static unowned string dpgettext2 (string? domain, string context, string msgid); @@ -4736,8 +5110,10 @@ namespace GLib { public static unowned string? textdomain (string? domainname); [CCode (cname = "bind_textdomain_codeset", cheader_filename = "glib/gi18n-lib.h")] public static unowned string? bind_textdomain_codeset (string domainname, string? codeset); + [Version (since = "2.6")] [CCode (cname = "g_get_language_names", array_length = false, array_null_terminated = true)] public static unowned string[] get_language_names (); + [Version (since = "2.4")] [CCode (cname = "g_strip_context", cheader_filename = "glib/gi18n-lib.h")] public static unowned string strip_context (string msgid, string msgval); } @@ -4785,6 +5161,7 @@ namespace GLib { public const uint @2_42; public const uint @2_44; public const uint @2_46; + public const uint @2_48; [CCode (cname = "glib_binary_age")] public const uint binary_age; @@ -4793,20 +5170,36 @@ namespace GLib { } namespace Win32 { + public enum OSType { + [CCode (cname = "G_WIN32_OS_ANY")] + ANY, + [CCode (cname = "G_WIN32_OS_WORKSTATION")] + WORKSTATION, + [CCode (cname = "G_WIN32_OS_SERVER")] + SERVER, + } + [Version (since = "2.44")] + public bool check_windows_version (int major, int minor, int spver, GLib.Win32.OSType os_type); + public string error_message (int error); public string getlocale (); + [Version (since = "2.16")] public string get_package_installation_directory_of_module (void* hmodule); public uint get_windows_version (); + [Version (since = "2.8")] public string locale_filename_from_utf8 (string utf8filename); [CCode (cname = "G_WIN32_HAVE_WIDECHAR_API")] public bool have_widechar_api (); [CCode (cname = "G_WIN32_IS_NT_BASED")] public bool is_nt_based (); + [Version (since = "2.40")] + [CCode (array_length = false, array_null_terminated = true)] public string[] get_command_line (); } [Compact] [Immutable] + [Version (since = "2.24")] [CCode (copy_function = "g_variant_type_copy", free_function = "g_variant_type_free", type_id = "G_TYPE_VARIANT_TYPE")] public class VariantType { [CCode (cname = "G_VARIANT_TYPE_BOOLEAN")] @@ -4861,6 +5254,7 @@ namespace GLib { public static VariantType BYTESTRING; [CCode (cname = "G_VARIANT_TYPE_BYTESTRING_ARRAY")] public static VariantType BYTESTRING_ARRAY; + [Version (since = "2.30")] [CCode (cname = "G_VARIANT_TYPE_VARDICT")] public static VariantType VARDICT; @@ -4899,6 +5293,7 @@ namespace GLib { } [Compact] + [Version (since = "2.24")] [CCode (ref_function = "g_variant_ref", unref_function = "g_variant_unref", ref_sink_function = "g_variant_ref_sink", type_id = "G_TYPE_VARIANT", marshaller_type_name = "VARIANT", param_spec_function = "g_param_spec_variant", get_value_function = "g_value_get_variant", set_value_function = "g_value_set_variant", take_value_function = "g_value_take_variant", type_signature = "v")] public class Variant { [CCode (has_type_id = false)] @@ -4912,8 +5307,10 @@ namespace GLib { public unowned string get_type_string (); public bool is_of_type (VariantType type); public bool is_container (); + [Version (since = "2.26")] public bool is_floating (); public Class classify (); + [Version (since = "2.26")] public int compare (Variant other); public Variant.boolean (bool value); @@ -4927,6 +5324,7 @@ namespace GLib { public Variant.handle (int32 value); public Variant.double (double value); public Variant.string (string value); + [Version (since = "2.26")] public Variant.bytestring (string value); public Variant.object_path (string object_path); public static bool is_object_path (string object_path); @@ -4945,7 +5343,9 @@ namespace GLib { public double get_double (); public unowned string get_string (out size_t length = null); public string dup_string (out size_t length = null); + [Version (since = "2.26")] public unowned string get_bytestring (); + [Version (since = "2.26")] public string dup_bytestring (out size_t length); public Variant.strv (string[] value); @@ -4958,27 +5358,31 @@ namespace GLib { [CCode (array_length_type = "size_t")] public string[] dup_strv (); + [Version (since = "2.26")] public Variant.bytestring_array (string[] value); + [Version (since = "2.26")] [CCode (array_length_type = "size_t")] #if VALA_0_26 public (unowned string)[] get_bytestring_array (); #else public string*[] get_bytestring_array (); #endif + [Version (since = "2.26")] [CCode (array_length_type = "size_t")] public string[] dup_bytestring_array (); -#if GLIB_2_30 + [Version (since = "2.30")] public Variant.objv (string[] value); + [Version (since = "2.30")] [CCode (array_length_type = "size_t")] #if VALA_0_26 public (unowned string)[] get_objv (); #else public string*[] get_objv (); #endif + [Version (since = "2.30")] [CCode (array_length_type = "size_t")] public string[] dup_objv (); -#endif public Variant (string format, ...); // note: the function changes its behaviour when end_ptr is null, so 'out char *' is wrong @@ -4989,6 +5393,7 @@ namespace GLib { public Variant.variant (Variant value); public Variant.maybe (VariantType? child_type, Variant? child); public Variant.array (VariantType? child_type, Variant[] children); + [Version (since = "2.32")] [CCode (simple_generics = true)] public static Variant new_fixed_array<T> (VariantType? element_type, [CCode (array_length_type = "gsize")] T[] elements, size_t element_size); public Variant.tuple (Variant[] children); @@ -5000,7 +5405,9 @@ namespace GLib { public Variant get_child_value (size_t index); public void get_child (size_t index, string format_string, ...); + [Version (since = "2.28")] public Variant? lookup_value (string key, VariantType? expected_type); + [Version (since = "2.28")] public bool lookup (string key, string format_string, ...); public size_t get_size (); @@ -5025,17 +5432,24 @@ namespace GLib { public static Variant parse (VariantType? type, string text, char *limit = null, char **endptr = null) throws GLib.VariantParseError; public Variant.parsed (string format_string, ...); + [Version (since = "2.34")] public bool check_format_string (string format_string, bool copy_only); + [Version (since = "2.36")] public Variant.from_bytes (VariantType type, Bytes bytes, bool trusted); + [Version (since = "2.36")] public Bytes get_data_as_bytes (); + [Version (since = "2.38")] public Variant.printf (string format_string, ...); + [Version (since = "2.38")] public Variant.take_string (string str); + [Version (since = "2.40")] public static void parse_error_print_context (GLib.VariantParseError error, string source_str); } + [Version (since = "2.24")] public errordomain VariantParseError { FAILED, BASIC_TYPE_EXPECTED, @@ -5058,6 +5472,7 @@ namespace GLib { } [Compact] + [Version (since = "2.24")] public class VariantIter { public VariantIter (Variant value); public size_t n_children (); @@ -5066,6 +5481,7 @@ namespace GLib { } [Compact] + [Version (since = "2.24")] [CCode (ref_function = "g_variant_builder_ref", unref_function = "g_variant_builder_unref")] public class VariantBuilder { public VariantBuilder (VariantType type); @@ -5077,6 +5493,7 @@ namespace GLib { public Variant end (); } + [Version (since = "2.40")] [Compact, CCode (ref_function = "g_variant_dict_ref", unref_function = "g_variant_dict_unref")] public class VariantDict { public VariantDict (GLib.Variant? from_asv = null); @@ -5107,6 +5524,7 @@ namespace GLib { public static bool likely (bool expression); [CCode (cname = "G_UNLIKELY", cheader_filename = "glib.h")] public static bool unlikely (bool expression); + [Version (since = "2.20")] [CCode (cname = "G_STATIC_ASSERT", cheader_filename = "glib.h")] public static void static_assert (bool expression); @@ -5122,6 +5540,7 @@ namespace GLib { /* Unix-specific functions. All of these have to include glib-unix.h. */ namespace Unix { + [Version (since = "2.30")] [CCode (cheader_filename = "glib-unix.h", cname = "g_unix_signal_add_full")] public static uint signal_add (int signum, owned GLib.SourceFunc handler, [CCode (pos = 0.9)] int priority = Priority.DEFAULT); @@ -5130,8 +5549,10 @@ namespace GLib { public SignalSource (int signum); } + [Version (since = "2.30")] [CCode (cheader_filename = "glib-unix.h")] public static bool open_pipe ([CCode (array_length = false, array_null_terminated = false)] int[] fds, int flags) throws GLib.Error; + [Version (since = "2.30")] [CCode (cheader_filename = "glib-unix.h")] public static bool set_fd_nonblocking (int fd, bool nonblock) throws GLib.Error; } |