## 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 the initial MAME version 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 : | initial MAME version for `game`, or `NULL` if an error occurred