## gva-history gva-history — Arcade History Management |

## Synopsis

    gboolean            gva_history_init                    (GError **error);
    gchar *             gva_history_lookup                  (const gchar *game,
                                                             GError **error);
    guint               gva_history_lookup_id               (const gchar *game);

## Description

These functions manage the arcade history information shown in the Properties window.

## Details

### gva_history_init ()

    gboolean            gva_history_init                    (GError **error);

Scans the arcade history file and creates an index of games. 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_history_lookup ()

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

Returns arcade history information 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 : | history for `game`, or `NULL` if an error occurred

### gva_history_lookup_id ()

    guint               gva_history_lookup_id               (const gchar *game);

Returns the numeric ID for `game` at http://www.arcade-history.com/. This is used to help locate game-specific resources on the website.

`game` : | the name of a game
Returns : | ID for `game`, or zero if unknown