tracker_coalesce ()

gchar *
tracker_coalesce (gint n_values,
                  ...);

This function iterates through a series of string pointers passed using @... and returns the first which is not NULL, not empty (i.e. "") and not comprised of one or more spaces (i.e. " ").

The returned value is stripped using g_strstrip(). All other values supplied are freed. It is MOST important NOT to pass constant string pointers to this function!

Since 0.8

tracker_coalesce_strip ()

const gchar *
tracker_coalesce_strip (gint n_values,
                        ...);

This function iterates through a series of string pointers passed using @... and returns the first which is not NULL, not empty (i.e. "") and not comprised of one or more spaces (i.e. " ").

The returned value is stripped using g_strstrip(). It is MOST important NOT to pass constant string pointers to this function!

Since 0.10

tracker_merge ()

gchar *
tracker_merge (const gchar *delimiter,
               gint n_values,
               ...);

This function iterates through a series of string pointers passed using @... and returns a newly allocated string of the merged strings. All passed strings are freed (don't pass const values)/

The delimiter can be NULL. If specified, it will be used in between each merged string in the result.

Since 0.8

tracker_merge_const ()

gchar *
tracker_merge_const (const gchar *delimiter,
                     gint n_values,
                     ...);

This function iterates through a series of string pointers passed using @... and returns a newly allocated string of the merged strings.

The delimiter can be NULL. If specified, it will be used in between each merged string in the result.

Since 0.10

tracker_getline ()

gssize
tracker_getline (gchar **lineptr,
                 gsize *n,
                 FILE *stream);

Reads an entire line from stream, storing the address of the buffer containing the text into *lineptr. The buffer is null-terminated and includes the newline character, if one was found.

Read GNU getline()'s manpage for more information

Since 0.10

tracker_text_normalize ()

gchar *
tracker_text_normalize (const gchar *text,
                        guint max_words,
                        guint *n_words);

This function iterates through text checking for UTF-8 validity using g_utf8_get_char_validated(). For each character found, the GUnicodeType is checked to make sure it is one fo the following values:

All other symbols, punctuation, marks, numbers and separators are stripped. A regular space (i.e. " ") is used to separate the words in the returned string.

The n_words can be NULL. If specified, it will be populated with the number of words that were normalized in the result.

Since 0.8

tracker_text_validate_utf8 ()

gboolean
tracker_text_validate_utf8 (const gchar *text,
                            gssize text_len,
                            GString **str,
                            gsize *valid_len);

This function iterates through text checking for UTF-8 validity using g_utf8_validate(), appends the first chunk of valid characters to str , and gives the number of valid UTF-8 bytes in valid_len .

Since 0.10

tracker_date_format_to_iso8601 ()

gchar *
tracker_date_format_to_iso8601 (const gchar *date_string,
                                const gchar *format);

This function uses strptime() to create a time tm structure using date_string and format .

Since 0.8

tracker_date_guess ()

gchar *
tracker_date_guess (const gchar *date_string);

This function uses a number of methods to try and guess the date held in date_string . The date_string must be at least 5 characters in length or longer for any guessing to be attempted. Some of the string formats guessed include:

Since 0.8

tracker_keywords_parse ()

void
tracker_keywords_parse (GPtrArray *store,
                        const gchar *keywords);

Parses a keywords line into store, avoiding duplicates and stripping leading and trailing spaces from keywords. Allowed delimiters are , and ;

Since 0.10