1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
|
/*
$Id: do_query.c,v 1.8 2005/07/17 09:42:12 airborne Exp $
Copyright (C) 2003, 2004, 2005 Kris Verbeeck <airborne@advalvas.be>
This library is free software; you can redistribute it and/or
modify it under the terms of the GNU Library General Public
License as published by the Free Software Foundation; either
version 2 of the License, or (at your option) any later version.
This library is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
Library General Public License for more details.
You should have received a copy of the GNU Library General Public
License along with this library; if not, write to the
Free Software Foundation, Inc., 59 Temple Place - Suite 330,
Boston, MA 02111-1307, USA.
*/
#include "main.h"
void do_query(cddb_conn_t *conn, cddb_disc_t *disc, int quiet)
{
int matches, i;
/* This command also requires the disc ID to be initalized
correctly. So we first calculate this disc ID before executing
the query command. */
cddb_disc_calc_discid(disc);
/* Try querying the database for information about the provided
disc. This function will return the number of matches that
were found. A return value of 0 means that no matches were
found. The data of the first match (when found) will be filled
in into the disc structure passed to it. The information will
be retrieved from the server or read from the cache depending
on the connection settings. */
matches = cddb_query(conn, disc);
/* If an error occured then the return value will be -1 and the
internal libcddb error number will be set. */
if (matches == -1) {
/* Print an explanatory message on stderr. Other routines are
available for retrieving the message without printing it or
printing it on a stream other than stderr. */
if (!quiet) {
cddb_error_print(cddb_errno(conn));
}
/* Return to calling fucntion. */
return;
}
printf("Number of matches: %d\n", matches);
/* A CDDB query command will not return all the disc information.
It will return a subset that can afterwards be used to do a
CDDB read. This enables you to first show a pop-up listing the
found matches before doing further reads for the full data.
The data that is returned for each match is: the disc CDDB
category, the disc ID as known by the server, the disc title
and the artist's name. */
/* Let's loop over the matches. */
i = 0;
while (i < matches) {
/* Increment the match counter. */
i++;
/* Print out the information for the current match. */
printf("Match %d\n", i);
/* Retrieve and print the category and disc ID. */
printf(" category: %s (%d)\t%08x\n", cddb_disc_get_category_str(disc),
cddb_disc_get_category(disc), cddb_disc_get_discid(disc));
/* Retrieve and print the disc title and artist name. */
printf(" '%s' by %s\n", cddb_disc_get_title(disc),
cddb_disc_get_artist(disc));
/* Get the next match, if there is one left. */
if (i < matches) {
/* If there are multiple matches, then you can use the
following function to retrieve the matches beyond the
first. This function will overwrite any data that
might be present in the disc structure passed to it.
So if you still need that disc for anything else, then
first create a new disc and use that to call this
function. If there are no more matches left, false
(i.e. 0) will be returned. */
if (!cddb_query_next(conn, disc)) {
error_exit(cddb_errno(conn), "query index out of bounds");
}
}
}
}
|
