Packages

glib-2.0

glib-2.0

Description:

Content:

Namespaces:

GLib -

Classes:

MainLoop - The `GMainLoop` struct is an opaque data type representing the main event loop of a GLib or GTK+ application.
MainContext - The `GMainContext` struct is an opaque data type representing a set of sources to be handled in a main loop.
TimeoutSource -
IdleSource -
ChildWatchSource -
Source -
SourceCallbackFuncs - The `GSourceCallbackFuncs` struct contains functions for managing callback objects.
Thread - The Thread struct represents a running thread.
Mutex - The Mutex struct is an opaque data structure to represent a mutex (mutual exclusion).
Private -
Cond - The Cond struct is an opaque data structure that represents a condition.
ThreadPool - The ThreadPool struct represents a thread pool.
AsyncQueue - The GAsyncQueue struct is an opaque data structure which represents an asynchronous queue.
MemVTable - A set of functions used to perform memory allocation.
IOChannel - A data structure representing an IO Channel.
IOSource -
Error - The `GError` structure contains information about an error that has occurred.
Checksum - An opaque structure representing a checksumming operation.
Hmac - An opaque structure representing a HMAC operation.
DateTime - `GDateTime` is an opaque structure whose members cannot be accessed directly.
TimeZone - TimeZone is an opaque structure whose members cannot be accessed directly.
Rand - The GRand struct is an opaque data structure.
Scanner - The data structure representing a lexical scanner.
Completion -
Timer - Opaque datatype that records a start time.
FileStream -
Dir - An opaque structure representing an opened directory.
MappedFile - The MappedFile represents a file mapping created with MappedFile.
OptionContext - A `GOptionContext` struct defines which options are accepted by the commandline option parser.
OptionGroup - A `GOptionGroup` struct defines the options in a single group.
Regex - The g_regex_*() functions implement regular expression pattern matching using syntax and semantics similar to Perl regular expression.
MatchInfo - A GMatchInfo is an opaque struct used to return information about matches.
MarkupParseContext - A parse context is used to parse a stream of bytes that you expect to contain marked-up text.
KeyFile - The GKeyFile struct contains only private data and should not be accessed directly.
BookmarkFile - The `GBookmarkFile` structure contains only private data and should not be directly accessed.
TestCase - An opaque structure representing a test case.
TestSuite - An opaque structure representing a test suite.
List - The List struct is used for each element in a doubly-linked list.
SList - The SList struct is used for each element in the singly-linked list.
Queue - Contains the public fields of a Queue.
Sequence - The Sequence struct is an opaque data type representing a sequence data type.
SequenceIter - The SequenceIter struct is an opaque data type representing an iterator pointing into a Sequence .
HashTable -
GenericSet - The GenericSet struct is an opaque data structure to represent a Hash Table.
StringBuilder - The GString struct contains the public fields of a GString.
StringChunk - An opaque data structure representing String Chunks.
PtrArray -
GenericArray - Contains the public fields of a pointer array.
Bytes - A simple refcounted data type representing an immutable sequence of zero or more bytes from an unspecified origin.
ByteArray - Contains the public fields of a GByteArray.
Node - The Node struct represents one node in a n-ary tree.
Array - Contains the public fields of a GArray.
Tree - The GTree struct is an opaque data structure representing a balanced binary tree.
PatternSpec - A GPatternSpec struct is the 'compiled' form of a pattern.
VariantType - This section introduces the GVariant type system.
Variant - Variant is a variant datatype; it stores a value along with information about the type of that value.
VariantIter - VariantIter is an opaque data structure and can only be accessed using the following functions.
VariantBuilder - A utility type for constructing container-type Variant instances.
VariantDict - VariantDict is a mutable interface to Variant dictionaries.
ObjectPath -
BusName -

Structs:

Pid - A type which is used to hold a process identification.
PollFD - Represents a file descriptor, which events to poll for, and which events occurred.
SourceFuncs - The `GSourceFuncs` struct contains a table of functions used to handle event sources in a generic manner.
RecMutex - The GRecMutex struct is an opaque data structure to represent a recursive mutex.
RWLock - The GRWLock struct is an opaque data structure to represent a reader-writer lock.
StaticMutex -
StaticRecMutex -
StaticRWLock -
StaticPrivate -
Once - A Once struct controls a one-time initialization function.
DebugKey - Associates a string with a bit flag.
IConv - The GIConv struct wraps an iconv conversion descriptor.
TimeVal - Represents a precise time, with seconds and microseconds.
DateDay - Integer representing a day of the month; between 1 and 31.
DateYear - Integer representing a year; BAD_YEAR is the invalid value.
Date - Represents a day between January 1, Year 1 and a few thousand years in the future.
Time -
TimeSpan - A value representing an interval of time, in microseconds.
ScannerConfig - Specifies the Scanner parser configuration.
TokenValue - A union holding the value of the token.
UTimBuf -
Stat -
OptionEntry - A GOptionEntry struct defines a single option.
MarkupParser - Any of the fields in MarkupParser can be null, in which case they will be ignored.
HashTableIter -
GenericSetIter - A GHashTableIter structure represents an iterator that can be used to iterate over the elements of a GenericSet.
Quark - A GQuark is a non-zero integer which uniquely identifies a particular string.
Datalist -

Enums:

