Go to the source code of this file.
Defines | |
#define | CDDB_CMD_H 1 |
Functions | |
int | cddb_read (cddb_conn_t *c, cddb_disc_t *disc) |
Retrieve a disc record from the CDDB server. | |
int | cddb_query (cddb_conn_t *c, cddb_disc_t *disc) |
Query the CDDB database for a list of possible disc matches. | |
int | cddb_query_next (cddb_conn_t *c, cddb_disc_t *disc) |
Returns the next match in a CDDB query result set. | |
int | cddb_search (cddb_conn_t *c, cddb_disc_t *disc, const char *str) |
Perform a text search in the CDDB database. | |
int | cddb_search_next (cddb_conn_t *c, cddb_disc_t *disc) |
Returns the next match in a CDDB search result set. | |
int | cddb_album (cddb_conn_t *c, cddb_disc_t *disc) |
Perform a text search in the CDDB database. | |
int | cddb_album_next (cddb_conn_t *c, cddb_disc_t *disc) |
Returns the next match in a CDDB album result set. | |
int | cddb_write (cddb_conn_t *c, cddb_disc_t *disc) |
Submit a new or updated disc to the CDDB database. | |
int | cddb_sites (cddb_conn_t *c) |
Query the currently configured server for a list of mirrors. |
#define CDDB_CMD_H 1 |
int cddb_album | ( | cddb_conn_t * | c, | |
cddb_disc_t * | disc | |||
) |
Perform a text search in the CDDB database.
It uses the album command implemented on the freedb2.org servers. Either the album title or artist's name should be filled in, in the disc structure.
If there are multiple matches then only the first one will be returned by this function. For other matches you will have to use the cddb_album_next function.
c | The CDDB connection structure. | |
disc | A non-null CDDB disc structure. |
int cddb_album_next | ( | cddb_conn_t * | c, | |
cddb_disc_t * | disc | |||
) |
Returns the next match in a CDDB album result set.
This function should be used in conjunction with cddb_album.
c | The CDDB connection structure. | |
disc | A non-null CDDB disc structure. |
int cddb_query | ( | cddb_conn_t * | c, | |
cddb_disc_t * | disc | |||
) |
Query the CDDB database for a list of possible disc matches.
This function requires that the disc ID and disc length of the provided disc structure are valid. The disc should also contain a number of tracks and for each track its frame offset on the CD should be valid.
If there are multiple matches then only the first one will be returned by this function. For other matches you will have to use the cddb_query_next function.
c | The CDDB connection structure. | |
disc | A non-null CDDB disc structure. |
int cddb_query_next | ( | cddb_conn_t * | c, | |
cddb_disc_t * | disc | |||
) |
Returns the next match in a CDDB query result set.
This function should be used in conjunction with cddb_query.
c | The CDDB connection structure. | |
disc | A non-null CDDB disc structure. |
int cddb_read | ( | cddb_conn_t * | c, | |
cddb_disc_t * | disc | |||
) |
Retrieve a disc record from the CDDB server.
This function requires that the category and disc ID of the provided disc structure are valid.
If nothing goes wrong, the function will return 1 and the error code will be reset to:
If there is a problem with reading data from the CDDB server one of the following error codes will be set:
When there are problems with the connection to the CDDB server one of the following error codes will be set:
c | The CDDB connection structure. | |
disc | A non-null CDDB disc structure. |
int cddb_search | ( | cddb_conn_t * | c, | |
cddb_disc_t * | disc, | |||
const char * | str | |||
) |
Perform a text search in the CDDB database.
Instead of actually needing information about a real disc like in cddb_query this function accept a string that is used for searching the database.
If there are multiple matches then only the first one will be returned by this function. For other matches you will have to use the cddb_search_next function.
c | The CDDB connection structure. | |
disc | A non-null CDDB disc structure. | |
str | The search string |
int cddb_search_next | ( | cddb_conn_t * | c, | |
cddb_disc_t * | disc | |||
) |
Returns the next match in a CDDB search result set.
This function should be used in conjunction with cddb_search.
c | The CDDB connection structure. | |
disc | A non-null CDDB disc structure. |
int cddb_sites | ( | cddb_conn_t * | c | ) |
Query the currently configured server for a list of mirrors.
Accessing the list of mirror sites is done with the iterator functions cddb_first_site and cddb_next_site.
c | The CDDB connection structure. |
int cddb_write | ( | cddb_conn_t * | c, | |
cddb_disc_t * | disc | |||
) |
Submit a new or updated disc to the CDDB database.
This function requires that the disc ID, length, category, artist and title of the provided disc structure are valid. The disc should also contain a number of tracks and for each track its frame offset on the CD and title should be valid.
c | The CDDB connection structure. | |
disc | A non-null CDDB disc structure. |