[vala/wip/x-version: 7/24] glib-2.0: Use [Version] instead of [Deprecated] and [Experimental]
- From: Luca Bruno <lucabru src gnome org>
- To: commits-list gnome org
- Cc:
- Subject: [vala/wip/x-version: 7/24] glib-2.0: Use [Version] instead of [Deprecated] and [Experimental]
- Date: Thu, 25 Dec 2014 20:52:03 +0000 (UTC)
commit edb9547e993242b3abe8708d8354355a719f3efa
Author: Florian Brosch <flo brosch gmail com>
Date: Sat May 17 22:21:21 2014 +0200
glib-2.0: Use [Version] instead of [Deprecated] and [Experimental]
vapi/glib-2.0.vapi | 420 +++++++++++++++++++++++++++++++++++++++++++++------
1 files changed, 370 insertions(+), 50 deletions(-)
---
diff --git a/vapi/glib-2.0.vapi b/vapi/glib-2.0.vapi
index 6118a59..9bb4419 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")]
@@ -354,8 +360,10 @@ public struct ssize_t {
[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 +385,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 +405,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 +446,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 +493,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 +534,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 +588,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 +620,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 +852,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 +862,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 +873,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 +884,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 +907,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 +965,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 +985,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 +1060,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 +1093,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 +1120,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);
@@ -1133,28 +1166,28 @@ public class string {
public bool is_ascii ();
[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 (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)]
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 +1196,7 @@ public class string {
}
}
- [Deprecated (replacement = "string.length")]
+ [Version (replacement = "string.length")]
[CCode (cname = "strlen")]
public size_t size ();
@@ -1185,7 +1218,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 +1542,24 @@ 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 +1599,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 +1612,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 +1636,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 +1644,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 +1676,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,17 +1693,22 @@ 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);
@@ -1665,10 +1719,13 @@ namespace GLib {
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);
public void set_ready_time (int64 ready_time);
public int64 get_ready_time ();
@@ -1676,8 +1733,10 @@ namespace GLib {
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
@@ -1732,6 +1791,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)]
@@ -1744,30 +1804,33 @@ 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")]
@@ -1775,12 +1838,13 @@ namespace GLib {
}
#if GLIB_2_32
+ [Version (since = "2.32"))]
[CCode (destroy_function = "g_mutex_clear", lvalue_access = false)]
public struct Mutex {
#else
[Compact]
+ [Version (deprecated_since = "glib-2.32", replacement = "Mutex (with --target-glib=2.32)")]
[CCode (free_function = "g_mutex_free")]
- [Deprecated (since = "glib-2.32", replacement = "Mutex (with --target-glib=2.32)")]
public class Mutex {
#endif
public Mutex ();
@@ -1789,6 +1853,7 @@ namespace GLib {
public void unlock ();
}
+ [Version (since = "2.32")]
[CCode (destroy_function = "g_rec_mutex_clear")]
public struct RecMutex {
public RecMutex ();
@@ -1797,6 +1862,7 @@ namespace GLib {
public void unlock ();
}
+ [Version (since = "2.32")]
[CCode (destroy_function = "g_rw_lock_clear")]
public struct RWLock {
public RWLock ();
@@ -1808,8 +1874,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 +1884,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 +1894,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,7 +1916,7 @@ 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 ();
@@ -1858,31 +1924,36 @@ namespace GLib {
}
#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)")]
+ [Version (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,11 +1973,11 @@ 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;
@@ -1918,8 +1989,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 ();
}
@@ -1928,20 +2002,24 @@ 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 ();
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 ();
public G? try_pop_unlocked ();
@@ -1957,6 +2035,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);
@@ -1985,9 +2064,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);
@@ -2153,7 +2234,9 @@ 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]
@@ -2214,6 +2297,7 @@ namespace GLib {
public void error (string format, ...);
[Diagnostics]
[PrintfFormat]
+ [Version (since = "2.6")]
public void debug (string format, ...);
[Diagnostics]
[PrintfFormat]
@@ -2223,6 +2307,7 @@ namespace GLib {
namespace Log {
public static uint set_handler (string? log_domain, LogLevelFlags log_levels, 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;
@@ -2246,6 +2331,7 @@ namespace GLib {
/* String Utility Functions */
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);
public bool strv_contains ([CCode (array_length = false, array_null_terminated = true)] string[]
str_array, string str);
@@ -2271,7 +2357,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);
}
@@ -2286,6 +2374,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);
@@ -2297,6 +2386,7 @@ namespace GLib {
/* Data Checksums */
+ [Version (since = "2.16")]
[CCode (cprefix = "G_CHECKSUM_", has_type_id = false)]
public enum ChecksumType {
MD5,
@@ -2308,6 +2398,7 @@ namespace GLib {
}
[Compact]
+ [Version (since = "2.16")]
[CCode (free_function = "g_checksum_free")]
public class Checksum {
public Checksum (ChecksumType checksum_type);
@@ -2326,6 +2417,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);
@@ -2333,8 +2425,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);
}
@@ -2351,12 +2445,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 {
@@ -2433,7 +2531,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);
@@ -2456,6 +2556,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);
@@ -2526,6 +2627,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 {
@@ -2537,6 +2639,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);
@@ -2596,6 +2699,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);
@@ -2614,9 +2718,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")]
@@ -2641,8 +2747,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")]
@@ -2651,28 +2759,38 @@ 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 ();
+ [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")]
@@ -2683,24 +2801,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,
@@ -2729,6 +2853,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")]
@@ -2752,12 +2877,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 {
@@ -2916,7 +3043,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 {
@@ -2930,6 +3057,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);
}
@@ -2946,6 +3074,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 ();
@@ -3004,6 +3133,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;
@@ -3116,6 +3246,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")]
@@ -3187,6 +3318,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;
@@ -3194,19 +3326,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);
@@ -3221,6 +3358,7 @@ namespace GLib {
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);
}
@@ -3235,19 +3373,25 @@ 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 unowned string mkdtemp (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;
@@ -3274,10 +3418,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);
}
@@ -3305,14 +3454,21 @@ 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;
public bool parse_strv ([CCode (array_length = false, array_null_terminated = true)] ref
string[] argv) throws OptionError;
@@ -3320,6 +3476,7 @@ namespace GLib {
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);
@@ -3369,6 +3526,7 @@ namespace GLib {
}
[Compact]
+ [Version (since = "2.6")]
[CCode (free_function = "g_option_group_free")]
public class OptionGroup {
public OptionGroup (string name, string description, string help_description, void* user_data
= null, DestroyNotify? destroy = null);
@@ -3386,6 +3544,7 @@ namespace GLib {
/* Perl-compatible regular expressions */
+ [Version (since = "2.14")]
public errordomain RegexError {
COMPILE,
OPTIMIZE,
@@ -3446,6 +3605,7 @@ namespace GLib {
CHARACTER_VALUE_TOO_LARGE
}
+ [Version (since = "2.14")]
[CCode (cprefix = "G_REGEX_", has_type_id = false)]
[Flags]
public enum RegexCompileFlags {
@@ -3468,6 +3628,7 @@ namespace GLib {
JAVASCRIPT_COMPAT
}
+ [Version (since = "2.14")]
[CCode (cprefix = "G_REGEX_MATCH_", has_type_id = false)]
[Flags]
public enum RegexMatchFlags {
@@ -3489,11 +3650,14 @@ 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.26")]
public RegexMatchFlags get_match_flags ();
public int get_max_backref ();
public int get_max_lookbehind ();
@@ -3517,12 +3681,15 @@ 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
+ [Version (since = "2.14")]
[CCode (free_function = "g_match_info_free")]
#endif
public class MatchInfo {
@@ -3563,6 +3730,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")]
@@ -3571,11 +3739,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 ();
}
@@ -3614,9 +3787,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;
}
@@ -3634,14 +3810,17 @@ 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
+ [Version (since = "2.6")]
[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;
@@ -3659,8 +3838,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;
@@ -3670,6 +3852,7 @@ 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;
@@ -3679,13 +3862,17 @@ namespace GLib {
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;
@@ -3701,6 +3888,7 @@ namespace GLib {
KEEP_TRANSLATIONS
}
+ [Version (since = "2.14")]
[CCode (cprefix = "G_KEY_FILE_DESKTOP_")]
namespace KeyFileDesktop {
public const string GROUP;
@@ -3736,6 +3924,7 @@ namespace GLib {
/* Bookmark file parser */
[Compact]
+ [Version (since = "2.12")]
[CCode (free_function = "g_bookmark_file_free")]
public class BookmarkFile {
public BookmarkFile ();
@@ -3799,9 +3988,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 ();
@@ -3809,45 +4001,70 @@ namespace GLib {
public static bool perf ();
public static bool verbose ();
public static bool quiet ();
+ [Version (since = "2.16")]
public static int run ();
+ [Version (since = "2.16")]
#if GLIB_2_26
+ [Version (since = "2.26")]
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);
public static string build_filename (GLib.Test.FileType file_type, params string[]
path_segments);
+ [Version (since = "2.30")]
public static void fail ();
public static bool failed ();
public static unowned string get_dir (GLib.Test.FileType file_type);
public static unowned string get_filename (GLib.Test.FileType file_type, params string[]
path_segments);
public static void incomplete (string msg);
[PrintfFormat]
+ [Version (since = "2.16")]
public static void message (string format, ...);
public static void set_nonfatal_assertions ();
public static void skip (string msg);
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 ();
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);
}
@@ -3856,8 +4073,10 @@ 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
+ [Version (since = "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);
@@ -3867,23 +4086,32 @@ namespace GLib {
[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
+ [Version (deprecated_since = "2.26", replacement = "--target-glib 2.26")]
public delegate void TestFunc (void* fixture);
+ [Version (deprecated_since = "2.26", replacement = "--target-glib 2.26")]
public delegate void TestDataFunc ();
#endif
@@ -3935,6 +4163,7 @@ namespace GLib {
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 ()]
@@ -3992,6 +4221,7 @@ namespace GLib {
public SList<unowned G> copy ();
[ReturnsModifiedPointer ()]
public void reverse ();
+ [Version (since = "2.10")]
[ReturnsModifiedPointer ()]
public void insert_sorted_with_data (owned G data, CompareDataFunc<G> compare_func);
[ReturnsModifiedPointer ()]
@@ -4023,6 +4253,7 @@ 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;
@@ -4040,38 +4271,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)]
@@ -4089,36 +4338,39 @@ namespace GLib {
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 ();
@@ -4168,29 +4420,35 @@ 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
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) {
@@ -4206,6 +4464,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);
@@ -4214,6 +4473,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)]
@@ -4235,6 +4495,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")]
@@ -4263,8 +4524,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")]
@@ -4303,7 +4566,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);
@@ -4312,7 +4577,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;
@@ -4338,20 +4605,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);
@@ -4359,9 +4631,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);
@@ -4374,9 +4648,11 @@ namespace GLib {
[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
+ [Version (since = "2.22")]
[CCode (cname = "g_ptr_array_new_with_free_func", simple_generics = true)]
public GenericArray ();
#endif
@@ -4422,6 +4698,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);
@@ -4464,17 +4741,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);
@@ -4591,6 +4872,7 @@ namespace GLib {
/* 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")]
@@ -4632,11 +4914,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);
@@ -4655,26 +4938,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);
@@ -4698,8 +4991,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);
}
@@ -4753,8 +5048,10 @@ namespace GLib {
namespace Win32 {
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 ();
@@ -4765,6 +5062,7 @@ namespace GLib {
[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")]
@@ -4819,6 +5117,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;
@@ -4857,6 +5156,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)]
@@ -4870,8 +5170,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);
@@ -4885,6 +5187,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);
@@ -4903,7 +5206,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);
@@ -4916,24 +5221,30 @@ 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
@@ -4958,7 +5269,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 ();
@@ -4994,6 +5307,7 @@ namespace GLib {
public static void parse_error_print_context (GLib.VariantParseError error, string
source_str);
}
+ [Version (since = "2.24")]
public errordomain VariantParseError {
FAILED,
BASIC_TYPE_EXPECTED,
@@ -5016,6 +5330,7 @@ namespace GLib {
}
[Compact]
+ [Version (since = "2.24")]
public class VariantIter {
public VariantIter (Variant value);
public size_t n_children ();
@@ -5024,6 +5339,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);
@@ -5065,6 +5381,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);
@@ -5080,6 +5397,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);
@@ -5088,8 +5406,10 @@ namespace GLib {
public SignalSource (int signum);
}
+ [Version (since = "2.30")]
[CCode (cheader_filename = "glib-unix.h")]
public static bool open_pipe (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;
}
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]