ByteOrder -
ThreadPriority -
OnceStatus - The possible statuses of a one-time initialization function controlled by a Once struct.
SliceConfig -
SeekType - An enumeration specifying the base position for a seek_position operation.
IOStatus - Stati returned by most of the IOFuncs functions.
IOCondition - A bitwise combination representing a condition to watch for on an event source.
IOFlags - Specifies properties of a IOChannel.
LogLevelFlags - Flags specifying the level of log messages.
ChecksumType - The hashing algorithm to be used by Checksum when performing the digest of some data.
DateMonth - Enumeration representing a month; values are JANUARY, FEBRUARY, etc.
DateWeekday - Enumeration representing a day of the week; MONDAY, TUESDAY, etc.
DateDMY - This enumeration isn't used in the API, but may be useful if you need to mark a number as a day, month, or year.
TimeType - Disambiguates a given time in two ways.
UserDirectory - These are logical ids for special directories which are defined depending on the platform used.
FormatSizeFlags - Flags to modify the format of the string returned by format_size.
TokenType - The possible types of token returned from each get_next_token call.
ErrorType - The possible errors, used in the v_error field of TokenValue, when the token is a g_token_error.
SpawnFlags - Flags passed to spawn_sync, spawn_async and spawn_async_with_pipes.
ProcessSignal -
FileTest - A test to perform on a file using test.
FileSeek -
OptionArg - The OptionArg enum values determine which type of extra argument the options expect to find.
OptionFlags - Flags which modify individual options.
RegexCompileFlags - Flags specifying compile-time options.
RegexMatchFlags - Flags specifying match-time options.
MarkupParseFlags - Flags that affect the behaviour of the parser.
KeyFileFlags - Flags which influence the parsing.
TestSubprocessFlags - Flags to pass to trap_subprocess to control input and output.
TestTrapFlags - Test traps are guards around forked tests.
TraverseFlags - Specifies which nodes are visited during several of the tree functions, including traverse and find.
TraverseType - Specifies the type of traveral performed by g_tree_traverse, traverse and find.
LocaleCategory -
UnicodeScript - The UnicodeScript enumeration identifies different writing systems.
UnicodeType - These are the possible character classifications from the Unicode specification.
UnicodeBreakType - These are the possible line break classifications.
NormalizeMode - Defines how a Unicode string is transformed in a canonical form, standardizing such issues as whether a character with an accent is represented as a base character and combining accent or as a single precomposed character.

Error domains:

ThreadError - Possible errors of thread related functions.
IOChannelError - Error codes returned by IOChannel operations.
ConvertError - Error codes returned by character set conversion routines.
SpawnError - Error codes returned by spawning processes.
FileError - Values corresponding to errno codes returned from file operations on UNIX.
ShellError - Error codes returned by shell functions.
OptionError - Error codes returned by option parsing.
RegexError - Error codes returned by regular expressions functions.
MarkupError - Error codes returned by markup parsing.
KeyFileError - Error codes returned by key file parsing.
BookmarkFileError - Error codes returned by bookmark file parsing.
VariantParseError - Error codes returned by parsing text-format GVariants.

Constants:

public const ByteOrder BYTE_ORDER

Delegates:

public delegate int PollFunc (PollFD[] ufds, int timeout_)
Specifies the type of function passed to set_poll_func.
public delegate void ChildWatchFunc (Pid pid, int status)
Prototype of a GChildWatchSource callback, called when a child process has exited.
public delegate void SourceDummyMarshal ()
This is just a placeholder for ClosureMarshal, which cannot be used here for dependency reasons.
public delegate bool SourcePrepareFunc (Source source, out int timeout_)
public delegate bool SourceCheckFunc (Source source)
public delegate bool SourceDispatchFunc (Source source, SourceFunc _callback)
public delegate void SourceFinalizeFunc (Source source)
public delegate void SourceCallbackRefFunc (void* cb_data)
public delegate void SourceCallbackUnrefFunc (void* cb_data)
public delegate void SourceCallbackGetFunc (void* cb_data, Source source, SourceFunc func)
public delegate bool SourceFunc ()
Specifies the type of function passed to g_timeout_add, add_full, g_idle_add, and add_full.
public delegate G ThreadFunc ()
public delegate void Func (G data)
public delegate G OnceFunc ()
Specifies the type of the func functions passed to g_thread_new or g_thread_try_new.
public delegate void ThreadPoolFunc (owned G data)
Specifies the type of functions passed to @foreach and @foreach.
public delegate bool IOFunc (IOChannel source, IOCondition condition)
Specifies the type of function passed to add_watch or add_watch_full, which is called when the requested condition on a IOChannel is satisfied.
public delegate void PrintFunc (string text)
Specifies the type of the print handler functions.
public delegate void LogFunc (string? log_domain, LogLevelFlags log_levels, string message)
Specifies the prototype of log handler functions.
public delegate void FreeFunc (void* data)
Declares a type of function which takes an arbitrary data pointer argument and has no return value.
public delegate void VoidFunc ()
Declares a type of function which takes no arguments and has no return value.
public delegate void ScannerMsgFunc (Scanner scanner, string message, bool error)
Specifies the type of the message handler function.
public delegate string CompletionFunc (void* item)
public delegate int CompletionStrncmpFunc (string s1, string s2, size_t n)
public delegate void SpawnChildSetupFunc ()
Specifies the type of the setup function passed to spawn_async, spawn_sync and spawn_async_with_pipes, which can, in very limited ways, be used to affect the child's execution.
public delegate void SignalHandlerFunc (int signum)
public delegate unowned string TranslateFunc (string str)
The type of functions which are used to translate user-visible strings, for <option>--help</option> output.
public delegate bool OptionParseFunc (OptionContext context, OptionGroup group, void* data) throws OptionError
The type of function that can be called before and after parsing.
public delegate void OptionErrorFunc (OptionContext context, OptionGroup group, void* data, ref Error error)
The type of function to be used as callback when a parse error occurs.
public delegate bool RegexEvalCallback (MatchInfo match_info, StringBuilder result)
Specifies the type of the function passed to replace_eval.
public delegate void MarkupParserStartElementFunc (MarkupParseContext context, string element_name, string[] attribute_names, string[] attribute_values) throws MarkupError
public delegate void MarkupParserEndElementFunc (MarkupParseContext context, string element_name) throws MarkupError
public delegate void MarkupParserTextFunc (MarkupParseContext context, string text, size_t text_len) throws MarkupError
public delegate void MarkupParserPassthroughFunc (MarkupParseContext context, string passthrough_text, size_t text_len) throws MarkupError
public delegate void MarkupParserErrorFunc (MarkupParseContext context, Error error)
public delegate bool LogFatalFunc (string? log_domain, LogLevelFlags log_levels, string message)
public delegate void TestFunc (void* fixture)
The type used for test case functions.
public delegate void TestDataFunc ()
The type used for test case functions that take an extra pointer argument.
public delegate int CompareFunc (G a, G b)
public delegate int CompareDataFunc (G a, G b)
Specifies the type of a comparison function used to compare two values.
public delegate int SearchFunc (G a, T b)
Specifies the type of a comparison function used to compare two values.
public delegate int SequenceIterCompareFunc (SequenceIter<G> a, SequenceIter<G> b)
A SequenceIterCompareFunc is a function used to compare iterators.
public delegate uint HashFunc (K key)
Specifies the type of the hash function which is passed to g_hash_table_new when a GenericSet is created.
public delegate bool EqualFunc (G a, G b)
Specifies the type of a function used to test two values for equality.
public delegate void HFunc (K key, V value)
Specifies the type of the function passed to for_each.
public delegate bool HRFunc (K key, V value)
Specifies the type of the function passed to foreach_remove.
public delegate void DestroyNotify (void* data)
Specifies the type of function which is called when a data element is destroyed.
public delegate bool NodeTraverseFunc (Node node)
Specifies the type of function passed to traverse.
public delegate void NodeForeachFunc (Node node)
Specifies the type of function passed to children_foreach.
public delegate void DataForeachFunc (Quark key_id, G data)
Specifies the type of function passed to g_dataset_foreach.
public delegate bool TraverseFunc (K key, V value)
Specifies the type of function passed to g_tree_traverse.
public delegate int TreeSearchFunc (K key)

