typedef guint8 GDateDay; /+* day of the month +/ Integer representing a day of the month; between 1 and 31. G_DATE_BAD_DAY represents an invalid day of the month.
typedef guint16 GDateYear; Integer representing a year; G_DATE_BAD_YEAR is the invalid value. The year must be 1 or higher; negative (BC) years are not allowed. The year is represented with four digits.
typedef int GPid; A type which is used to hold a process identification. On UNIX, processes are identified by a process id (an integer), while Windows uses process handles (which are pointers).
typedef guint32 GQuark; A GQuark is a non-zero integer which uniquely identifies a particular string. A GQuark value of zero is associated to NULL.
typedef gint32 GTime; Simply a replacement for time_t. It has been deprected since it is not equivalent to time_t on 64-bit platforms with a 64-bit time_t. Unrelated to GTimer. Note that GTime is defined to always be a 32bit integer, unlike time_t which may be 64bit on some systems. Therefore, GTime will overflow in the year 2038, and you cannot use the address of a GTime variable as argument to the UNIX time() function. Instead, do the following:
typedef gint64 GTimeSpan; A value representing an interval of time, in microseconds. Since 2.26
typedef guint32 gunichar; A type which can hold any UTF-32 or UCS-4 character code, also known as a Unicode code point. If you want to produce the UTF-8 representation of a gunichar, use g_ucs4_to_utf8(). See also g_utf8_to_ucs4() for the reverse process. To print/scan values of this type as integer, use G_GINT32_MODIFIER and/or G_GUINT32_FORMAT. The notation to express a Unicode code point in running text is as a hexadecimal number with four to six digits and uppercase letters, prefixed by the string "U+". Leading zeros are omitted, unless the code point would have fewer than four hexadecimal digits. For example, "U+0041 LATIN CAPITAL LETTER A". To print a code point in the U+-notation, use the format string "U+04"G_GINT32_FORMAT"X". To scan, use the format string "U+06"G_GINT32_FORMAT"X".
typedef guint16 gunichar2; A type which can hold any UTF-16 code point[3]. To print/scan values of this type to/from text you need to convert to/from UTF-8, using g_utf16_to_utf8()/g_utf8_to_utf16(). To print/scan values of this type as integer, use G_GINT16_MODIFIER and/or G_GUINT16_FORMAT.
Error codes returned by bookmark file parsing. G_BOOKMARK_FILE_ERROR_INVALID_URI URI was ill-formed G_BOOKMARK_FILE_ERROR_INVALID_VALUE a requested field was not found G_BOOKMARK_FILE_ERROR_APP_NOT_REGISTERED a requested application did not register a bookmark G_BOOKMARK_FILE_ERROR_URI_NOT_FOUND a requested URI was not found G_BOOKMARK_FILE_ERROR_READ document was ill formed G_BOOKMARK_FILE_ERROR_UNKNOWN_ENCODING the text being parsed was in an unknown encoding G_BOOKMARK_FILE_ERROR_WRITE an error occurred while writing G_BOOKMARK_FILE_ERROR_FILE_NOT_FOUND requested file was not found
The hashing algorithm to be used by GChecksum when performing the digest of some data. Note that the GChecksumType enumeration may be extended at a later date to include new hashing algorithm types. G_CHECKSUM_MD5 Use the MD5 hashing algorithm G_CHECKSUM_SHA1 Use the SHA-1 hashing algorithm G_CHECKSUM_SHA256 Use the SHA-256 hashing algorithm Since 2.16
Error codes returned by character set conversion routines. G_CONVERT_ERROR_NO_CONVERSION Conversion between the requested character sets is not supported. G_CONVERT_ERROR_ILLEGAL_SEQUENCE Invalid byte sequence in conversion input. G_CONVERT_ERROR_FAILED Conversion failed for some reason. G_CONVERT_ERROR_PARTIAL_INPUT Partial character sequence at end of input. G_CONVERT_ERROR_BAD_URI URI is invalid. G_CONVERT_ERROR_NOT_ABSOLUTE_PATH Pathname is not an absolute path.
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. G_DATE_DAY a day G_DATE_MONTH a month G_DATE_YEAR a year
Enumeration representing a month; values are G_DATE_JANUARY, G_DATE_FEBRUARY, etc. G_DATE_BAD_MONTH is the invalid value. G_DATE_BAD_MONTH invalid value G_DATE_JANUARY January G_DATE_FEBRUARY February G_DATE_MARCH March G_DATE_APRIL April G_DATE_MAY May G_DATE_JUNE June G_DATE_JULY July G_DATE_AUGUST August G_DATE_SEPTEMBER September G_DATE_OCTOBER October G_DATE_NOVEMBER November G_DATE_DECEMBER December
Enumeration representing a day of the week; G_DATE_MONDAY, G_DATE_TUESDAY, etc. G_DATE_BAD_WEEKDAY is an invalid weekday. G_DATE_BAD_WEEKDAY invalid value G_DATE_MONDAY Monday G_DATE_TUESDAY Tuesday G_DATE_WEDNESDAY Wednesday G_DATE_THURSDAY Thursday G_DATE_FRIDAY Friday G_DATE_SATURDAY Saturday G_DATE_SUNDAY Sunday
The possible errors, used in the v_error field of GTokenValue, when the token is a G_TOKEN_ERROR. G_ERR_UNKNOWN unknown error. G_ERR_UNEXP_EOF unexpected end of file. G_ERR_UNEXP_EOF_IN_STRING unterminated string constant. G_ERR_UNEXP_EOF_IN_COMMENT unterminated comment. G_ERR_NON_DIGIT_IN_CONST non-digit character in a number. G_ERR_DIGIT_RADIX digit beyond radix in a number. G_ERR_FLOAT_RADIX non-decimal floating point number. G_ERR_FLOAT_MALFORMED malformed floating point number.
Values corresponding to errno codes returned from file operations on UNIX. Unlike errno codes, GFileError values are available on all systems, even Windows. The exact meaning of each code depends on what sort of file operation you were performing; the UNIX documentation gives more details. The following error code descriptions come from the GNU C Library manual, and are under the copyright of that manual. It's not very portable to make detailed assumptions about exactly which errors will be returned from a given operation. Some errors don't occur on some systems, etc., sometimes there are subtle differences in when a system will report a given error, etc. G_FILE_ERROR_EXIST Operation not permitted; only the owner of the file (or other resource) or processes with special privileges can perform the operation. G_FILE_ERROR_ISDIR File is a directory; you cannot open a directory for writing, or create or remove hard links to it. G_FILE_ERROR_ACCES Permission denied; the file permissions do not allow the attempted operation. G_FILE_ERROR_NAMETOOLONG Filename too long. G_FILE_ERROR_NOENT No such file or directory. This is a "file doesn't exist" error for ordinary files that are referenced in contexts where they are expected to already exist. G_FILE_ERROR_NOTDIR A file that isn't a directory was specified when a directory is required. G_FILE_ERROR_NXIO No such device or address. The system tried to use the device represented by a file you specified, and it couldn't find the device. This can mean that the device file was installed incorrectly, or that the physical device is missing or not correctly attached to the computer. G_FILE_ERROR_NODEV This file is of a type that doesn't support mapping. G_FILE_ERROR_ROFS The directory containing the new link can't be modified because it's on a read-only file system. G_FILE_ERROR_TXTBSY Text file busy. G_FILE_ERROR_FAULT You passed in a pointer to bad memory. (GLib won't reliably return this, don't pass in pointers to bad memory.) G_FILE_ERROR_LOOP Too many levels of symbolic links were encountered in looking up a file name. This often indicates a cycle of symbolic links. G_FILE_ERROR_NOSPC No space left on device; write operation on a file failed because the disk is full. G_FILE_ERROR_NOMEM No memory available. The system cannot allocate more virtual memory because its capacity is full. G_FILE_ERROR_MFILE The current process has too many files open and can't open any more. Duplicate descriptors do count toward this limit. G_FILE_ERROR_NFILE There are too many distinct file openings in the entire system. G_FILE_ERROR_BADF Bad file descriptor; for example, I/O on a descriptor that has been closed or reading from a descriptor open only for writing (or vice versa). G_FILE_ERROR_INVAL Invalid argument. This is used to indicate various kinds of problems with passing the wrong argument to a library function. G_FILE_ERROR_PIPE Broken pipe; there is no process reading from the other end of a pipe. Every library function that returns this error code also generates a `SIGPIPE' signal; this signal terminates the program if not handled or blocked. Thus, your program will never actually see this code unless it has handled or blocked `SIGPIPE'. G_FILE_ERROR_AGAIN Resource temporarily unavailable; the call might work if you try again later. G_FILE_ERROR_INTR Interrupted function call; an asynchronous signal occurred and prevented completion of the call. When this happens, you should try the call again. G_FILE_ERROR_IO Input/output error; usually used for physical read or write errors. i.e. the disk or other physical device hardware is returning errors. G_FILE_ERROR_PERM Operation not permitted; only the owner of the file (or other resource) or processes with special privileges can perform the operation. G_FILE_ERROR_NOSYS Function not implemented; this indicates that the system is missing some functionality. G_FILE_ERROR_FAILED Does not correspond to a UNIX error code; this is the standard "failed for unspecified reason" error code present in all GError error code enumerations. Returned if no specific code applies.
A test to perform on a file using g_file_test(). G_FILE_TEST_IS_REGULAR TRUE if the file is a regular file (not a directory). Note that this test will also return TRUE if the tested file is a symlink to a regular file. G_FILE_TEST_IS_SYMLINK TRUE if the file is a symlink. G_FILE_TEST_IS_DIR TRUE if the file is a directory. G_FILE_TEST_IS_EXECUTABLE TRUE if the file is executable. G_FILE_TEST_EXISTS TRUE if the file exists. It may or may not be a regular file.
Error codes returned by GIOChannel operations. G_IO_CHANNEL_ERROR_FBIG File too large. G_IO_CHANNEL_ERROR_INVAL Invalid argument. G_IO_CHANNEL_ERROR_IO IO error. G_IO_CHANNEL_ERROR_ISDIR File is a directory. G_IO_CHANNEL_ERROR_NOSPC No space left on device. G_IO_CHANNEL_ERROR_NXIO No such device or address. G_IO_CHANNEL_ERROR_OVERFLOW Value too large for defined datatype. G_IO_CHANNEL_ERROR_PIPE Broken pipe. G_IO_CHANNEL_ERROR_FAILED Some other error.
A bitwise combination representing a condition to watch for on an event source. G_IO_IN There is data to read. G_IO_OUT Data can be written (without blocking). G_IO_PRI There is urgent data to read. G_IO_ERR Error condition. G_IO_HUP Hung up (the connection has been broken, usually for pipes and sockets). G_IO_NVAL Invalid request. The file descriptor is not open.
GIOError is only used by the deprecated functions g_io_channel_read(), g_io_channel_write(), and g_io_channel_seek(). G_IO_ERROR_NONE no error G_IO_ERROR_AGAIN an EAGAIN error occurred G_IO_ERROR_INVAL an EINVAL error occurred G_IO_ERROR_UNKNOWN another error occurred
Specifies properties of a GIOChannel. Some of the flags can only be read with g_io_channel_get_flags(), but not changed with g_io_channel_set_flags(). G_IO_FLAG_APPEND turns on append mode, corresponds to O_APPEND (see the documentation of the UNIX open() syscall). G_IO_FLAG_NONBLOCK turns on nonblocking mode, corresponds to O_NONBLOCK/O_NDELAY (see the documentation of the UNIX open() syscall). G_IO_FLAG_IS_READABLE indicates that the io channel is readable. This flag can not be changed. G_IO_FLAG_IS_WRITEABLE indicates that the io channel is writable. This flag can not be changed. G_IO_FLAG_IS_SEEKABLE indicates that the io channel is seekable, i.e. that g_io_channel_seek_position() can be used on it. This flag can not be changed. G_IO_FLAG_MASK the mask that specifies all the valid flags. G_IO_FLAG_GET_MASK the mask of the flags that are returned from g_io_channel_get_flags(). G_IO_FLAG_SET_MASK the mask of the flags that the user can modify with g_io_channel_set_flags().
Stati returned by most of the GIOFuncs functions. G_IO_STATUS_ERROR An error occurred. G_IO_STATUS_NORMAL Success. G_IO_STATUS_EOF End of file. G_IO_STATUS_AGAIN Resource temporarily unavailable.
Error codes returned by key file parsing. G_KEY_FILE_ERROR_UNKNOWN_ENCODING the text being parsed was in an unknown encoding G_KEY_FILE_ERROR_PARSE document was ill-formed G_KEY_FILE_ERROR_NOT_FOUND the file was not found G_KEY_FILE_ERROR_KEY_NOT_FOUND a requested key was not found G_KEY_FILE_ERROR_GROUP_NOT_FOUND a requested group was not found G_KEY_FILE_ERROR_INVALID_VALUE a value could not be parsed
Flags which influence the parsing. G_KEY_FILE_NONE No flags, default behaviour G_KEY_FILE_KEEP_COMMENTS Use this flag if you plan to write the (possibly modified) contents of the key file back to a file; otherwise all comments will be lost when the key file is written back. G_KEY_FILE_KEEP_TRANSLATIONS Use this flag if you plan to write the (possibly modified) contents of the key file back to a file; otherwise only the translations for the current language will be written back.
Flags specifying the level of log messages. It is possible to change how GLib treats messages of the various levels using g_log_set_handler() and g_log_set_fatal_mask(). G_LOG_FLAG_RECURSION internal flag G_LOG_FLAG_FATAL internal flag G_LOG_LEVEL_ERROR log level for errors, see g_error(). This level is also used for messages produced by g_assert(). G_LOG_LEVEL_CRITICAL log level for critical messages, see g_critical(). This level is also used for messages produced by g_return_if_fail() and g_return_val_if_fail(). G_LOG_LEVEL_WARNING log level for warnings, see g_warning() G_LOG_LEVEL_MESSAGE log level for messages, see g_message() G_LOG_LEVEL_INFO log level for informational messages G_LOG_LEVEL_DEBUG log level for debug messages, see g_debug() G_LOG_LEVEL_MASK a mask including all log levels.
A mixed enumerated type and flags field. You must specify one type (string, strdup, boolean, tristate). Additionally, you may optionally bitwise OR the type with the flag G_MARKUP_COLLECT_OPTIONAL. It is likely that this enum will be extended in the future to support other types. G_MARKUP_COLLECT_INVALID used to terminate the list of attributes to collect G_MARKUP_COLLECT_STRING collect the string pointer directly from the attribute_values[] array. Expects a parameter of type (const char **). If G_MARKUP_COLLECT_OPTIONAL is specified and the attribute isn't present then the pointer will be set to NULL G_MARKUP_COLLECT_STRDUP as with G_MARKUP_COLLECT_STRING, but expects a parameter of type (char **) and g_strdup()s the returned pointer. The pointer must be freed with g_free() G_MARKUP_COLLECT_BOOLEAN expects a parameter of type (gboolean *) and parses the attribute value as a boolean. Sets FALSE if the attribute isn't present. Valid boolean values consist of (case-insensitive) "false", "f", "no", "n", "0" and "true", "t", "yes", "y", "1" G_MARKUP_COLLECT_TRISTATE as with G_MARKUP_COLLECT_BOOLEAN, but in the case of a missing attribute a value is set that compares equal to neither FALSE nor TRUE G_MARKUP_COLLECT_OPTIONAL is implied G_MARKUP_COLLECT_OPTIONAL can be bitwise ORed with the other fields. If present, allows the attribute not to appear. A default value is set depending on what value type is used
Error codes returned by markup parsing. G_MARKUP_ERROR_BAD_UTF8 text being parsed was not valid UTF-8 G_MARKUP_ERROR_EMPTY document contained nothing, or only whitespace G_MARKUP_ERROR_PARSE document was ill-formed G_MARKUP_ERROR_UNKNOWN_ELEMENT error should be set by GMarkupParser functions; element wasn't known G_MARKUP_ERROR_UNKNOWN_ATTRIBUTE error should be set by GMarkupParser functions; attribute wasn't known G_MARKUP_ERROR_INVALID_CONTENT error should be set by GMarkupParser functions; content was invalid G_MARKUP_ERROR_MISSING_ATTRIBUTE error should be set by GMarkupParser functions; a required attribute was missing
Flags that affect the behaviour of the parser. G_MARKUP_DO_NOT_USE_THIS_UNSUPPORTED_FLAG flag you should not use G_MARKUP_TREAT_CDATA_AS_TEXT When this flag is set, CDATA marked sections are not passed literally to the passthrough function of the parser. Instead, the content of the section (without the <![CDATA[ and ]]>) is passed to the text function. This flag was added in GLib 2.12 G_MARKUP_PREFIX_ERROR_POSITION Normally errors caught by GMarkup itself have line/column information prefixed to them to let the caller know the location of the error. When this flag is set the location information is also prefixed to errors generated by the GMarkupParser implementation functions
Flags passed to g_module_open(). Note that these flags are not supported on all platforms. G_MODULE_BIND_LAZY specifies that symbols are only resolved when needed. The default action is to bind all symbols when the module is loaded. G_MODULE_BIND_LOCAL specifies that symbols in the module should not be added to the global name space. The default action on most platforms is to place symbols in the module in the global name space, which may cause conflicts with existing symbols. G_MODULE_BIND_MASK mask for all flags.
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. Unicode strings should generally be normalized before comparing them. G_NORMALIZE_DEFAULT standardize differences that do not affect the text content, such as the above-mentioned accent representation. G_NORMALIZE_NFD another name for G_NORMALIZE_DEFAULT. G_NORMALIZE_DEFAULT_COMPOSE like G_NORMALIZE_DEFAULT, but with composed forms rather than a maximally decomposed form. G_NORMALIZE_NFC another name for G_NORMALIZE_DEFAULT_COMPOSE. G_NORMALIZE_ALL beyond G_NORMALIZE_DEFAULT also standardize the "compatibility" characters in Unicode, such as SUPERSCRIPT THREE to the standard forms (in this case DIGIT THREE). Formatting information may be lost but for most text operations such characters should be considered the same. G_NORMALIZE_NFKD another name for G_NORMALIZE_ALL. G_NORMALIZE_ALL_COMPOSE like G_NORMALIZE_ALL, but with composed forms rather than a maximally decomposed form. G_NORMALIZE_NFKC another name for G_NORMALIZE_ALL_COMPOSE.
The GOptionArg enum values determine which type of extra argument the options expect to find. If an option expects an extra argument, it can be specified in several ways; with a short option: -x arg, with a long option: --name arg or combined in a single argument: --name=arg. G_OPTION_ARG_NONE No extra argument. This is useful for simple flags. G_OPTION_ARG_STRING The option takes a string argument. G_OPTION_ARG_INT The option takes an integer argument. G_OPTION_ARG_CALLBACK The option provides a callback to parse the extra argument. G_OPTION_ARG_FILENAME The option takes a filename as argument. G_OPTION_ARG_STRING_ARRAY The option takes a string argument, multiple uses of the option are collected into an array of strings. G_OPTION_ARG_FILENAME_ARRAY The option takes a filename as argument, multiple uses of the option are collected into an array of strings. G_OPTION_ARG_DOUBLE The option takes a double argument. The argument can be formatted either for the user's locale or for the "C" locale. Since 2.12 G_OPTION_ARG_INT64 The option takes a 64-bit integer. Like G_OPTION_ARG_INT but for larger numbers. The number can be in decimal base, or in hexadecimal (when prefixed with 0x, for example, 0xffffffff). Since 2.12
Error codes returned by option parsing. G_OPTION_ERROR_UNKNOWN_OPTION An option was not known to the parser. This error will only be reported, if the parser hasn't been instructed to ignore unknown options, see g_option_context_set_ignore_unknown_options(). G_OPTION_ERROR_BAD_VALUE A value couldn't be parsed. G_OPTION_ERROR_FAILED A GOptionArgFunc callback failed.
Flags which modify individual options. G_OPTION_FLAG_HIDDEN The option doesn't appear in --help output. G_OPTION_FLAG_IN_MAIN The option appears in the main section of the --help output, even if it is defined in a group. G_OPTION_FLAG_REVERSE For options of the G_OPTION_ARG_NONE kind, this flag indicates that the sense of the option is reversed. G_OPTION_FLAG_NO_ARG For options of the G_OPTION_ARG_CALLBACK kind, this flag indicates that the callback does not take any argument (like a G_OPTION_ARG_NONE option). Since 2.8 G_OPTION_FLAG_FILENAME For options of the G_OPTION_ARG_CALLBACK kind, this flag indicates that the argument should be passed to the callback in the GLib filename encoding rather than UTF-8. Since 2.8 G_OPTION_FLAG_OPTIONAL_ARG For options of the G_OPTION_ARG_CALLBACK kind, this flag indicates that the argument supply is optional. If no argument is given then data of GOptionParseFunc will be set to NULL. Since 2.8 G_OPTION_FLAG_NOALIAS This flag turns off the automatic conflict resolution which prefixes long option names with groupname- if there is a conflict. This option should only be used in situations where aliasing is necessary to model some legacy commandline interface. It is not safe to use this option, unless all option groups are under your direct control. Since 2.8.
Flags specifying compile-time options. G_REGEX_CASELESS Letters in the pattern match both upper- and lowercase letters. This option can be changed within a pattern by a "(?i)" option setting. G_REGEX_MULTILINE By default, GRegex treats the strings as consisting of a single line of characters (even if it actually contains newlines). The "start of line" metacharacter ("^") matches only at the start of the string, while the "end of line" metacharacter ("$") matches only at the end of the string, or before a terminating newline (unless G_REGEX_DOLLAR_ENDONLY is set). When G_REGEX_MULTILINE is set, the "start of line" and "end of line" constructs match immediately following or immediately before any newline in the string, respectively, as well as at the very start and end. This can be changed within a pattern by a "(?m)" option setting. G_REGEX_DOTALL A dot metacharater (".") in the pattern matches all characters, including newlines. Without it, newlines are excluded. This option can be changed within a pattern by a ("?s") option setting. G_REGEX_EXTENDED Whitespace data characters in the pattern are totally ignored except when escaped or inside a character class. Whitespace does not include the VT character (code 11). In addition, characters between an unescaped "#" outside a character class and the next newline character, inclusive, are also ignored. This can be changed within a pattern by a "(?x)" option setting. G_REGEX_ANCHORED The pattern is forced to be "anchored", that is, it is constrained to match only at the first matching point in the string that is being searched. This effect can also be achieved by appropriate constructs in the pattern itself such as the "^" metacharater. G_REGEX_DOLLAR_ENDONLY A dollar metacharacter ("$") in the pattern matches only at the end of the string. Without this option, a dollar also matches immediately before the final character if it is a newline (but not before any other newlines). This option is ignored if G_REGEX_MULTILINE is set. G_REGEX_UNGREEDY Inverts the "greediness" of the quantifiers so that they are not greedy by default, but become greedy if followed by "?". It can also be set by a "(?U)" option setting within the pattern. G_REGEX_RAW Usually strings must be valid UTF-8 strings, using this flag they are considered as a raw sequence of bytes. G_REGEX_NO_AUTO_CAPTURE Disables the use of numbered capturing parentheses in the pattern. Any opening parenthesis that is not followed by "?" behaves as if it were followed by "?:" but named parentheses can still be used for capturing (and they acquire numbers in the usual way). G_REGEX_OPTIMIZE Optimize the regular expression. If the pattern will be used many times, then it may be worth the effort to optimize it to improve the speed of matches. G_REGEX_DUPNAMES Names used to identify capturing subpatterns need not be unique. This can be helpful for certain types of pattern when it is known that only one instance of the named subpattern can ever be matched. G_REGEX_NEWLINE_CR Usually any newline character is recognized, if this option is set, the only recognized newline character is '\r'. G_REGEX_NEWLINE_LF Usually any newline character is recognized, if this option is set, the only recognized newline character is '\n'. G_REGEX_NEWLINE_CRLF Usually any newline character is recognized, if this option is set, the only recognized newline character sequence is '\r\n'. Since 2.14
Error codes returned by regular expressions functions. G_REGEX_ERROR_COMPILE Compilation of the regular expression failed. G_REGEX_ERROR_OPTIMIZE Optimization of the regular expression failed. G_REGEX_ERROR_REPLACE Replacement failed due to an ill-formed replacement string. G_REGEX_ERROR_MATCH The match process failed. G_REGEX_ERROR_INTERNAL Internal error of the regular expression engine. Since 2.16 G_REGEX_ERROR_STRAY_BACKSLASH "\\" at end of pattern. Since 2.16 G_REGEX_ERROR_MISSING_CONTROL_CHAR "\\c" at end of pattern. Since 2.16 G_REGEX_ERROR_UNRECOGNIZED_ESCAPE Unrecognized character follows "\\". Since 2.16 G_REGEX_ERROR_QUANTIFIERS_OUT_OF_ORDER Numbers out of order in "{}" quantifier. Since 2.16 G_REGEX_ERROR_QUANTIFIER_TOO_BIG Number too big in "{}" quantifier. Since 2.16 G_REGEX_ERROR_UNTERMINATED_CHARACTER_CLASS Missing terminating "]" for character class. Since 2.16 G_REGEX_ERROR_INVALID_ESCAPE_IN_CHARACTER_CLASS Invalid escape sequence in character class. Since 2.16 G_REGEX_ERROR_RANGE_OUT_OF_ORDER Range out of order in character class. Since 2.16 G_REGEX_ERROR_NOTHING_TO_REPEAT Nothing to repeat. Since 2.16 G_REGEX_ERROR_UNRECOGNIZED_CHARACTER Unrecognized character after "(?", "(?<" or "(?P". Since 2.16 G_REGEX_ERROR_POSIX_NAMED_CLASS_OUTSIDE_CLASS POSIX named classes are supported only within a class. Since 2.16 G_REGEX_ERROR_UNMATCHED_PARENTHESIS Missing terminating ")" or ")" without opening "(". Since 2.16 G_REGEX_ERROR_INEXISTENT_SUBPATTERN_REFERENCE Reference to non-existent subpattern. Since 2.16 G_REGEX_ERROR_UNTERMINATED_COMMENT Missing terminating ")" after comment. Since 2.16 G_REGEX_ERROR_EXPRESSION_TOO_LARGE Regular expression too large. Since 2.16 G_REGEX_ERROR_MEMORY_ERROR Failed to get memory. Since 2.16 G_REGEX_ERROR_VARIABLE_LENGTH_LOOKBEHIND Lookbehind assertion is not fixed length. Since 2.16 G_REGEX_ERROR_MALFORMED_CONDITION Malformed number or name after "(?(". Since 2.16 G_REGEX_ERROR_TOO_MANY_CONDITIONAL_BRANCHES Conditional group contains more than two branches. Since 2.16 G_REGEX_ERROR_ASSERTION_EXPECTED Assertion expected after "(?(". Since 2.16 G_REGEX_ERROR_UNKNOWN_POSIX_CLASS_NAME Unknown POSIX class name. Since 2.16 G_REGEX_ERROR_POSIX_COLLATING_ELEMENTS_NOT_SUPPORTED POSIX collating elements are not supported. Since 2.16 G_REGEX_ERROR_HEX_CODE_TOO_LARGE Character value in "\\x{...}" sequence is too large. Since 2.16 G_REGEX_ERROR_INVALID_CONDITION Invalid condition "(?(0)". Since 2.16 G_REGEX_ERROR_SINGLE_BYTE_MATCH_IN_LOOKBEHIND \\C not allowed in lookbehind assertion. Since 2.16 G_REGEX_ERROR_INFINITE_LOOP Recursive call could loop indefinitely. Since 2.16 G_REGEX_ERROR_MISSING_SUBPATTERN_NAME_TERMINATOR Missing terminator in subpattern name. Since 2.16 G_REGEX_ERROR_DUPLICATE_SUBPATTERN_NAME Two named subpatterns have the same name. Since 2.16 G_REGEX_ERROR_MALFORMED_PROPERTY Malformed "\\P" or "\\p" sequence. Since 2.16 G_REGEX_ERROR_UNKNOWN_PROPERTY Unknown property name after "\\P" or "\\p". Since 2.16 G_REGEX_ERROR_SUBPATTERN_NAME_TOO_LONG Subpattern name is too long (maximum 32 characters). Since 2.16 G_REGEX_ERROR_TOO_MANY_SUBPATTERNS Too many named subpatterns (maximum 10,000). Since 2.16 G_REGEX_ERROR_INVALID_OCTAL_VALUE Octal value is greater than "\\377". Since 2.16 G_REGEX_ERROR_TOO_MANY_BRANCHES_IN_DEFINE "DEFINE" group contains more than one branch. Since 2.16 G_REGEX_ERROR_DEFINE_REPETION Repeating a "DEFINE" group is not allowed. Since 2.16 G_REGEX_ERROR_INCONSISTENT_NEWLINE_OPTIONS Inconsistent newline options. Since 2.16 G_REGEX_ERROR_MISSING_BACK_REFERENCE "\\g" is not followed by a braced name or an optionally braced non-zero number. Since 2.16 Since 2.14
Flags specifying match-time options. G_REGEX_MATCH_ANCHORED The pattern is forced to be "anchored", that is, it is constrained to match only at the first matching point in the string that is being searched. This effect can also be achieved by appropriate constructs in the pattern itself such as the "^" metacharater. G_REGEX_MATCH_NOTBOL Specifies that first character of the string is not the beginning of a line, so the circumflex metacharacter should not match before it. Setting this without G_REGEX_MULTILINE (at compile time) causes circumflex never to match. This option affects only the behaviour of the circumflex metacharacter, it does not affect "\A". G_REGEX_MATCH_NOTEOL Specifies that the end of the subject string is not the end of a line, so the dollar metacharacter should not match it nor (except in multiline mode) a newline immediately before it. Setting this without G_REGEX_MULTILINE (at compile time) causes dollar never to match. This option affects only the behaviour of the dollar metacharacter, it does not affect "\Z" or "\z". G_REGEX_MATCH_NOTEMPTY An empty string is not considered to be a valid match if this option is set. If there are alternatives in the pattern, they are tried. If all the alternatives match the empty string, the entire match fails. For example, if the pattern "a?b?" is applied to a string not beginning with "a" or "b", it matches the empty string at the start of the string. With this flag set, this match is not valid, so GRegex searches further into the string for occurrences of "a" or "b". G_REGEX_MATCH_PARTIAL Turns on the partial matching feature, for more documentation on partial matching see g_match_info_is_partial_match(). G_REGEX_MATCH_NEWLINE_CR Overrides the newline definition set when creating a new GRegex, setting the '\r' character as line terminator. G_REGEX_MATCH_NEWLINE_LF Overrides the newline definition set when creating a new GRegex, setting the '\n' character as line terminator. G_REGEX_MATCH_NEWLINE_CRLF Overrides the newline definition set when creating a new GRegex, setting the '\r\n' characters as line terminator. G_REGEX_MATCH_NEWLINE_ANY Overrides the newline definition set when creating a new GRegex, any newline character or character sequence is recognized. Since 2.14
An enumeration specifying the base position for a g_io_channel_seek_position() operation. G_SEEK_CUR the current position in the file. G_SEEK_SET the start of the file. G_SEEK_END the end of the file.
Error codes returned by shell functions. G_SHELL_ERROR_BAD_QUOTING Mismatched or otherwise mangled quoting. G_SHELL_ERROR_EMPTY_STRING String to be parsed was empty. G_SHELL_ERROR_FAILED Some other error.
Error codes returned by spawning processes. G_SPAWN_ERROR_FORK Fork failed due to lack of memory. G_SPAWN_ERROR_READ Read or select on pipes failed. G_SPAWN_ERROR_CHDIR Changing to working directory failed. G_SPAWN_ERROR_ACCES execv() returned EACCES. G_SPAWN_ERROR_PERM execv() returned EPERM. G_SPAWN_ERROR_2BIG execv() returned E2BIG. G_SPAWN_ERROR_NOEXEC execv() returned ENOEXEC. G_SPAWN_ERROR_NAMETOOLONG execv() returned ENAMETOOLONG. G_SPAWN_ERROR_NOENT execv() returned ENOENT. G_SPAWN_ERROR_NOMEM execv() returned ENOMEM. G_SPAWN_ERROR_NOTDIR execv() returned ENOTDIR. G_SPAWN_ERROR_LOOP execv() returned ELOOP. G_SPAWN_ERROR_TXTBUSY execv() returned ETXTBUSY. G_SPAWN_ERROR_IO execv() returned EIO. G_SPAWN_ERROR_NFILE execv() returned ENFILE. G_SPAWN_ERROR_MFILE execv() returned EMFILE. G_SPAWN_ERROR_INVAL execv() returned EINVAL. G_SPAWN_ERROR_ISDIR execv() returned EISDIR. G_SPAWN_ERROR_LIBBAD execv() returned ELIBBAD. G_SPAWN_ERROR_FAILED Some other fatal failure, error->message should explain.
Flags passed to g_spawn_sync(), g_spawn_async() and g_spawn_async_with_pipes(). G_SPAWN_LEAVE_DESCRIPTORS_OPEN the parent's open file descriptors will be inherited by the child; otherwise all descriptors except stdin/stdout/stderr will be closed before calling exec() in the child. G_SPAWN_DO_NOT_REAP_CHILD the child will not be automatically reaped; you must use g_child_watch_add() yourself (or call waitpid() or handle SIGCHLD yourself), or the child will become a zombie. G_SPAWN_SEARCH_PATH argv[0] need not be an absolute path, it will be looked for in the user's PATH. G_SPAWN_STDOUT_TO_DEV_NULL the child's standard output will be discarded, instead of going to the same location as the parent's standard output. G_SPAWN_STDERR_TO_DEV_NULL the child's standard error will be discarded. G_SPAWN_CHILD_INHERITS_STDIN the child will inherit the parent's standard input (by default, the child's standard input is attached to /dev/null). G_SPAWN_FILE_AND_ARGV_ZERO the first element of argv is the file to execute, while the remaining elements are the actual argument vector to pass to the file. Normally g_spawn_async_with_pipes() uses argv[0] as the file to execute, and passes all of argv to the child.
Disambiguates a given time in two ways. First, specifies if the given time is in universal or local time. Second, if the time is in local time, specifies if it is local standard time or local daylight time. This is important for the case where the same local time occurs twice (during daylight savings time transitions, for example). G_TIME_TYPE_STANDARD the time is in local standard time G_TIME_TYPE_DAYLIGHT the time is in local daylight time G_TIME_TYPE_UNIVERSAL the time is in UTC
The possible types of token returned from each g_scanner_get_next_token() call. G_TOKEN_EOF the end of the file. G_TOKEN_LEFT_PAREN a '(' character. G_TOKEN_LEFT_CURLY a '{' character. G_TOKEN_RIGHT_CURLY a '}' character.
Specifies which nodes are visited during several of the tree functions, including g_node_traverse() and g_node_find(). G_TRAVERSE_LEAVES only leaf nodes should be visited. This name has been introduced in 2.6, for older version use G_TRAVERSE_LEAFS. G_TRAVERSE_NON_LEAVES only non-leaf nodes should be visited. This name has been introduced in 2.6, for older version use G_TRAVERSE_NON_LEAFS. G_TRAVERSE_ALL all nodes should be visited. G_TRAVERSE_MASK a mask of all traverse flags. G_TRAVERSE_LEAFS identical to G_TRAVERSE_LEAVES. G_TRAVERSE_NON_LEAFS identical to G_TRAVERSE_NON_LEAVES.
Specifies the type of traveral performed by g_tree_traverse(), g_node_traverse() and g_node_find(). G_IN_ORDER vists a node's left child first, then the node itself, then its right child. This is the one to use if you want the output sorted according to the compare function. G_PRE_ORDER visits a node, then its children. G_POST_ORDER visits the node's children, then the node itself. G_LEVEL_ORDER is not implemented for Balanced Binary Trees. For N-ary Trees, it vists the root node first, then its children, then its grandchildren, and so on. Note that this is less efficient than the other orders.
These are the possible line break classifications. The five Hangul types were added in Unicode 4.1, so, has been introduced in GLib 2.10. Note that new types may be added in the future. Applications should be ready to handle unknown values. They may be regarded as G_UNICODE_BREAK_UNKNOWN. See http://www.unicode.org/unicode/reports/tr14/. G_UNICODE_BREAK_MANDATORY Mandatory Break (BK) G_UNICODE_BREAK_CARRIAGE_RETURN Carriage Return (CR) G_UNICODE_BREAK_LINE_FEED Line Feed (LF) G_UNICODE_BREAK_COMBINING_MARK Attached Characters and Combining Marks (CM) G_UNICODE_BREAK_SURROGATE Surrogates (SG) G_UNICODE_BREAK_ZERO_WIDTH_SPACE Zero Width Space (ZW) G_UNICODE_BREAK_INSEPARABLE Inseparable (IN) G_UNICODE_BREAK_NON_BREAKING_GLUE Non-breaking ("Glue") (GL) G_UNICODE_BREAK_CONTINGENT Contingent Break Opportunity (CB) G_UNICODE_BREAK_SPACE Space (SP) G_UNICODE_BREAK_AFTER Break Opportunity After (BA) G_UNICODE_BREAK_BEFORE Break Opportunity Before (BB) G_UNICODE_BREAK_BEFORE_AND_AFTER Break Opportunity Before and After (B2) G_UNICODE_BREAK_HYPHEN Hyphen (HY) G_UNICODE_BREAK_NON_STARTER Nonstarter (NS) G_UNICODE_BREAK_OPEN_PUNCTUATION Opening Punctuation (OP) G_UNICODE_BREAK_CLOSE_PUNCTUATION Closing Punctuation (CL) G_UNICODE_BREAK_QUOTATION Ambiguous Quotation (QU) G_UNICODE_BREAK_EXCLAMATION Exclamation/Interrogation (EX) G_UNICODE_BREAK_IDEOGRAPHIC Ideographic (ID) G_UNICODE_BREAK_NUMERIC Numeric (NU) G_UNICODE_BREAK_INFIX_SEPARATOR Infix Separator (Numeric) (IS) G_UNICODE_BREAK_SYMBOL Symbols Allowing Break After (SY) G_UNICODE_BREAK_ALPHABETIC Ordinary Alphabetic and Symbol Characters (AL) G_UNICODE_BREAK_PREFIX Prefix (Numeric) (PR) G_UNICODE_BREAK_POSTFIX Postfix (Numeric) (PO) G_UNICODE_BREAK_COMPLEX_CONTEXT Complex Content Dependent (South East Asian) (SA) G_UNICODE_BREAK_AMBIGUOUS Ambiguous (Alphabetic or Ideographic) (AI) G_UNICODE_BREAK_UNKNOWN Unknown (XX) G_UNICODE_BREAK_NEXT_LINE Next Line (NL) G_UNICODE_BREAK_WORD_JOINER Word Joiner (WJ) G_UNICODE_BREAK_HANGUL_L_JAMO Hangul L Jamo (JL) G_UNICODE_BREAK_HANGUL_V_JAMO Hangul V Jamo (JV) G_UNICODE_BREAK_HANGUL_T_JAMO Hangul T Jamo (JT) G_UNICODE_BREAK_HANGUL_LV_SYLLABLE Hangul LV Syllable (H2) G_UNICODE_BREAK_HANGUL_LVT_SYLLABLE Hangul LVT Syllable (H3) G_UNICODE_BREAK_CLOSE_PARANTHESIS Closing Parenthesis (CP). Since 2.28
The GUnicodeScript enumeration identifies different writing systems. The values correspond to the names as defined in the Unicode standard. The enumeration has been added in GLib 2.14, and is interchangeable with PangoScript. Note that new types may be added in the future. Applications should be ready to handle unknown values. See Unicode Standard Annex #24: Script names. G_UNICODE_SCRIPT_INVALID_CODE a value never returned from g_unichar_get_script() G_UNICODE_SCRIPT_COMMON a character used by multiple different scripts G_UNICODE_SCRIPT_INHERITED a mark glyph that takes its script from the base glyph to which it is attached G_UNICODE_SCRIPT_ARABIC Arabic G_UNICODE_SCRIPT_ARMENIAN Armenian G_UNICODE_SCRIPT_BENGALI Bengali G_UNICODE_SCRIPT_BOPOMOFO Bopomofo G_UNICODE_SCRIPT_CHEROKEE Cherokee G_UNICODE_SCRIPT_COPTIC Coptic G_UNICODE_SCRIPT_CYRILLIC Cyrillic G_UNICODE_SCRIPT_DESERET Deseret G_UNICODE_SCRIPT_DEVANAGARI Devanagari G_UNICODE_SCRIPT_ETHIOPIC Ethiopic G_UNICODE_SCRIPT_GEORGIAN Georgian G_UNICODE_SCRIPT_GOTHIC Gothic G_UNICODE_SCRIPT_GREEK Greek G_UNICODE_SCRIPT_GUJARATI Gujarati G_UNICODE_SCRIPT_GURMUKHI Gurmukhi G_UNICODE_SCRIPT_HAN Han G_UNICODE_SCRIPT_HANGUL Hangul G_UNICODE_SCRIPT_HEBREW Hebrew G_UNICODE_SCRIPT_HIRAGANA Hiragana G_UNICODE_SCRIPT_KANNADA Kannada G_UNICODE_SCRIPT_KATAKANA Katakana G_UNICODE_SCRIPT_KHMER Khmer G_UNICODE_SCRIPT_LAO Lao G_UNICODE_SCRIPT_LATIN Latin G_UNICODE_SCRIPT_MALAYALAM Malayalam G_UNICODE_SCRIPT_MONGOLIAN Mongolian G_UNICODE_SCRIPT_MYANMAR Myanmar G_UNICODE_SCRIPT_OGHAM Ogham G_UNICODE_SCRIPT_OLD_ITALIC Old Italic G_UNICODE_SCRIPT_ORIYA Oriya G_UNICODE_SCRIPT_RUNIC Runic G_UNICODE_SCRIPT_SINHALA Sinhala G_UNICODE_SCRIPT_SYRIAC Syriac G_UNICODE_SCRIPT_TAMIL Tamil G_UNICODE_SCRIPT_TELUGU Telugu G_UNICODE_SCRIPT_THAANA Thaana G_UNICODE_SCRIPT_THAI Thai G_UNICODE_SCRIPT_TIBETAN Tibetan G_UNICODE_SCRIPT_CANADIAN_ABORIGINAL Canadian Aboriginal G_UNICODE_SCRIPT_YI Yi G_UNICODE_SCRIPT_TAGALOG Tagalog G_UNICODE_SCRIPT_HANUNOO Hanunoo G_UNICODE_SCRIPT_BUHID Buhid G_UNICODE_SCRIPT_TAGBANWA Tagbanwa G_UNICODE_SCRIPT_BRAILLE Braille G_UNICODE_SCRIPT_CYPRIOT Cypriot G_UNICODE_SCRIPT_LIMBU Limbu G_UNICODE_SCRIPT_OSMANYA Osmanya G_UNICODE_SCRIPT_SHAVIAN Shavian G_UNICODE_SCRIPT_LINEAR_B Linear B G_UNICODE_SCRIPT_TAI_LE Tai Le G_UNICODE_SCRIPT_UGARITIC Ugaritic G_UNICODE_SCRIPT_NEW_TAI_LUE New Tai Lue G_UNICODE_SCRIPT_BUGINESE Buginese G_UNICODE_SCRIPT_GLAGOLITIC Glagolitic G_UNICODE_SCRIPT_TIFINAGH Tifinagh G_UNICODE_SCRIPT_SYLOTI_NAGRI Syloti Nagri G_UNICODE_SCRIPT_OLD_PERSIAN Old Persian G_UNICODE_SCRIPT_KHAROSHTHI Kharoshthi G_UNICODE_SCRIPT_UNKNOWN an unassigned code point G_UNICODE_SCRIPT_BALINESE Balinese G_UNICODE_SCRIPT_CUNEIFORM Cuneiform G_UNICODE_SCRIPT_PHOENICIAN Phoenician G_UNICODE_SCRIPT_PHAGS_PA Phags-pa G_UNICODE_SCRIPT_NKO N'Ko G_UNICODE_SCRIPT_KAYAH_LI Kayah Li. Since 2.16.3 G_UNICODE_SCRIPT_LEPCHA Lepcha. Since 2.16.3 G_UNICODE_SCRIPT_REJANG Rejang. Since 2.16.3 G_UNICODE_SCRIPT_SUNDANESE Sundanese. Since 2.16.3 G_UNICODE_SCRIPT_SAURASHTRA Saurashtra. Since 2.16.3 G_UNICODE_SCRIPT_CHAM Cham. Since 2.16.3 G_UNICODE_SCRIPT_OL_CHIKI Ol Chiki. Since 2.16.3 G_UNICODE_SCRIPT_VAI Vai. Since 2.16.3 G_UNICODE_SCRIPT_CARIAN Carian. Since 2.16.3 G_UNICODE_SCRIPT_LYCIAN Lycian. Since 2.16.3 G_UNICODE_SCRIPT_LYDIAN Lydian. Since 2.16.3 G_UNICODE_SCRIPT_AVESTAN Avestan. Since 2.26 G_UNICODE_SCRIPT_BAMUM Bamum. Since 2.26 G_UNICODE_SCRIPT_EGYPTIAN_HIEROGLYPHS Egyptian Hieroglpyhs. Since 2.26 G_UNICODE_SCRIPT_IMPERIAL_ARAMAIC Imperial Aramaic. Since 2.26 G_UNICODE_SCRIPT_INSCRIPTIONAL_PAHLAVI Inscriptional Pahlavi. Since 2.26 G_UNICODE_SCRIPT_INSCRIPTIONAL_PARTHIAN Inscriptional Parthian. Since 2.26 G_UNICODE_SCRIPT_JAVANESE Javanese. Since 2.26 G_UNICODE_SCRIPT_KAITHI Kaithi. Since 2.26 G_UNICODE_SCRIPT_LISU Lisu. Since 2.26 G_UNICODE_SCRIPT_MEETEI_MAYEK Meetei Mayek. Since 2.26 G_UNICODE_SCRIPT_OLD_SOUTH_ARABIAN Old South Arabian. Since 2.26 G_UNICODE_SCRIPT_OLD_TURKIC Old Turkic. Since 2.28 G_UNICODE_SCRIPT_SAMARITAN Samaritan. Since 2.26 G_UNICODE_SCRIPT_TAI_THAM Tai Tham. Since 2.26 G_UNICODE_SCRIPT_TAI_VIET Tai Viet. Since 2.26 G_UNICODE_SCRIPT_BATAK Batak. Since 2.28 G_UNICODE_SCRIPT_BRAHMI Brahmi. Since 2.28 G_UNICODE_SCRIPT_MANDAIC Mandaic. Since 2.28
These are the possible character classifications from the Unicode specification. See http://www.unicode.org/Public/UNIDATA/UnicodeData.html. G_UNICODE_CONTROL General category "Other, Control" (Cc) G_UNICODE_FORMAT General category "Other, Format" (Cf) G_UNICODE_UNASSIGNED General category "Other, Not Assigned" (Cn) G_UNICODE_PRIVATE_USE General category "Other, Private Use" (Co) G_UNICODE_SURROGATE General category "Other, Surrogate" (Cs) G_UNICODE_LOWERCASE_LETTER General category "Letter, Lowercase" (Ll) G_UNICODE_MODIFIER_LETTER General category "Letter, Modifier" (Lm) G_UNICODE_OTHER_LETTER General category "Letter, Other" (Lo) G_UNICODE_TITLECASE_LETTER General category "Letter, Titlecase" (Lt) G_UNICODE_UPPERCASE_LETTER General category "Letter, Uppercase" (Lu) G_UNICODE_COMBINING_MARK General category "Mark, Spacing Combining" (Mc) G_UNICODE_ENCLOSING_MARK General category "Mark, Enclosing" (Me) G_UNICODE_NON_SPACING_MARK General category "Mark, Nonspacing" (Mn) G_UNICODE_DECIMAL_NUMBER General category "Number, Decimal Digit" (Nd) G_UNICODE_LETTER_NUMBER General category "Number, Letter" (Nl) G_UNICODE_OTHER_NUMBER General category "Number, Other" (No) G_UNICODE_CONNECT_PUNCTUATION General category "Punctuation, Connector" (Pc) G_UNICODE_DASH_PUNCTUATION General category "Punctuation, Dash" (Pd) G_UNICODE_CLOSE_PUNCTUATION General category "Punctuation, Close" (Pe) G_UNICODE_FINAL_PUNCTUATION General category "Punctuation, Final quote" (Pf) G_UNICODE_INITIAL_PUNCTUATION General category "Punctuation, Initial quote" (Pi) G_UNICODE_OTHER_PUNCTUATION General category "Punctuation, Other" (Po) G_UNICODE_OPEN_PUNCTUATION General category "Punctuation, Open" (Ps) G_UNICODE_CURRENCY_SYMBOL General category "Symbol, Currency" (Sc) G_UNICODE_MODIFIER_SYMBOL General category "Symbol, Modifier" (Sk) G_UNICODE_MATH_SYMBOL General category "Symbol, Math" (Sm) G_UNICODE_OTHER_SYMBOL General category "Symbol, Other" (So) G_UNICODE_LINE_SEPARATOR General category "Separator, Line" (Zl) G_UNICODE_PARAGRAPH_SEPARATOR General category "Separator, Paragraph" (Zp) G_UNICODE_SPACE_SEPARATOR General category "Separator, Space" (Zs)
These are logical ids for special directories which are defined depending on the platform used. You should use g_get_user_special_dir() to retrieve the full path associated to the logical id. The GUserDirectory enumeration can be extended at later date. Not every platform has a directory for every logical id in this enumeration. G_USER_DIRECTORY_DESKTOP the user's Desktop directory G_USER_DIRECTORY_DOCUMENTS the user's Documents directory G_USER_DIRECTORY_DOWNLOAD the user's Downloads directory G_USER_DIRECTORY_MUSIC the user's Music directory G_USER_DIRECTORY_PICTURES the user's Pictures directory G_USER_DIRECTORY_PUBLIC_SHARE the user's shared directory G_USER_DIRECTORY_TEMPLATES the user's Templates directory G_USER_DIRECTORY_VIDEOS the user's Movies directory G_USER_N_DIRECTORIES the number of enum values Since 2.14
The range of possible top-level types of GVariant instances. G_VARIANT_CLASS_BOOLEAN The GVariant is a boolean. G_VARIANT_CLASS_BYTE The GVariant is a byte. G_VARIANT_CLASS_INT16 The GVariant is a signed 16 bit integer. G_VARIANT_CLASS_UINT16 The GVariant is an unsigned 16 bit integer. G_VARIANT_CLASS_INT32 The GVariant is a signed 32 bit integer. G_VARIANT_CLASS_UINT32 The GVariant is an unsigned 32 bit integer. G_VARIANT_CLASS_INT64 The GVariant is a signed 64 bit integer. G_VARIANT_CLASS_UINT64 The GVariant is an unsigned 64 bit integer. G_VARIANT_CLASS_HANDLE The GVariant is a file handle index. G_VARIANT_CLASS_DOUBLE The GVariant is a double precision floating point value. G_VARIANT_CLASS_STRING The GVariant is a normal string. G_VARIANT_CLASS_OBJECT_PATH The GVariant is a D-Bus object path string. G_VARIANT_CLASS_SIGNATURE The GVariant is a D-Bus signature string. G_VARIANT_CLASS_VARIANT The GVariant is a variant. G_VARIANT_CLASS_MAYBE The GVariant is a maybe-typed value. G_VARIANT_CLASS_ARRAY The GVariant is an array. G_VARIANT_CLASS_TUPLE The GVariant is a tuple. G_VARIANT_CLASS_DICT_ENTRY The GVariant is a dictionary entry. Since 2.24
Error codes returned by parsing text-format GVariants. G_VARIANT_PARSE_ERROR_FAILED generic error (unused) G_VARIANT_PARSE_ERROR_BASIC_TYPE_EXPECTED a non-basic GVariantType was given where a basic type was expected G_VARIANT_PARSE_ERROR_CANNOT_INFER_TYPE cannot infer the GVariantType G_VARIANT_PARSE_ERROR_DEFINITE_TYPE_EXPECTED an indefinite GVariantType was given where a definite type was expected G_VARIANT_PARSE_ERROR_INPUT_NOT_AT_END extra data after parsing finished G_VARIANT_PARSE_ERROR_INVALID_CHARACTER invalid character in number or unicode escape G_VARIANT_PARSE_ERROR_INVALID_FORMAT_STRING not a valid GVariant format string G_VARIANT_PARSE_ERROR_INVALID_OBJECT_PATH not a valid object path G_VARIANT_PARSE_ERROR_INVALID_SIGNATURE not a valid type signature G_VARIANT_PARSE_ERROR_INVALID_TYPE_STRING not a valid GVariant type string G_VARIANT_PARSE_ERROR_NO_COMMON_TYPE could not find a common type for array entries G_VARIANT_PARSE_ERROR_NUMBER_OUT_OF_RANGE the numerical value is out of range of the given type G_VARIANT_PARSE_ERROR_NUMBER_TOO_BIG the numerical value is out of range for any type G_VARIANT_PARSE_ERROR_TYPE_ERROR cannot parse as variant of the specified type G_VARIANT_PARSE_ERROR_UNEXPECTED_TOKEN an unexpected token was encountered G_VARIANT_PARSE_ERROR_UNKNOWN_KEYWORD an unknown keyword was encountered G_VARIANT_PARSE_ERROR_UNTERMINATED_STRING_CONSTANT unterminated string constant G_VARIANT_PARSE_ERROR_VALUE_EXPECTED no value given
Main Gtk struct. Warning GAllocator is deprecated and should not be used in newly-written code. The GAllocator struct contains private data. and should only be accessed using the following functions.
Main Gtk struct. Contains the public fields of an Array. gchar *data; a pointer to the element data. The data may be moved as elements are added to the GArray. guint len; the number of elements in the GArray not including the possible terminating zero element.
Main Gtk struct. The GAsyncQueue struct is an opaque data structure, which represents an asynchronous queue. It should only be accessed through the g_async_queue_* functions.
Main Gtk struct. The GBookmarkFile struct contains only private data and should not be directly accessed.
Main Gtk struct. The GByteArray struct allows access to the public fields of a GByteArray. guint8 *data; a pointer to the element data. The data may be moved as elements are added to the GByteArray. guint len; the number of elements in the GByteArray.
Main Gtk struct. The GCache struct is an opaque data structure containing information about a GCache. It should only be accessed via the following functions.
Main Gtk struct. An opaque structure representing a checksumming operation. To create a new GChecksum, use g_checksum_new(). To free a GChecksum, use g_checksum_free(). Since 2.16
Main Gtk struct. The data structure used for automatic completion. GList *items; list of target items (strings or data structures). GCompletionFunc func; function which is called to get the string associated with a target item. It is NULL if the target items are strings. gchar *prefix; the last prefix passed to g_completion_complete() or g_completion_complete_utf8(). GList *cache; the list of items which begin with prefix. GCompletionStrncmpFunc strncmp_func; The function to use when comparing strings. Use g_completion_set_compare() to modify this function.
Main Gtk struct. The GData struct is an opaque data structure to represent a Keyed Data List. It should only be accessed via the following functions.
Represents a day between January 1, Year 1 and a few thousand years in the future. None of its members should be accessed directly. If the GDate is obtained from g_date_new(), it will be safe to mutate but invalid and thus not safe for calendrical computations. If it's declared on the stack, it will contain garbage so must be initialized with g_date_clear(). g_date_clear() makes the date invalid but sane. An invalid date doesn't represent a day, it's "empty." A date becomes valid after you set it to a Julian day or you set a day, month, and year. guint julian_days : 32; the Julian representation of the date guint julian : 1; this bit is set if julian_days is valid guint dmy : 1; this is set if day, month and year are valid guint day : 6; the day of the day-month-year representation of the date, as a number between 1 and 31 guint month : 4; the day of the day-month-year representation of the date, as a number between 1 and 12 guint year : 16; the day of the day-month-year representation of the date
Main Gtk struct. GDateTime is an opaque structure whose members cannot be accessed directly. Since 2.26
Associates a string with a bit flag. Used in g_parse_debug_string(). const gchar *key; the string guint value; the flag
An opaque structure representing an opened directory.
Main Gtk struct. The GError structure contains information about an error that has occurred. GQuark domain; error domain, e.g. G_FILE_ERROR. gint code; error code, e.g. G_FILE_ERROR_NOENT. gchar *message; human-readable informative error message.
Main Gtk struct. The GHashTable struct is an opaque data structure to represent a Hash Table. It should only be accessed via the following functions.
A GHashTableIter structure represents an iterator that can be used to iterate over the elements of a GHashTable. GHashTableIter structures are typically allocated on the stack and then initialized with g_hash_table_iter_init().
Main Gtk struct. A data structure representing an IO Channel. The fields should be considered private and should only be accessed with the following functions.
A table of functions used to handle different types of GIOChannel in a generic way. io_read () reads raw bytes from the channel. This is called from various functions such as g_io_channel_read_chars() to read raw bytes from the channel. Encoding and buffering issues are dealt with at a higher level. io_write () writes raw bytes to the channel. This is called from various functions such as g_io_channel_write_chars() to write raw bytes to the channel. Encoding and buffering issues are dealt with at a higher level. io_seek () (optional) seeks the channel. This is called from g_io_channel_seek() on channels that support it. io_close () closes the channel. This is called from g_io_channel_close() after flushing the buffers. io_create_watch () creates a watch on the channel. This call corresponds directly to g_io_create_watch(). io_free () called from g_io_channel_unref() when the channel needs to be freed. This function must free the memory associated with the channel, including freeing the GIOChannel structure itself. The channel buffers have been flushed and possibly io_close has been called by the time this function is called. io_set_flags () sets the GIOFlags on the channel. This is called from g_io_channel_set_flags() with all flags except for G_IO_FLAG_APPEND and G_IO_FLAG_NONBLOCK masked out. io_get_flags () gets the GIOFlags for the channel. This function need only return the G_IO_FLAG_APPEND and G_IO_FLAG_NONBLOCK flags; g_io_channel_get_flags() automatically adds the others as appropriate.
Main Gtk struct. The GKeyFile struct contains only private fields and should not be used directly.
Main Gtk struct. The GList struct is used for each element in a doubly-linked list. gpointer data; holds the element's data, which can be a pointer to any kind of data, or any integer value using the Type Conversion Macros. GList *next; contains the link to the next element in the list. GList *prev; contains the link to the previous element in the list.
The GMainContext struct is an opaque data type representing a set of sources to be handled in a main loop.
Main Gtk struct. The GMainLoop struct is an opaque data type representing the main event loop of a GLib or GTK+ application.
The GMappedFile represents a file mapping created with g_mapped_file_new(). It has only private members and should not be accessed directly.
Main Gtk struct. A parse context is used to parse a stream of bytes that you expect to contain marked-up text. See g_markup_parse_context_new(), GMarkupParser, and so on for more details.
Any of the fields in GMarkupParser can be NULL, in which case they will be ignored. Except for the error function, any of these callbacks can set an error; in particular the G_MARKUP_ERROR_UNKNOWN_ELEMENT, G_MARKUP_ERROR_UNKNOWN_ATTRIBUTE, and G_MARKUP_ERROR_INVALID_CONTENT errors are intended to be set from these callbacks. If you set an error from a callback, g_markup_parse_context_parse() will report that error back to its caller. start_element () Callback to invoke when the opening tag of an element is seen. end_element () Callback to invoke when the closing tag of an element is seen. Note that this is also called for empty tags like <empty/>. text () Callback to invoke when some text is seen (text is always inside an element). Note that the text of an element may be spread over multiple calls of this function. If the G_MARKUP_TREAT_CDATA_AS_TEXT flag is set, this function is also called for the content of CDATA marked sections. passthrough () Callback to invoke for comments, processing instructions and doctype declarations; if you're re-writing the parsed document, write the passthrough text back out in the same position. If the G_MARKUP_TREAT_CDATA_AS_TEXT flag is not set, this function is also called for CDATA marked sections. error () Callback to invoke when an error occurs.
GMatchInfo is used to retrieve information about the regular expression match which created it. This structure is opaque and its fields cannot be accessed directly. Since 2.14
Main Gtk struct. Warning GMemChunk is deprecated and should not be used in newly-written code. The GMemChunk struct is an opaque data structure representing a memory chunk. It should be accessed only through the use of the following functions.
A set of functions used to perform memory allocation. The same GMemVTable must be used for all allocations in the same program; a call to g_mem_set_vtable(), if it exists, should be prior to any use of GLib. malloc () function to use for allocating memory. realloc () function to use for reallocating memory. free () function to use to free memory. calloc () function to use for allocating zero-filled memory. try_malloc () function to use for allocating memory without a default error handler. try_realloc () function to use for reallocating memory without a default error handler.
Main Gtk struct. The GModule struct is an opaque data structure to represent a Dynamically-Loaded Module. It should only be accessed via the following functions.
Main Gtk struct. The GNode struct represents one node in a N-ary Tree. fields gpointer data; contains the actual data of the node. GNode *next; points to the node's next sibling (a sibling is another GNode with the same parent). GNode *prev; points to the node's previous sibling. GNode *parent; points to the parent of the GNode, or is NULL if the GNode is the root of the tree. GNode *children; points to the first child of the GNode. The other children are accessed by using the next pointer of each child.
Main Gtk struct. A GOptionContext struct defines which options are accepted by the commandline option parser. The struct has only private fields and should not be directly accessed.
A GOptionEntry defines a single option. To have an effect, they must be added to a GOptionGroup with g_option_context_add_main_entries() or g_option_group_add_entries(). const gchar *long_name; The long name of an option can be used to specify it in a commandline as --long_name. Every option must have a long name. To resolve conflicts if multiple option groups contain the same long name, it is also possible to specify the option as --groupname-long_name. gchar short_name; If an option has a short name, it can be specified -short_name in a commandline. short_name must be a printable ASCII character different from '-', or zero if the option has no short name. gint flags; Flags from GOptionFlags. GOptionArg arg; The type of the option, as a GOptionArg. gpointer arg_data; If the arg type is G_OPTION_ARG_CALLBACK, then arg_data must point to a GOptionArgFunc callback function, which will be called to handle the extra argument. Otherwise, arg_data is a pointer to a location to store the value, the required type of the location depends on the arg type: G_OPTION_ARG_NONE gboolean G_OPTION_ARG_STRING gchar* G_OPTION_ARG_INT gint G_OPTION_ARG_FILENAME gchar* G_OPTION_ARG_STRING_ARRAY gchar** G_OPTION_ARG_FILENAME_ARRAY gchar** G_OPTION_ARG_DOUBLE gdouble If arg type is G_OPTION_ARG_STRING or G_OPTION_ARG_FILENAME the location will contain a newly allocated string if the option was given. That string needs to be freed by the callee using g_free(). Likewise if arg type is G_OPTION_ARG_STRING_ARRAY or G_OPTION_ARG_FILENAME_ARRAY, the data should be freed using g_strfreev(). const gchar *description; the description for the option in --help output. The description is translated using the translate_func of the group, see g_option_group_set_translation_domain(). const gchar *arg_description; The placeholder to use for the extra argument parsed by the option in --help output. The arg_description is translated using the translate_func of the group, see g_option_group_set_translation_domain().
A GOptionGroup struct defines the options in a single group. The struct has only private fields and should not be directly accessed. All options in a group share the same translation function. Libraries which need to parse commandline options are expected to provide a function for getting a GOptionGroup holding their options, which the application can then add to its GOptionContext.
Main Gtk struct. A GPatternSpec is the 'compiled' form of a pattern. This structure is opaque and its fields cannot be accessed directly.
gint64 fd; gint fd; gushort events; a bitwise combination from GIOCondition, specifying which events should be polled for. Typically for reading from a file descriptor you would use G_IO_IN | G_IO_HUP | G_IO_ERR, and for writing you would use G_IO_OUT | G_IO_ERR. gushort revents; a bitwise combination of flags from GIOCondition, returned from the poll() function to indicate which events occurred.
Main Gtk struct. Contains the public fields of a pointer array. gpointer *pdata; points to the array of pointers, which may be moved when the array grows. guint len; number of pointers in the array.
Main Gtk struct. Contains the public fields of a Queue. GList *head; a pointer to the first element of the queue. GList *tail; a pointer to the last element of the queue. guint length; the number of elements in the queue.
Main Gtk struct. The GRand struct is an opaque data structure. It should only be accessed through the g_rand_* functions.
Main Gtk struct. A GRegex is the "compiled" form of a regular expression pattern. This structure is opaque and its fields cannot be accessed directly. Since 2.14
Main Gtk struct. The GRelation struct is an opaque data structure to represent a Relation. It should only be accessed via the following functions.
Main Gtk struct. The GSList struct is used for each element in the singly-linked list. gpointer data; holds the element's data, which can be a pointer to any kind of data, or any integer value using the Type Conversion Macros. GSList *next; contains the link to the next element in the list.
Main Gtk struct. The data structure representing a lexical scanner. You should set input_name after creating the scanner, since it is used by the default message handler when displaying warnings and errors. If you are scanning a file, the file name would be a good choice. The user_data and max_parse_errors fields are not used. If you need to associate extra data with the scanner you can place them here. If you want to use your own message handler you can set the msg_handler field. The type of the message handler function is declared by GScannerMsgFunc. gpointer user_data; guint max_parse_errors; guint parse_errors; const gchar *input_name; GData *qdata; GScannerConfig *config; GTokenType token; token parsed by the last g_scanner_get_next_token() GTokenValue value; value of the last token from g_scanner_get_next_token() guint line; line number of the last token from g_scanner_get_next_token() guint position; char number of the last token from g_scanner_get_next_token() GTokenType next_token; token parsed by the last g_scanner_peek_next_token() GTokenValue next_value; value of the last token from g_scanner_peek_next_token() guint next_line; line number of the last token from g_scanner_peek_next_token() guint next_position; char number of the last token from g_scanner_peek_next_token() GHashTable *symbol_table; gint input_fd; const gchar *text; const gchar *text_end; gchar *buffer; guint scope_id; GScannerMsgFunc msg_handler; function to handle GScanner message output
Specifies the GScanner parser configuration. Most settings can be changed during the parsing phase and will affect the lexical parsing of the next unpeeked token. cset_skip_characters specifies which characters should be skipped by the scanner (the default is the whitespace characters: space, tab, carriage-return and line-feed). cset_identifier_first specifies the characters which can start identifiers (the default is G_CSET_a_2_z, "_", and G_CSET_A_2_Z). cset_identifier_nth specifies the characters which can be used in identifiers, after the first character (the default is G_CSET_a_2_z, "_0123456789", G_CSET_A_2_Z, G_CSET_LATINS, G_CSET_LATINC). cpair_comment_single specifies the characters at the start and end of single-line comments. The default is "#\n" which means that single-line comments start with a '#' and continue until a '\n' (end of line). case_sensitive specifies if symbols are case sensitive (the default is FALSE). skip_comment_multi specifies if multi-line comments are skipped and not returned as tokens (the default is TRUE). skip_comment_single specifies if single-line comments are skipped and not returned as tokens (the default is TRUE). scan_comment_multi specifies if multi-line comments are recognized (the default is TRUE). scan_identifier specifies if identifiers are recognized (the default is TRUE). scan_identifier_1char specifies if single-character identifiers are recognized (the default is FALSE). scan_identifier_NULL specifies if NULL is reported as G_TOKEN_IDENTIFIER_NULL. (the default is FALSE). scan_symbols specifies if symbols are recognized (the default is TRUE). scan_binary specifies if binary numbers are recognized (the default is FALSE). scan_octal specifies if octal numbers are recognized (the default is TRUE). scan_float specifies if floating point numbers are recognized (the default is TRUE). scan_hex specifies if hexadecimal numbers are recognized (the default is TRUE). scan_hex_dollar specifies if '$' is recognized as a prefix for hexadecimal numbers (the default is FALSE). scan_string_sq specifies if strings can be enclosed in single quotes (the default is TRUE). scan_string_dq specifies if strings can be enclosed in double quotes (the default is TRUE). numbers_2_int specifies if binary, octal and hexadecimal numbers are reported as G_TOKEN_INT (the default is TRUE). int_2_float specifies if all numbers are reported as G_TOKEN_FLOAT (the default is FALSE). identifier_2_string specifies if identifiers are reported as strings (the default is FALSE). char_2_token specifies if characters are reported by setting token = ch or as G_TOKEN_CHAR (the default is TRUE). symbol_2_token specifies if symbols are reported by setting token = v_symbol or as G_TOKEN_SYMBOL (the default is FALSE). scope_0_fallback specifies if a symbol is searched for in the default scope in addition to the current scope (the default is FALSE).
Main Gtk struct. The GSequence struct is an opaque data type representing a Sequence data type.
The GSequenceIter struct is an opaque data type representing an iterator pointing into a GSequence.
The GSource struct is an opaque data type representing an event source.
The GSourceCallbackFuncs struct contains functions for managing callback objects. ref () Called when a reference is added to the callback object unref () Called when a reference to the callback object is dropped get () Called to extract the callback function and data from the callback object.
The GSourceFuncs struct contains a table of functions used to handle event sources in a generic manner. For idle sources, the prepare and check functions always return TRUE to indicate that the source is always ready to be processed. The prepare function also returns a timeout value of 0 to ensure that the poll() call doesn't block (since that would be time wasted which could have been spent running the idle function). For timeout sources, the prepare and check functions both return TRUE if the timeout interval has expired. The prepare function also returns a timeout value to ensure that the poll() call doesn't block too long and miss the next timeout. For file descriptor sources, the prepare function typically returns FALSE, since it must wait until poll() has been called before it knows whether any events need to be processed. It sets the returned timeout to -1 to indicate that it doesn't mind how long the poll() call blocks. In the check function, it tests the results of the poll() call to see if the required condition has been met, and returns TRUE if so. prepare () Called before all the file descriptors are polled. If the source can determine that it is ready here (without waiting for the results of the poll() call) it should return TRUE. It can also return a timeout_ value which should be the maximum timeout (in milliseconds) which should be passed to the poll() call. The actual timeout used will be -1 if all sources returned -1, or it will be the minimum of all the timeout_ values returned which were >= 0. check () Called after all the file descriptors are polled. The source should return TRUE if it is ready to be dispatched. Note that some time may have passed since the previous prepare function was called, so the source should be checked again here. dispatch () Called to dispatch the event source, after it has returned TRUE in either its prepare or its check function. The dispatch function is passed in a callback function and data. The callback function may be NULL if the source was never connected to a callback using g_source_set_callback(). The dispatch function should call the callback function with user_data and whatever additional parameters are needed for this type of event source. finalize () Called when the source is finalized. GSourceFunc closure_callback; GSourceDummyMarshal closure_marshal;
A type corresponding to the appropriate struct type for the stat system call, depending on the platform and/or compiler being used. See g_stat() for more information.
Main Gtk struct. The GString struct contains the public fields of a GString. gchar *str; points to the character data. It may move as text is added. The str field is nul-terminated and so can be used as an ordinary C string. gsize len; contains the length of the string, not including the terminating nul byte. gsize allocated_len; the number of bytes that can be stored in the string before it needs to be reallocated. May be larger than len.
Main Gtk struct. An opaque data structure representing String Chunks. It should only be accessed by using the following functions.
Main Gtk struct. The GThreadPool struct represents a thread pool. It has three public read-only members, but the underlying struct is bigger, so you must not copy this struct. GFunc func; the function to execute in the threads of this pool gpointer user_data; the user data for the threads of this pool gboolean exclusive; are all threads exclusive to this pool
Main Gtk struct. Represents a precise time, with seconds and microseconds. Similar to the struct timeval returned by the gettimeofday() UNIX call. GLib is attempting to unify around the use of 64bit integers to represent microsecond-precision time. As such, this type will be removed from a future version of GLib. glong tv_sec; seconds glong tv_usec; microseconds
Main Gtk struct. GDateTime is an opaque structure whose members cannot be accessed directly. Since 2.26
Main Gtk struct. Opaque datatype that records a start time.
A union holding the value of the token.
Main Gtk struct. Each piece of memory that is pushed onto the stack is cast to a GTrashStack*. GTrashStack *next; pointer to the previous element of the stack, gets stored in the first sizeof (gpointer) bytes of the element.
Main Gtk struct. The GTree struct is an opaque data structure representing a Balanced Binary Tree. It should be accessed only by using the following functions.
The GTuples struct is used to return records (or tuples) from the GRelation by g_relation_select(). It only contains one public member - the number of records that matched. To access the matched records, you must use g_tuples_index(). guint len; the number of records that matched.
Main Gtk struct. GVariant is an opaque data structure and can only be accessed using the following functions. Since 2.24
A utility type for constructing container-type GVariant instances. This is an opaque structure and may only be accessed using the following functions. GVariantBuilder is not threadsafe in any way. Do not attempt to access it from more than one thread.
GVariantIter is an opaque data structure and can only be accessed using the following functions.
Main Gtk struct. A type in the GVariant type system. Two types may not be compared by value; use g_variant_type_equal() or g_variant_type_is_subtype_of(). May be copied using g_variant_type_copy() and freed using g_variant_type_free().