gva-categories

gva-categories — Category and MAME Version Information

Synopsis

gboolean            gva_categories_init                 (GError **error);
gchar *             gva_categories_lookup               (const gchar *game,
                                                         GError **error);
gchar *             gva_mame_version_lookup             (const gchar *game,
                                                         GError **error);

Description

These functions provide a game's category and its initial MAME version. The information is read from a catver.ini file.

Details

gva_categories_init ()

gboolean            gva_categories_init                 (GError **error);

Loads the category file. If an error occurs, it returns FALSE and sets error.

This function should be called once when the application starts.

error :

return location for a GError, or NULL

Returns :

TRUE on success, FALSE if an error occurred.

gva_categories_lookup ()

gchar *             gva_categories_lookup               (const gchar *game,
                                                         GError **error);

Returns the category for game. If an error occurs, it returns NULL and sets error.

game :

the name of a game

error :

return location for a GError, or NULL

Returns :

category for game, or NULL if an error occurred

gva_mame_version_lookup ()

gchar *             gva_mame_version_lookup             (const gchar *game,
                                                         GError **error);

returns NULL and sets error.

game :

the name of a game

error :

return location for a GError, or NULL

Returns :

initial MAME version for game, or NULL if an error occurred