Methods:

public uint get_num_processors ()
Determine the approximate number of threads that the system will schedule simultaneously for this process.
public void* malloc (size_t n_bytes)
Allocates n_bytes bytes of memory.
public void* malloc0 (size_t n_bytes)
Allocates n_bytes bytes of memory, initialized to 0's.
public void* realloc (void* mem, size_t n_bytes)
Reallocates the memory pointed to by mem, so that it now has space for n_bytes bytes of memory.
public void* try_malloc (size_t n_bytes)
Attempts to allocate n_bytes, and returns null on failure.
public void* try_malloc0 (size_t n_bytes)
Attempts to allocate n_bytes, initialized to 0's, and returns null on failure.
public void* try_realloc (void* mem, size_t n_bytes)
Attempts to realloc mem to a new size, n_bytes, and returns null on failure.
public void free (void* mem)
public void mem_set_vtable (MemVTable vtable)
Sets the MemVTable to use for memory allocation.
public void mem_profile ()
Outputs a summary of memory usage.
public void print (string format, ...)
Outputs a formatted message via the print handler.
public void set_print_handler (PrintFunc func)
Sets the print handler.
public void printerr (string format, ...)
Outputs a formatted message via the error message handler.
public void set_printerr_handler (PrintFunc func)
Sets the handler for printing error messages.
public void return_if_fail (bool expr)
public void return_val_if_fail (bool expr, ...)
public void return_if_reached ()
public void return_val_if_reached (...)
public void warn_if_fail (bool expr)
public void warn_if_reached ()
public void assert (bool expr)
public void assert_false (bool expr)
public void assert_true (bool expr)
public void assert_null (void* expr)
public void assert_nonnull (void* expr)
public void assert_not_reached ()
public void on_error_query (string? prg_name = null)
Prompts the user with `[E]xit, [H]alt, show [S]tack trace or [P] roceed`.
public void on_error_stack_trace (string? prg_name = null)
Invokes gdb, which attaches to the current process and shows a stack trace.
public void breakpoint ()
public void logv (string? log_domain, LogLevelFlags log_level, string format, va_list args)
Logs an error or debugging message.
public void log (string? log_domain, LogLevelFlags log_level, string format, ...)
Logs an error or debugging message.
public void message (string format, ...)
public void warning (string format, ...)
public void critical (string format, ...)
public void error (string format, ...)
public void debug (string format, ...)
public void info (string format, ...)
public uint parse_debug_string (string? debug_string, DebugKey[] keys)
Parses a string containing debugging options into a guint containing bit flags.
public void strfreev (unowned string** str_array)
Frees a null-terminated array of strings, and the array itself.
public uint strv_length (string[] str_array)
Returns the length of the given null-terminated string array str_array.
public bool strv_contains (string[] str_array, string str)
public unowned string strerror (int errnum)
Returns a string corresponding to the given error code, e.
public string convert (string str, ssize_t len, string to_codeset, string from_codeset, out size_t bytes_read = null, out size_t bytes_written = null) throws ConvertError
Converts a string from one character set to another.
public bool get_charset (out string charset)
Obtains the character set for the current locale; you might use this character set as an argument to convert, to convert from the current locale's encoding to some other encoding.
public bool get_filename_charsets (out string[] charsets)
Determines the preferred character sets used for filenames.
public int64 get_monotonic_time ()
Queries the system monotonic time.
public int64 get_real_time ()
Queries the system wall-clock time.
public string format_size_for_display (int64 size)
Formats a size (for example the size of a file) into a human readable string.
public string format_size (uint64 size, FormatSizeFlags flags = DEFAULT)
Formats a size.
public unowned string strsignal (int signum)
Returns a string describing the given signal, e.
public unowned string _ (string str)
public unowned string Q_ (string str)
public unowned string N_ (string str)
public unowned string C_ (string context, string str)
public unowned string NC_ (string context, string str)
public unowned string ngettext (string msgid, string msgid_plural, ulong n)
public unowned string dgettext (string? domain, string msgid)
This function is a wrapper of dgettext which does not translate the message if the default domain as set with textdomain has no translations for the current locale.
public unowned string dcgettext (string? domain, string msgid, int category)
This is a variant of dgettext that allows specifying a locale category instead of always using `LC_MESSAGES`.
public unowned string dngettext (string? domain, string msgid, string msgid_plural, ulong n)
This function is a wrapper of dngettext which does not translate the message if the default domain as set with textdomain has no translations for the current locale.
public unowned string dpgettext (string? domain, string msgctxid, size_t msgidoffset)
This function is a variant of dgettext which supports a disambiguating message context.
public unowned string dpgettext2 (string? domain, string context, string msgid)
This function is a variant of dgettext which supports a disambiguating message context.
public bool likely (bool expression)
public bool unlikely (bool expression)
public void static_assert (bool expression)
public void qsort_with_data<T> (T[] elems, size_t size, CompareDataFunc<T> compare_func)

Fields:

public MemVTable mem_profiler_table
public int errno
public FileStream stdin
public FileStream stdout
public FileStream stderr
public CompareFunc<string> strcmp
Compares str1 and str2 like strcmp.
public HashFunc<void*> direct_hash
Converts a gpointer to a hash value.
public EqualFunc<void*> direct_equal
Compares two gpointer arguments and returns true if they are equal.
public HashFunc<int64?> int64_hash
Converts a pointer to a int64 to a hash value.
public EqualFunc<int64?> int64_equal
Compares the two int64 values being pointed to and returns true if they are equal.
public HashFunc<int?> int_hash
Converts a pointer to a int to a hash value.
public EqualFunc<int?> int_equal
Compares the two int values being pointed to and returns true if they are equal.
public HashFunc<string> str_hash
Converts a string to a hash value.
public EqualFunc<string> str_equal
Compares two strings for byte-by-byte equality and returns true if they are equal.
public DestroyNotify g_free
Frees the memory pointed to by mem.
public DestroyNotify g_object_unref
public DestroyNotify g_list_free
public DestroyNotify g_variant_unref

AtomicInt -

Methods:

public int @get (ref int atomic)
Gets the current value of atomic.
public void @set (ref int atomic, int newval)
Sets the value of atomic to newval.
public void add (ref int atomic, int val)
Atomically adds val to the value of atomic .
public int exchange_and_add (ref int atomic, int val)
This function existed before add returned the prior value of the integer (which it now does).
public bool compare_and_exchange (ref int atomic, int oldval, int newval)
Compares atomic to oldval and, if equal, sets it to newval.
public void inc (ref int atomic)
Increments the value of atomic by 1.
public bool dec_and_test (ref int atomic)
Decrements the value of atomic by 1.

AtomicPointer -

Methods:

public void* @get (void** atomic)
Gets the current value of atomic.
public void @set (void** atomic, void* newval)
Sets the value of atomic to newval.
public bool compare_and_exchange (void** atomic, void* oldval, void* newval)
Compares atomic to oldval and, if equal, sets it to newval.

Base64 -

Methods:

public size_t encode_step (uchar[] _in, bool break_lines, char* _out, ref int state, ref int save)
Incrementally encode a sequence of binary data into its Base-64 stringified representation.
public size_t encode_close (bool break_lines, char* _out, ref int state, ref int save)
Flush the status from a sequence of calls to encode_step.
public string encode (uchar[] data)
Encode a sequence of binary data into its Base-64 stringified representation.
public size_t decode_step (char[] _in, uchar* _out, ref int state, ref uint save)
Incrementally decode a sequence of binary data from its Base-64 stringified representation.
public uchar[] decode (string text)
Decode a sequence of Base-64 encoded text into binary data.

Bit -

Methods:

public int nth_lsf (ulong mask, int nth_bit)
Find the position of the first bit set in mask, searching from (but not including) nth_bit upwards.
public int nth_msf (ulong mask, int nth_bit)
Find the position of the first bit set in mask, searching from (but not including) nth_bit downwards.
public uint storage (ulong number)
Gets the number of bits used to hold number, e.

CharacterSet -

Constants:

public const unowned string A_2_Z
The set of uppercase ASCII alphabet characters.
public const unowned string a_2_z
The set of lowercase ASCII alphabet characters.
public const unowned string DIGITS
The set of ASCII digits.
public const unowned string LATINC
public const unowned string LATINS

ChildWatch -

Methods:

public uint add (Pid pid, owned ChildWatchFunc function, int priority = DEFAULT_IDLE)
public uint add_full (int priority, Pid pid, owned ChildWatchFunc function)
Sets a function to be called when the child indicated by pid exits, at the priority priority.

DirUtils -

Methods:

public int create (string pathname, int mode)
public int create_with_parents (string pathname, int mode)
Create a directory if it doesn't already exist.
public unowned string mkdtemp (string template)
public string make_tmp (string tmpl) throws FileError
Creates a subdirectory in the preferred directory for temporary files (as returned by get_tmp_dir).
public int remove (string filename)
A wrapper for the POSIX rmdir function.

Environ -

Methods:

public string[] @get ()
Gets the list of environment variables for the current process.
public unowned string? get_variable (string[]? envp, string variable)
Returns the value of the environment variable variable in the provided list envp.
public string[] set_variable (owned string[]? envp, string variable, string value, bool overwrite = true)
Sets the environment variable variable in the provided list envp to value.
public string[] unset_variable (owned string[]? envp, string variable)
Removes the environment variable variable from the provided environment envp.

Environment -

Methods:

public unowned string? get_application_name ()
Gets a human-readable name for the application, as set by set_application_name.
public void set_application_name (string application_name)
Sets a human-readable name for the application.
public unowned string get_prgname ()
Gets the name of the program.
public void set_prgname (string application_name)
Sets the name of the program.
public unowned string? get_variable (string variable)
Returns the value of an environment variable.
public bool set_variable (string variable, string value, bool overwrite)
Sets an environment variable.
public void unset_variable (string variable)
Removes an environment variable from the environment.
public string[] list_variables ()
Gets the names of all variables set in the environment.
public unowned string get_user_name ()
Gets the user name of the current user.
public unowned string get_real_name ()
Gets the real name of the user.
public unowned string get_user_cache_dir ()
Returns a base directory in which to store non-essential, cached data specific to particular user.
public unowned string get_user_data_dir ()
Returns a base directory in which to access application data such as icons that is customized for a particular user.
public unowned string get_user_config_dir ()
Returns a base directory in which to store user-specific application configuration information such as user preferences and settings.
public unowned string get_user_special_dir (UserDirectory directory)
Returns the full path of a special directory using its logical id.
public unowned string[] get_system_data_dirs ()
Returns an ordered list of base directories in which to access system-wide application data.
public unowned string[] get_system_config_dirs ()
Returns an ordered list of base directories in which to access system-wide configuration information.
public unowned string get_host_name ()
Return a name for the machine.
public unowned string get_home_dir ()
Gets the current user's home directory.
public unowned string get_tmp_dir ()
Gets the directory to use for temporary files.
public string get_current_dir ()
Gets the current directory.
public string? find_program_in_path (string program)
Locates the first executable named program in the user's path, in the same way that execvp would locate it.
public void atexit (VoidFunc func)
Specifies a function to be called at normal program termination.
public int set_current_dir (string path)
A wrapper for the POSIX chdir function.

FileUtils -

Methods:

public bool get_contents (string filename, out string contents, out size_t length = null) throws FileError
public bool set_contents (string filename, string contents, ssize_t length = -1) throws FileError
public bool get_data (string filename, out uint8[] contents) throws FileError
Reads an entire file into allocated memory, with good error checking.
public bool set_data (string filename, uint8[] contents) throws FileError
Writes all of contents to a file named filename, with good error checking.
public bool test (string filename, FileTest test)
Returns true if any of the tests in the bitfield test are true.
public int open_tmp (string tmpl, out string name_used) throws FileError
Opens a file for writing in the preferred directory for temporary files (as returned by get_tmp_dir).
public string read_link (string filename) throws FileError
Reads the contents of the symbolic link filename like the POSIX readlink function.
public int error_from_errno (int err_no)
Gets a FileError constant based on the passed-in err_no.
public int mkstemp (string tmpl)
Opens a temporary file.
public int rename (string oldfilename, string newfilename)
public int remove (string filename)
public int unlink (string filename)
A wrapper for the POSIX unlink function.
public int chmod (string filename, int mode)
public int utime (string filename, UTimBuf? times = null)
public int symlink (string oldpath, string newpath)
public int close (int fd)

Filename -

Methods:

public string to_utf8 (string opsysstring, ssize_t len, out size_t bytes_read, out size_t bytes_written) throws ConvertError
Converts a string which is in the encoding used by GLib for filenames into a UTF-8 string.
public string from_utf8 (string utf8string, ssize_t len, out size_t bytes_read, out size_t bytes_written) throws ConvertError
Converts a string from UTF-8 to the encoding GLib uses for filenames.
public string from_uri (string uri, out string hostname = null) throws ConvertError
Converts an escaped ASCII-encoded URI to a local filename in the encoding used for filenames.
public string to_uri (string filename, string? hostname = null) throws ConvertError
Converts an absolute filename to an escaped ASCII-encoded URI, with the path component following Section 3.3.
public string display_name (string filename)
Converts a filename into a valid UTF-8 string.
public string display_basename (string filename)
Returns the display basename for the particular filename, guaranteed to be valid UTF-8.

Idle -

Methods:

public uint add (owned SourceFunc function, int priority = DEFAULT_IDLE)
public uint add_full (int priority, owned SourceFunc function)
Adds a function to be called whenever there are no higher priority events pending.
public bool remove_by_data (void* data)
Removes the idle function with the given data.

Intl -

Methods:

public unowned string? setlocale (LocaleCategory category = ALL, string? locale = "")
public unowned string? bindtextdomain (string domainname, string? dirname)
public unowned string? textdomain (string? domainname)
public unowned string? bind_textdomain_codeset (string domainname, string? codeset)
public unowned string[] get_language_names ()
Computes a list of applicable locale names, which can be used to e.
public unowned string strip_context (string msgid, string msgval)
An auxiliary function for gettext support (see Q_).

KeyFileDesktop -

Constants:

public const unowned string GROUP
The name of the main group of a desktop entry file, as defined in the Desktop Entry Specification.
public const unowned string KEY_ACTIONS
public const unowned string KEY_CATEGORIES
A key under GROUP, whose value is a list of strings giving the categories in which the desktop entry should be shown in a menu.
public const unowned string KEY_COMMENT
A key under GROUP, whose value is a localized string giving the tooltip for the desktop entry.
public const unowned string KEY_DBUS_ACTIVATABLE
public const unowned string KEY_EXEC
A key under GROUP, whose value is a string giving the command line to execute.
public const unowned string KEY_FULLNAME
public const unowned string KEY_GENERIC_NAME
A key under GROUP, whose value is a localized string giving the generic name of the desktop entry.
public const unowned string KEY_GETTEXT_DOMAIN
public const unowned string KEY_HIDDEN
A key under GROUP, whose value is a boolean stating whether the desktop entry has been deleted by the user.
public const unowned string KEY_ICON
A key under GROUP, whose value is a localized string giving the name of the icon to be displayed for the desktop entry.
public const unowned string KEY_KEYWORDS
public const unowned string KEY_MIME_TYPE
A key under GROUP, whose value is a list of strings giving the MIME types supported by this desktop entry.
public const unowned string KEY_NAME
A key under GROUP, whose value is a localized string giving the specific name of the desktop entry.
public const unowned string KEY_NOT_SHOW_IN
A key under GROUP, whose value is a list of strings identifying the environments that should not display the desktop entry.
public const unowned string KEY_NO_DISPLAY
A key under GROUP, whose value is a boolean stating whether the desktop entry should be shown in menus.
public const unowned string KEY_ONLY_SHOW_IN
A key under GROUP, whose value is a list of strings identifying the environments that should display the desktop entry.
public const unowned string KEY_PATH
A key under GROUP, whose value is a string containing the working directory to run the program in.
public const unowned string KEY_STARTUP_NOTIFY
A key under GROUP, whose value is a boolean stating whether the application supports the Startup Notification Protocol Specification .
public const unowned string KEY_STARTUP_WM_CLASS
A key under GROUP, whose value is string identifying the WM class or name hint of a window that the application will create, which can be used to emulate Startup Notification with older applications.
public const unowned string KEY_TERMINAL
A key under GROUP, whose value is a boolean stating whether the program should be run in a terminal window.
public const unowned string KEY_TRY_EXEC
A key under GROUP, whose value is a string giving the file name of a binary on disk used to determine if the program is actually installed.
public const unowned string KEY_TYPE
A key under GROUP, whose value is a string giving the type of the desktop entry.
public const unowned string KEY_URL
A key under GROUP, whose value is a string giving the URL to access.
public const unowned string KEY_VERSION
A key under GROUP, whose value is a string giving the version of the Desktop Entry Specification used for the desktop entry file.
public const unowned string TYPE_APPLICATION
The value of the KEY_TYPE, key for desktop entries representing applications.
public const unowned string TYPE_DIRECTORY
The value of the KEY_TYPE, key for desktop entries representing directories.
public const unowned string TYPE_LINK
The value of the KEY_TYPE, key for desktop entries representing links to documents.

Log -

Constants:

public const unowned string FILE
public const int LINE
public const unowned string METHOD

Methods:

public uint set_handler (string? log_domain, LogLevelFlags log_levels, LogFunc log_func)
Sets the log handler for a domain and a set of log levels.
public void set_default_handler (LogFunc log_func)
Installs a default log handler which is used if no log handler has been set for the particular log domain and log level combination.
public LogLevelFlags set_fatal_mask (string log_domain, LogLevelFlags log_levels)
Sets the log levels which are fatal in the given domain.
public LogLevelFlags set_always_fatal (LogLevelFlags log_levels)
Sets the message levels which are always fatal, in any log domain.
public void remove_handler (string? log_domain, uint handler_id)
Removes the log handler.

Fields:

public LogFunc default_handler
The default log handler set up by GLib; set_default_handler allows to install an alternate default log handler.

Markup -

Enums:

CollectType - A mixed enumerated type and flags field.

Methods:

public string escape_text (string text, ssize_t length = -1)
Escapes text so that the markup parser will parse it verbatim.
public string printf_escaped (string format, ...)
Formats arguments according to format, escaping all string and character arguments in the fashion of escape_text.
public string vprintf_escaped (string format, va_list args)
Formats the data in args according to format, escaping all string and character arguments in the fashion of escape_text.
public bool collect_attributes (string element_name, string[] attribute_names, string[] attribute_values, ...) throws MarkupError
Collects the attributes of the element from the data passed to the MarkupParser start_element function, dealing with common error conditions and supporting boolean values.

Math -

Constants:

public const double E
The base of natural logarithms.
public const double PI
The value of pi (ratio of circle's circumference to its diameter).
public const double LN2
The natural logarithm of 2.
public const double LN10
The natural logarithm of 10.
public const double PI_2
Pi divided by 2.
public const double PI_4
Pi divided by 4.
public const double SQRT2
The square root of two.
public const double LOG_2_BASE_10
Multiplying the base 2 exponent by this number yields the base 10 exponent.

Methods:

public double acos (double x)
public float acosf (float x)
public double asin (double x)
public float asinf (float x)
public double atan (double x)
public float atanf (float x)
public double atan2 (double y, double x)
public float atan2f (float y, float x)
public double cos (double x)
public float cosf (float x)
public double sin (double x)
public float sinf (float x)
public double tan (double x)
public float tanf (float x)
public double cosh (double x)
public float coshf (float x)
public double sinh (double x)
public float sinhf (float x)
public double tanh (double x)
public float tanhf (float x)
public void sincos (double x, out double sinx, out double cosx)
public void sincosf (float x, out float sinx, out float cosx)
public double acosh (double x)
public float acoshf (float x)
public double asinh (double x)
public float asinhf (float x)
public double atanh (double x)
public float atanhf (float x)
public double exp (double x)
public float expf (float x)
public double frexp (double x, out int exponent)
public float frexpf (float x, out int exponent)
public double ldexp (double x, int exponent)
public float ldexpf (float x, int exponent)
public double log (double x)
public float logf (float x)
public double log10 (double x)
public float log10f (float x)
public double modf (double x, out double iptr)
public float modff (float x, out float iptr)
public double exp10 (double x)
public float exp10f (float x)
public double pow10 (double x)
public float pow10f (float x)
public double expm1 (double x)
public float expm1f (float x)
public double log1p (double x)
public float log1pf (float x)
public double logb (double x)
public float logbf (float x)
public double exp2 (double x)
public float exp2f (float x)
public double log2 (double x)
public float log2f (float x)
public double pow (double x, double y)
public float powf (float x, float y)
public double sqrt (double x)
public float sqrtf (float x)
public double hypot (double x, double y)
public float hypotf (float x, float y)
public double cbrt (double x)
public float cbrtf (float x)
public double ceil (double x)
public float ceilf (float x)
public double fabs (double x)
public float fabsf (float x)
public double floor (double x)
public float floorf (float x)
public double fmod (double x, double y)
public float fmodf (float x, float y)
public int isinf (double value)
public int isinff (float value)
public int finite (double value)
public int finitef (float value)
public double drem (double x, double y)
public float dremf (float x, float y)
public double significand (double x)
public float significandf (float x)
public double copysign (double x, double y)
public float copysignf (float x, float y)
public double nan (string tagb)
public float nanf (string tagb)
public int isnan (double value)
public int isnanf (float value)
public double j0 (double x0)
public float j0f (float x0)
public double j1 (double x0)
public float j1f (float x0)
public double jn (int x0, double x1)
public float jnf (int x0, float x1)
public double y0 (double x0)
public float y0f (float x0)
public double y1 (double x0)
public float y1f (float x0)
public double yn (int x0, double x1)
public float ynf (int x0, float x1)
public double erf (double x0)
public float erff (float x0)
public double erfc (double x0)
public float erfcf (float x0)
public double lgamma (double x0)
public float lgammaf (float x0)
public double tgamma (double x0)
public float tgammaf (float x0)
public double gamma (double x0)
public float gammaf (float x0)
public double lgamma_r (double x0, out int signgamp)
public float lgamma_rf (float x0, out int signgamp)
public double rint (double x)
public float rintf (float x)
public double nextafter (double x, double y)
public float nextafterf (float x, float y)
public double nexttoward (double x, double y)
public float nexttowardf (float x, double y)
public double remainder (double x, double y)
public float remainderf (float x, float y)
public double scalbn (double x, int n)
public float scalbnf (float x, int n)
public int ilogb (double x)
public int ilogbf (float x)
public double scalbln (double x, long n)
public float scalblnf (float x, long n)
public double nearbyint (double x)
public float nearbyintf (float x)
public double round (double x)
public float roundf (float x)
public double trunc (double x)
public float truncf (float x)
public double remquo (double x, double y, out int quo)
public float remquof (float x, float y, out int quo)
public long lrint (double x)
public long lrintf (float x)
public int64 llrint (double x)
public int64 llrintf (float x)
public long lround (double x)
public long lroundf (float x)
public int64 llround (double x)
public int64 llroundf (float x)
public double fdim (double x, double y)
public float fdimf (float x, float y)
public double fmax (double x, double y)
public float fmaxf (float x, float y)
public double fmin (double x, double y)
public float fminf (float x, float y)
public double fma (double x, double y, double z)
public float fmaf (float x, float y, float z)
public double scalb (double x, double n)
public float scalbf (float x, float n)

Memory -

Methods:

public int cmp (void* s1, void* s2, size_t n)
public void* copy (void* dest, void* src, size_t n)
public void* @set (void* dest, int src, size_t n)
public void* move (void* dest, void* src, size_t n)
public void* dup (void* mem, uint n)
Allocates byte_size bytes of memory, and copies byte_size bytes into it from mem.

Path -

Constants:

public const char DIR_SEPARATOR
The directory separator character.
public const unowned string DIR_SEPARATOR_S
The directory separator as a string.
public const char SEARCHPATH_SEPARATOR
The search path separator character.
public const unowned string SEARCHPATH_SEPARATOR_S
The search path separator as a string.

Methods:

public bool is_absolute (string file_name)
Returns true if the given file_name is an absolute file name.
public unowned string skip_root (string file_name)
Returns a pointer into file_name after the root component, i.
public string get_basename (string file_name)
Gets the last component of the filename.
public string get_dirname (string file_name)
Gets the directory components of a file name.
public string build_filename (string first_element, ...)
Creates a filename from a series of elements using the correct separator for filenames.
public string build_path (string separator, string first_element, ...)
Creates a path from a series of elements using separator as the separator between elements.
public bool is_dir_separator (unichar c)

Priority -

Constants:

public const int HIGH
Use this for high priority event sources.
public const int DEFAULT
Use this for default priority event sources.
public const int HIGH_IDLE
Use this for high priority idle functions.
public const int DEFAULT_IDLE
Use this for default priority idle functions.
public const int LOW
Use this for very low priority background tasks.

Process -

Methods:

public bool spawn_async_with_pipes (string? working_directory, string[] argv, string[]? envp, SpawnFlags _flags, SpawnChildSetupFunc? child_setup, out Pid child_pid, out int standard_input = null, out int standard_output = null, out int standard_error = null) throws SpawnError
Executes a child program asynchronously (your program will not block waiting for the child to exit).
public bool spawn_async (string? working_directory, string[] argv, string[]? envp, SpawnFlags _flags, SpawnChildSetupFunc? child_setup, out Pid child_pid) throws SpawnError
See spawn_async_with_pipes for a full description; this function simply calls the spawn_async_with_pipes without any pipes.
public bool spawn_sync (string? working_directory, string[] argv, string[]? envp, SpawnFlags _flags, SpawnChildSetupFunc? child_setup, out string standard_output = null, out string standard_error = null, out int exit_status = null) throws SpawnError
Executes a child synchronously (waits for the child to exit before returning).
public bool spawn_command_line_async (string command_line) throws SpawnError
A simple version of spawn_async that parses a command line with parse_argv and passes it to spawn_async.
public 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
A simple version of spawn_sync with little-used parameters removed, taking a command line instead of an argument vector.
public void close_pid (Pid pid)
On some platforms, notably Windows, the Pid type represents a resource which must be closed to prevent resource leaking.
public bool check_exit_status (int exit_status) throws Error
Set throws if exit_status indicates the child exited abnormally (e.
public bool if_exited (int status)
public int exit_status (int status)
public bool if_signaled (int status)
public ProcessSignal term_sig (int status)
public bool core_dump (int status)
public bool if_stopped (int status)
public ProcessSignal stop_sig (int status)
public bool if_continued (int status)
public void abort ()
public void exit (int status)
public int raise (ProcessSignal sig)
public SignalHandlerFunc @signal (ProcessSignal signum, SignalHandlerFunc handler)

Random -

Methods:

public void set_seed (uint32 seed)
Sets the seed for the global random number generator, which is used by the g_random_* functions, to seed.
public bool boolean ()
public uint32 next_int ()
Return a random uint32 equally distributed over the range [0.
public int32 int_range (int32 begin, int32 end)
Returns a random int32 equally distributed over the range [begin.
public double next_double ()
Returns a random double equally distributed over the range [0.
public double double_range (double begin, double end)
Returns a random double equally distributed over the range [begin.

Shell -

Methods:

public bool parse_argv (string command_line, out string[] argvp) throws ShellError
Parses a command line into an argument vector, in much the same way the shell would, but without many of the expansions the shell would perform (variable expansion, globs, operators, filename expansion, etc.
public string quote (string unquoted_string)
Quotes a string so that the shell (/bin/sh) will interpret the quoted string to mean unquoted_string.
public string unquote (string quoted_string) throws ShellError
Unquotes a string as the shell (/bin/sh) would.

Slice -

Methods:

public void* alloc (size_t block_size)
Allocates a block of memory from the slice allocator.
public void* alloc0 (size_t block_size)
Allocates a block of memory via alloc and initializes the returned memory to 0.
public void* copy (size_t block_size, void* mem_block)
Allocates a block of memory from the slice allocator and copies block_size bytes into it from mem_block.
public void free (size_t block_size, void* mem_block)
Frees a block of memory.
public void free_chain_with_offset (size_t block_size, void* mem_chain, size_t next_offset)
Frees a linked list of memory blocks of structure type type.
public int64 get_config (SliceConfig ckey)
public int64[] get_config_state (SliceConfig ckey, int64 address)
public void set_config (SliceConfig ckey, int64 value)

SpacedPrimes -

Methods:

public uint closest (uint num)
Gets the smallest prime number from a built-in array of primes which is larger than num.

Test -

Enums:

FileType - The type of file to return the filename for, when used with build_filename.

Methods:

public void minimized_result (double minimized_quantity, string format, ...)
Report the result of a performance or measurement test.
public void maximized_result (double maximized_quantity, string format, ...)
Report the result of a performance or measurement test.
public void init (ref string[] args, ...)
Initialize the GLib testing framework, e.
public bool quick ()
public bool slow ()
public bool thorough ()
public bool perf ()
public bool verbose ()
public bool quiet ()
public int run ()
Runs all tests under the toplevel suite which can be retrieved with get_root.
public void add_func (string testpath, Callback test_funcvoid)
Create a new test case, similar to TestCase.
public void add_data_func (string testpath, TestDataFunc test_funcvoid)
Create a new test case, similar to TestCase.
public string build_filename (FileType file_type, string[] path_segments)
Creates the pathname to a data file that is required for a test.
public void fail ()
Indicates that a test failed.
public bool failed ()
Returns whether a test has already failed.
public unowned string get_dir (FileType file_type)
Gets the pathname of the directory containing test files of the type specified by file_type.
public unowned string get_filename (FileType file_type, string[] path_segments)
Gets the pathname to a data file that is required for a test.
public void incomplete (string msg)
Indicates that a test failed because of some incomplete functionality.
public void message (string format, ...)
Add a message to the test report.
public void set_nonfatal_assertions ()
Changes the behaviour of g_assert_cmpstr, g_assert_cmpint, g_assert_cmpuint, g_assert_cmphex, g_assert_cmpfloat, assert_true, assert_false, assert_null, g_assert_no_error, g_assert_error, g_test_assert_expected_messages and the various g_test_trap_assert_*() macros to not abort to program, but instead call fail and continue.
public void skip (string msg)
Indicates that a test was skipped.
public bool subprocess ()
Returns true (after init has been called) if the test program is running under trap_subprocess.
public void bug_base (string uri_pattern)
Specify the base URI for bug reports.
public void bug (string bug_uri_snippet)
This function adds a message to test reports that associates a bug URI with a test case.
public void timer_start ()
Start a timing test.
public double timer_elapsed ()
Get the time since the last start of the timer with timer_start.
public double timer_last ()
Report the last result of timer_elapsed.
public bool trap_fork (uint64 usec_timeout, TestTrapFlags test_trap_flags)
Fork the current test program to execute a test case that might not return or that might abort.
public bool trap_has_passed ()
Check the result of the last trap_subprocess call.
public bool trap_reached_timeout ()
Check the result of the last trap_subprocess call.
public void trap_subprocess (string test_path, uint64 usec_timeout, TestSubprocessFlags test_flags)
Respawns the test program to run only test_path in a subprocess.
public void trap_assert_passed ()
public void trap_assert_failed ()
public void trap_assert_stdout (string soutpattern)
public void trap_assert_stdout_unmatched (string soutpattern)
public void trap_assert_stderr (string serrpattern)
public void trap_assert_stderr_unmatched (string serrpattern)
public bool rand_bit ()
public int32 rand_int ()
Get a reproducible random integer number.
public int32 rand_int_range (int32 begin, int32 end)
Get a reproducible random integer number out of a specified range, see rand_int for details on test case random numbers.
public double rand_double ()
Get a reproducible random floating point number, see rand_int for details on test case random numbers.
public double rand_double_range (double begin, double end)
Get a reproducible random floating pointer number out of a specified range, see rand_int for details on test case random numbers.
public void log_set_fatal_handler (LogFatalFunc log_func)
Installs a non-error fatal log handler which can be used to decide whether log messages which are counted as fatal abort the program.

Timeout -

Methods:

public uint add (uint interval, owned SourceFunc function, int priority = DEFAULT)
public uint add_full (int priority, uint interval, owned SourceFunc function)
Sets a function to be called at regular intervals, with the given priority.
public uint add_seconds (uint interval, owned SourceFunc function, int priority = DEFAULT)
public uint add_seconds_full (int priority, uint interval, owned SourceFunc function)
Sets a function to be called at regular intervals, with priority.

Unix -

Classes:

SignalSource -

Methods:

public uint signal_add (int signum, owned SourceFunc handler, int priority = DEFAULT)
A convenience function for SignalSource, which attaches to the default MainContext.
public bool open_pipe (int fds, int flags) throws Error
Similar to the UNIX pipe call, but on modern systems like Linux uses the pipe2 system call, which atomically creates a pipe with the configured flags.
public bool set_fd_nonblocking (int fd, bool nonblock) throws Error
Control the non-blocking state of the given file descriptor, according to nonblock.

Uri -

Constants:

public const unowned string RESERVED_CHARS_ALLOWED_IN_PATH
public const unowned string RESERVED_CHARS_ALLOWED_IN_PATH_ELEMENT
public const unowned string RESERVED_CHARS_ALLOWED_IN_USERINFO
public const unowned string RESERVED_CHARS_GENERIC_DELIMITERS
Generic delimiters characters as defined in RFC 3986.
public const unowned string RESERVED_CHARS_SUBCOMPONENT_DELIMITERS
Subcomponent delimiter characters as defined in RFC 3986.

Methods:

public string? parse_scheme (string uri)
Gets the scheme portion of a URI string.
public string escape_string (string unescaped, string? reserved_chars_allowed = null, bool allow_utf8 = true)
Escapes a string for use in a URI.
public string? unescape_string (string escaped_string, string? illegal_characters = null)
Unescapes a whole escaped string.
public string? unescape_segment (string? escaped_string, string? escaped_string_end, string? illegal_characters = null)
Unescapes a segment of an escaped string.
public string[] list_extract_uris (string uri_list)
Splits an URI list conforming to the text/uri-list mime type defined in RFC 2483 into individual URIs, discarding any comments.

Version -

Constants:

public const uint major
public const uint minor
public const uint micro
public const uint MAJOR
The major version number of the GLib library.
public const uint MINOR
The minor version number of the GLib library.
public const uint MICRO
The micro version number of the GLib library.
public const uint @2_26
public const uint @2_28
public const uint @2_30
public const uint @2_32
public const uint @2_34
public const uint @2_36
public const uint @2_38
public const uint binary_age
public const uint interface_age

Methods:

public unowned string? check (uint required_major, uint required_minor = 0, uint required_micro = 0)
Checks that the GLib library in use is compatible with the given version.
public bool CHECK (uint required_major, uint required_minor = 0, uint required_micro = 0)

Win32 -