<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html><head><meta http-equiv="Content-Type" content="text/html;charset=iso-8859-1">
<title>libcddb: cddb_disc.h File Reference</title>
<link href="doxygen.css" rel="stylesheet" type="text/css">
<link href="tabs.css" rel="stylesheet" type="text/css">
</head><body>
<!-- Generated by Doxygen 1.4.6 -->
<div class="tabs">
<ul>
<li><a href="index.html"><span>Main Page</span></a></li>
<li id="current"><a href="files.html"><span>Files</span></a></li>
<li><a href="dirs.html"><span>Directories</span></a></li>
</ul></div>
<div class="tabs">
<ul>
<li><a href="files.html"><span>File List</span></a></li>
<li><a href="globals.html"><span>File Members</span></a></li>
</ul></div>
<div class="nav">
<a class="el" href="dir_d95480e064f2cd25d4e283edd80a73aa.html">include</a> » <a class="el" href="dir_847afe0584ab2be2f35afc524ae78865.html">cddb</a></div>
<h1>cddb_disc.h File Reference</h1><code>#include <<a class="el" href="cddb__track_8h-source.html">cddb/cddb_track.h</a>></code><br>
<p>
<a href="cddb__disc_8h-source.html">Go to the source code of this file.</a><table border="0" cellpadding="0" cellspacing="0">
<tr><td></td></tr>
<tr><td colspan="2"><br><h2>Defines</h2></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="cddb__disc_8h.html#9e4a8ac2fcded4efa4022f9c2ca53e40">CDDB_DISC_H</a> 1</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="cddb__disc_8h.html#85f9d29551f1bf30f03229da27cb532f">FRAMES_PER_SECOND</a> 75</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">The number of frames that fit into one second. <a href="#85f9d29551f1bf30f03229da27cb532f"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="cddb__disc_8h.html#34d340123abfbd623ce55423ef85d26e">FRAMES_TO_SECONDS</a>(f) ((f) / FRAMES_PER_SECOND)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">This macro converts an amount of frames into an amount of seconds. <a href="#34d340123abfbd623ce55423ef85d26e"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="cddb__disc_8h.html#b1094dade3bf6305a0961885a9a89f0f">SECONDS_TO_FRAMES</a>(s) ((s) * FRAMES_PER_SECOND)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">This macro converts an amount of seconds into an amount of frames. <a href="#b1094dade3bf6305a0961885a9a89f0f"></a><br></td></tr>
<tr><td colspan="2"><br><h2>Typedefs</h2></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">typedef cddb_disc_s </td><td class="memItemRight" valign="bottom"><a class="el" href="cddb__disc_8h.html#42efa38614123ddc2bcc8a889443ceda">cddb_disc_t</a></td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">The CDDB disc structure. <a href="#42efa38614123ddc2bcc8a889443ceda"></a><br></td></tr>
<tr><td colspan="2"><br><h2>Enumerations</h2></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">enum </td><td class="memItemRight" valign="bottom"><a class="el" href="cddb__disc_8h.html#ea1998e6495d2f0dfa3b6e45b4fcd50d">cddb_cat_t</a> { <br>
<a class="el" href="cddb__disc_8h.html#ea1998e6495d2f0dfa3b6e45b4fcd50d98934efa6d53315c04abb96fa9c58af1">CDDB_CAT_DATA</a> = 0,
<a class="el" href="cddb__disc_8h.html#ea1998e6495d2f0dfa3b6e45b4fcd50dd0dbef3d0e17eb9438e8e52a126e0196">CDDB_CAT_FOLK</a>,
<a class="el" href="cddb__disc_8h.html#ea1998e6495d2f0dfa3b6e45b4fcd50dec9c6e8cae41be169568e88cbe2c7827">CDDB_CAT_JAZZ</a>,
<a class="el" href="cddb__disc_8h.html#ea1998e6495d2f0dfa3b6e45b4fcd50d0f8ff1f94ad8c134bd34c791772d60e7">CDDB_CAT_MISC</a>,
<br>
<a class="el" href="cddb__disc_8h.html#ea1998e6495d2f0dfa3b6e45b4fcd50d57a322c8a25ae9a30b77f0fcea838872">CDDB_CAT_ROCK</a>,
<a class="el" href="cddb__disc_8h.html#ea1998e6495d2f0dfa3b6e45b4fcd50d09fbfaa8f567783640efa381543094d6">CDDB_CAT_COUNTRY</a>,
<a class="el" href="cddb__disc_8h.html#ea1998e6495d2f0dfa3b6e45b4fcd50d6948e6cdbdaa4226e3b98138e8611c12">CDDB_CAT_BLUES</a>,
<a class="el" href="cddb__disc_8h.html#ea1998e6495d2f0dfa3b6e45b4fcd50db49bcb8e0c5692ec2044ff72fc0730fb">CDDB_CAT_NEWAGE</a>,
<br>
<a class="el" href="cddb__disc_8h.html#ea1998e6495d2f0dfa3b6e45b4fcd50db783a71c0cbe283f7fdbd6542c0c0ce6">CDDB_CAT_REGGAE</a>,
<a class="el" href="cddb__disc_8h.html#ea1998e6495d2f0dfa3b6e45b4fcd50d972c8a3921023a3bf3d36a1bc7eea71b">CDDB_CAT_CLASSICAL</a>,
<a class="el" href="cddb__disc_8h.html#ea1998e6495d2f0dfa3b6e45b4fcd50dd14ebd2fbcb735c6b0b691f25e1f5d1a">CDDB_CAT_SOUNDTRACK</a>,
<a class="el" href="cddb__disc_8h.html#ea1998e6495d2f0dfa3b6e45b4fcd50d2ac79dd8e881a742a2f41bffbdf9f837">CDDB_CAT_INVALID</a>,
<br>
<a class="el" href="cddb__disc_8h.html#ea1998e6495d2f0dfa3b6e45b4fcd50dcafef062c916223441fd1bcb8a7d3feb">CDDB_CAT_LAST</a>
<br>
}</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">The different CDDB categories. <a href="cddb__disc_8h.html#ea1998e6495d2f0dfa3b6e45b4fcd50d">More...</a><br></td></tr>
<tr><td colspan="2"><br><h2>Functions</h2></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="cddb__disc_8h.html#42efa38614123ddc2bcc8a889443ceda">cddb_disc_t</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="cddb__disc_8h.html#d3f011e11da576beb06fc0873aa769bc">cddb_disc_new</a> (void)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Creates a new CDDB disc structure. <a href="#d3f011e11da576beb06fc0873aa769bc"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="cddb__disc_8h.html#9bf985f08f176b23dffdee7af8440b21">cddb_disc_destroy</a> (<a class="el" href="cddb__disc_8h.html#42efa38614123ddc2bcc8a889443ceda">cddb_disc_t</a> *disc)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Free all resources associated with the given CDDB disc structure. <a href="#9bf985f08f176b23dffdee7af8440b21"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="cddb__disc_8h.html#42efa38614123ddc2bcc8a889443ceda">cddb_disc_t</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="cddb__disc_8h.html#f2d40d56a702f692fb6c359d0af83277">cddb_disc_clone</a> (const <a class="el" href="cddb__disc_8h.html#42efa38614123ddc2bcc8a889443ceda">cddb_disc_t</a> *disc)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Creates a clone of the given disc. <a href="#f2d40d56a702f692fb6c359d0af83277"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="cddb__disc_8h.html#efcd9b6f9709284955af3f02598ba339">cddb_disc_add_track</a> (<a class="el" href="cddb__disc_8h.html#42efa38614123ddc2bcc8a889443ceda">cddb_disc_t</a> *disc, <a class="el" href="cddb__track_8h.html#1f656d30547194e5a6d9b75406f6b515">cddb_track_t</a> *track)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Add a new track to a disc. <a href="#efcd9b6f9709284955af3f02598ba339"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="cddb__track_8h.html#1f656d30547194e5a6d9b75406f6b515">cddb_track_t</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="cddb__disc_8h.html#af9a585d49e308b061a06119f4466f93">cddb_disc_get_track</a> (const <a class="el" href="cddb__disc_8h.html#42efa38614123ddc2bcc8a889443ceda">cddb_disc_t</a> *disc, int track_no)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Retrieves a numbered track from the disc. <a href="#af9a585d49e308b061a06119f4466f93"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="cddb__track_8h.html#1f656d30547194e5a6d9b75406f6b515">cddb_track_t</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="cddb__disc_8h.html#d77ce7b226c41f297af9270a97a0c5e1">cddb_disc_get_track_first</a> (<a class="el" href="cddb__disc_8h.html#42efa38614123ddc2bcc8a889443ceda">cddb_disc_t</a> *disc)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Returns the first track of the disc. <a href="#d77ce7b226c41f297af9270a97a0c5e1"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="cddb__track_8h.html#1f656d30547194e5a6d9b75406f6b515">cddb_track_t</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="cddb__disc_8h.html#64792c14e85b0d5419c1d2ed5596843f">cddb_disc_get_track_next</a> (<a class="el" href="cddb__disc_8h.html#42efa38614123ddc2bcc8a889443ceda">cddb_disc_t</a> *disc)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Returns the next track on the disc and advances the internal track iterator. <a href="#64792c14e85b0d5419c1d2ed5596843f"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">unsigned int </td><td class="memItemRight" valign="bottom"><a class="el" href="cddb__disc_8h.html#6a2d71c68dfd943575d43094eb96a43b">cddb_disc_get_discid</a> (const <a class="el" href="cddb__disc_8h.html#42efa38614123ddc2bcc8a889443ceda">cddb_disc_t</a> *disc)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Get the ID of the disc. <a href="#6a2d71c68dfd943575d43094eb96a43b"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="cddb__disc_8h.html#5c30ddb662dbfc62cc0992aa6898b794">cddb_disc_set_discid</a> (<a class="el" href="cddb__disc_8h.html#42efa38614123ddc2bcc8a889443ceda">cddb_disc_t</a> *disc, unsigned int id)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Set the ID of the disc. <a href="#5c30ddb662dbfc62cc0992aa6898b794"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="cddb__disc_8h.html#ea1998e6495d2f0dfa3b6e45b4fcd50d">cddb_cat_t</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="cddb__disc_8h.html#6456f3f885f08a54efd1382ccd0408f4">cddb_disc_get_category</a> (const <a class="el" href="cddb__disc_8h.html#42efa38614123ddc2bcc8a889443ceda">cddb_disc_t</a> *disc)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Get the disc CDDB category ID. <a href="#6456f3f885f08a54efd1382ccd0408f4"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="cddb__disc_8h.html#fb23b487f2168c0fa75ebf8b7d641b38">cddb_disc_set_category</a> (<a class="el" href="cddb__disc_8h.html#42efa38614123ddc2bcc8a889443ceda">cddb_disc_t</a> *disc, <a class="el" href="cddb__disc_8h.html#ea1998e6495d2f0dfa3b6e45b4fcd50d">cddb_cat_t</a> cat)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Set the disc CDDB category ID. <a href="#fb23b487f2168c0fa75ebf8b7d641b38"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">const char * </td><td class="memItemRight" valign="bottom"><a class="el" href="cddb__disc_8h.html#b7aa4e8f6be9849f434db3d62bceb5cb">cddb_disc_get_category_str</a> (<a class="el" href="cddb__disc_8h.html#42efa38614123ddc2bcc8a889443ceda">cddb_disc_t</a> *disc)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Get the disc CDDB category as a string. <a href="#b7aa4e8f6be9849f434db3d62bceb5cb"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="cddb__disc_8h.html#a2af35dfbffa7c8a91c9a5fc36671264">cddb_disc_set_category_str</a> (<a class="el" href="cddb__disc_8h.html#42efa38614123ddc2bcc8a889443ceda">cddb_disc_t</a> *disc, const char *cat)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Sets the category of the disc. <a href="#a2af35dfbffa7c8a91c9a5fc36671264"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">const char * </td><td class="memItemRight" valign="bottom"><a class="el" href="cddb__disc_8h.html#091f945e67254eb4fc07082c0fb4c484">cddb_disc_get_genre</a> (const <a class="el" href="cddb__disc_8h.html#42efa38614123ddc2bcc8a889443ceda">cddb_disc_t</a> *disc)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Get the disc genre. <a href="#091f945e67254eb4fc07082c0fb4c484"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="cddb__disc_8h.html#35e3e624c4d55d16faf0f7563d965f1f">cddb_disc_set_genre</a> (<a class="el" href="cddb__disc_8h.html#42efa38614123ddc2bcc8a889443ceda">cddb_disc_t</a> *disc, const char *genre)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Set the disc genre. <a href="#35e3e624c4d55d16faf0f7563d965f1f"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">unsigned int </td><td class="memItemRight" valign="bottom"><a class="el" href="cddb__disc_8h.html#22b7b572663a4ebc3aa605c25601b74b">cddb_disc_get_length</a> (const <a class="el" href="cddb__disc_8h.html#42efa38614123ddc2bcc8a889443ceda">cddb_disc_t</a> *disc)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Get the disc length. <a href="#22b7b572663a4ebc3aa605c25601b74b"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="cddb__disc_8h.html#403ea0c84c8075fefa6adfaad8184c8c">cddb_disc_set_length</a> (<a class="el" href="cddb__disc_8h.html#42efa38614123ddc2bcc8a889443ceda">cddb_disc_t</a> *disc, unsigned int l)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Set the disc length. <a href="#403ea0c84c8075fefa6adfaad8184c8c"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">unsigned int </td><td class="memItemRight" valign="bottom"><a class="el" href="cddb__disc_8h.html#93babf05aaf15b2d933163d8b737586f">cddb_disc_get_year</a> (const <a class="el" href="cddb__disc_8h.html#42efa38614123ddc2bcc8a889443ceda">cddb_disc_t</a> *disc)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Get the year of publication for this disc. <a href="#93babf05aaf15b2d933163d8b737586f"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="cddb__disc_8h.html#160b7bade529a2c286f51e57e37e9aae">cddb_disc_set_year</a> (<a class="el" href="cddb__disc_8h.html#42efa38614123ddc2bcc8a889443ceda">cddb_disc_t</a> *disc, unsigned int y)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Set the year of publication for this disc. <a href="#160b7bade529a2c286f51e57e37e9aae"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="cddb__disc_8h.html#53b3f46734570bd853ae9b1689c8529d">cddb_disc_get_track_count</a> (const <a class="el" href="cddb__disc_8h.html#42efa38614123ddc2bcc8a889443ceda">cddb_disc_t</a> *disc)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Get the number of tracks on the disc. <a href="#53b3f46734570bd853ae9b1689c8529d"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">const char * </td><td class="memItemRight" valign="bottom"><a class="el" href="cddb__disc_8h.html#9d48a38c091fe03197e9fe49b0085b72">cddb_disc_get_title</a> (const <a class="el" href="cddb__disc_8h.html#42efa38614123ddc2bcc8a889443ceda">cddb_disc_t</a> *disc)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Get the disc title. <a href="#9d48a38c091fe03197e9fe49b0085b72"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="cddb__disc_8h.html#b0c2032a4f21ad0e61c30583cc1bb941">cddb_disc_set_title</a> (<a class="el" href="cddb__disc_8h.html#42efa38614123ddc2bcc8a889443ceda">cddb_disc_t</a> *disc, const char *title)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Set the disc title. <a href="#b0c2032a4f21ad0e61c30583cc1bb941"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="cddb__disc_8h.html#0e8654c2dd88aa7df9973553d728c805">cddb_disc_append_title</a> (<a class="el" href="cddb__disc_8h.html#42efa38614123ddc2bcc8a889443ceda">cddb_disc_t</a> *disc, const char *title)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Append to the disc title. <a href="#0e8654c2dd88aa7df9973553d728c805"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">const char * </td><td class="memItemRight" valign="bottom"><a class="el" href="cddb__disc_8h.html#9f966d8c5085d0673257a8b05e31e1af">cddb_disc_get_artist</a> (const <a class="el" href="cddb__disc_8h.html#42efa38614123ddc2bcc8a889443ceda">cddb_disc_t</a> *disc)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Get the disc artist name. <a href="#9f966d8c5085d0673257a8b05e31e1af"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="cddb__disc_8h.html#f565e51732e48511ce5eb50d4849f09e">cddb_disc_set_artist</a> (<a class="el" href="cddb__disc_8h.html#42efa38614123ddc2bcc8a889443ceda">cddb_disc_t</a> *disc, const char *artist)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Set the disc artist name. <a href="#f565e51732e48511ce5eb50d4849f09e"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="cddb__disc_8h.html#37ba4c6c3aa25702e5523dba68169326">cddb_disc_append_artist</a> (<a class="el" href="cddb__disc_8h.html#42efa38614123ddc2bcc8a889443ceda">cddb_disc_t</a> *disc, const char *artist)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Append to the disc artist. <a href="#37ba4c6c3aa25702e5523dba68169326"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">const char * </td><td class="memItemRight" valign="bottom"><a class="el" href="cddb__disc_8h.html#78c6056e55bb22274d6867b7b2db09d7">cddb_disc_get_ext_data</a> (const <a class="el" href="cddb__disc_8h.html#42efa38614123ddc2bcc8a889443ceda">cddb_disc_t</a> *disc)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Get the extended disc data. <a href="#78c6056e55bb22274d6867b7b2db09d7"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="cddb__disc_8h.html#ad940b347f5ef58cec2da0fd105ab0b6">cddb_disc_set_ext_data</a> (<a class="el" href="cddb__disc_8h.html#42efa38614123ddc2bcc8a889443ceda">cddb_disc_t</a> *disc, const char *ext_data)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Set the extended data for the disc. <a href="#ad940b347f5ef58cec2da0fd105ab0b6"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="cddb__disc_8h.html#3f1ec775985eb470dcbe6b07221c4ce0">cddb_disc_append_ext_data</a> (<a class="el" href="cddb__disc_8h.html#42efa38614123ddc2bcc8a889443ceda">cddb_disc_t</a> *disc, const char *ext_data)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Append to the extended disc data. <a href="#3f1ec775985eb470dcbe6b07221c4ce0"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="cddb__disc_8h.html#dbd8b7d0ecf569edf10af5e304a86f3d">cddb_disc_copy</a> (<a class="el" href="cddb__disc_8h.html#42efa38614123ddc2bcc8a889443ceda">cddb_disc_t</a> *dst, <a class="el" href="cddb__disc_8h.html#42efa38614123ddc2bcc8a889443ceda">cddb_disc_t</a> *src)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Copy all data from one disc to another. <a href="#dbd8b7d0ecf569edf10af5e304a86f3d"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="cddb__disc_8h.html#b2fa8d342aceba66a116c24dda7a7d61">cddb_disc_calc_discid</a> (<a class="el" href="cddb__disc_8h.html#42efa38614123ddc2bcc8a889443ceda">cddb_disc_t</a> *disc)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Calculate the CDDB disc ID. <a href="#b2fa8d342aceba66a116c24dda7a7d61"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="cddb__disc_8h.html#243a14dfefa00e988d8bded925cc376e">cddb_disc_print</a> (<a class="el" href="cddb__disc_8h.html#42efa38614123ddc2bcc8a889443ceda">cddb_disc_t</a> *disc)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Prints information about the disc on stdout. <a href="#243a14dfefa00e988d8bded925cc376e"></a><br></td></tr>
<tr><td colspan="2"><br><h2>Variables</h2></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">const char * </td><td class="memItemRight" valign="bottom"><a class="el" href="cddb__disc_8h.html#7daed1a7b8097e953f1666ba44833452">CDDB_CATEGORY</a> [CDDB_CAT_LAST]</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">String values for the CDDB categories. <a href="#7daed1a7b8097e953f1666ba44833452"></a><br></td></tr>
</table>
<hr><h2>Define Documentation</h2>
<a class="anchor" name="9e4a8ac2fcded4efa4022f9c2ca53e40"></a><!-- doxytag: member="cddb_disc.h::CDDB_DISC_H" ref="9e4a8ac2fcded4efa4022f9c2ca53e40" args="" --><p>
<table class="mdTable" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top">#define CDDB_DISC_H 1 </td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
</td>
<td>
<p>
</td>
</tr>
</table>
<a class="anchor" name="85f9d29551f1bf30f03229da27cb532f"></a><!-- doxytag: member="cddb_disc.h::FRAMES_PER_SECOND" ref="85f9d29551f1bf30f03229da27cb532f" args="" --><p>
<table class="mdTable" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top">#define FRAMES_PER_SECOND 75 </td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
</td>
<td>
<p>
The number of frames that fit into one second.
<p>
</td>
</tr>
</table>
<a class="anchor" name="34d340123abfbd623ce55423ef85d26e"></a><!-- doxytag: member="cddb_disc.h::FRAMES_TO_SECONDS" ref="34d340123abfbd623ce55423ef85d26e" args="(f)" --><p>
<table class="mdTable" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top">#define FRAMES_TO_SECONDS </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top">f </td>
<td class="mdname1" valign="top" nowrap> </td>
<td class="md" valign="top"> ) </td>
<td class="md" nowrap> ((f) / FRAMES_PER_SECOND)</td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
</td>
<td>
<p>
This macro converts an amount of frames into an amount of seconds.
<p>
</td>
</tr>
</table>
<a class="anchor" name="b1094dade3bf6305a0961885a9a89f0f"></a><!-- doxytag: member="cddb_disc.h::SECONDS_TO_FRAMES" ref="b1094dade3bf6305a0961885a9a89f0f" args="(s)" --><p>
<table class="mdTable" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top">#define SECONDS_TO_FRAMES </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top">s </td>
<td class="mdname1" valign="top" nowrap> </td>
<td class="md" valign="top"> ) </td>
<td class="md" nowrap> ((s) * FRAMES_PER_SECOND)</td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
</td>
<td>
<p>
This macro converts an amount of seconds into an amount of frames.
<p>
</td>
</tr>
</table>
<hr><h2>Typedef Documentation</h2>
<a class="anchor" name="42efa38614123ddc2bcc8a889443ceda"></a><!-- doxytag: member="cddb_disc.h::cddb_disc_t" ref="42efa38614123ddc2bcc8a889443ceda" args="" --><p>
<table class="mdTable" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top">typedef struct cddb_disc_s <a class="el" href="cddb__disc_8h.html#42efa38614123ddc2bcc8a889443ceda">cddb_disc_t</a> </td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
</td>
<td>
<p>
The CDDB disc structure.
<p>
Contains all information associated with a full CD. </td>
</tr>
</table>
<hr><h2>Enumeration Type Documentation</h2>
<a class="anchor" name="ea1998e6495d2f0dfa3b6e45b4fcd50d"></a><!-- doxytag: member="cddb_disc.h::cddb_cat_t" ref="ea1998e6495d2f0dfa3b6e45b4fcd50d" args="" --><p>
<table class="mdTable" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top">enum <a class="el" href="cddb__disc_8h.html#ea1998e6495d2f0dfa3b6e45b4fcd50d">cddb_cat_t</a> </td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
</td>
<td>
<p>
The different CDDB categories.
<p>
<dl compact><dt><b>Enumerator: </b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"><em><a class="anchor" name="ea1998e6495d2f0dfa3b6e45b4fcd50d98934efa6d53315c04abb96fa9c58af1"></a><!-- doxytag: member="CDDB_CAT_DATA" ref="ea1998e6495d2f0dfa3b6e45b4fcd50d98934efa6d53315c04abb96fa9c58af1" args="" -->CDDB_CAT_DATA</em> </td><td>
data disc </td></tr>
<tr><td valign="top"><em><a class="anchor" name="ea1998e6495d2f0dfa3b6e45b4fcd50dd0dbef3d0e17eb9438e8e52a126e0196"></a><!-- doxytag: member="CDDB_CAT_FOLK" ref="ea1998e6495d2f0dfa3b6e45b4fcd50dd0dbef3d0e17eb9438e8e52a126e0196" args="" -->CDDB_CAT_FOLK</em> </td><td>
folk music </td></tr>
<tr><td valign="top"><em><a class="anchor" name="ea1998e6495d2f0dfa3b6e45b4fcd50dec9c6e8cae41be169568e88cbe2c7827"></a><!-- doxytag: member="CDDB_CAT_JAZZ" ref="ea1998e6495d2f0dfa3b6e45b4fcd50dec9c6e8cae41be169568e88cbe2c7827" args="" -->CDDB_CAT_JAZZ</em> </td><td>
jazz music </td></tr>
<tr><td valign="top"><em><a class="anchor" name="ea1998e6495d2f0dfa3b6e45b4fcd50d0f8ff1f94ad8c134bd34c791772d60e7"></a><!-- doxytag: member="CDDB_CAT_MISC" ref="ea1998e6495d2f0dfa3b6e45b4fcd50d0f8ff1f94ad8c134bd34c791772d60e7" args="" -->CDDB_CAT_MISC</em> </td><td>
miscellaneous, use if no other category matches </td></tr>
<tr><td valign="top"><em><a class="anchor" name="ea1998e6495d2f0dfa3b6e45b4fcd50d57a322c8a25ae9a30b77f0fcea838872"></a><!-- doxytag: member="CDDB_CAT_ROCK" ref="ea1998e6495d2f0dfa3b6e45b4fcd50d57a322c8a25ae9a30b77f0fcea838872" args="" -->CDDB_CAT_ROCK</em> </td><td>
rock and pop music </td></tr>
<tr><td valign="top"><em><a class="anchor" name="ea1998e6495d2f0dfa3b6e45b4fcd50d09fbfaa8f567783640efa381543094d6"></a><!-- doxytag: member="CDDB_CAT_COUNTRY" ref="ea1998e6495d2f0dfa3b6e45b4fcd50d09fbfaa8f567783640efa381543094d6" args="" -->CDDB_CAT_COUNTRY</em> </td><td>
country music </td></tr>
<tr><td valign="top"><em><a class="anchor" name="ea1998e6495d2f0dfa3b6e45b4fcd50d6948e6cdbdaa4226e3b98138e8611c12"></a><!-- doxytag: member="CDDB_CAT_BLUES" ref="ea1998e6495d2f0dfa3b6e45b4fcd50d6948e6cdbdaa4226e3b98138e8611c12" args="" -->CDDB_CAT_BLUES</em> </td><td>
blues music </td></tr>
<tr><td valign="top"><em><a class="anchor" name="ea1998e6495d2f0dfa3b6e45b4fcd50db49bcb8e0c5692ec2044ff72fc0730fb"></a><!-- doxytag: member="CDDB_CAT_NEWAGE" ref="ea1998e6495d2f0dfa3b6e45b4fcd50db49bcb8e0c5692ec2044ff72fc0730fb" args="" -->CDDB_CAT_NEWAGE</em> </td><td>
new age music </td></tr>
<tr><td valign="top"><em><a class="anchor" name="ea1998e6495d2f0dfa3b6e45b4fcd50db783a71c0cbe283f7fdbd6542c0c0ce6"></a><!-- doxytag: member="CDDB_CAT_REGGAE" ref="ea1998e6495d2f0dfa3b6e45b4fcd50db783a71c0cbe283f7fdbd6542c0c0ce6" args="" -->CDDB_CAT_REGGAE</em> </td><td>
reggae music </td></tr>
<tr><td valign="top"><em><a class="anchor" name="ea1998e6495d2f0dfa3b6e45b4fcd50d972c8a3921023a3bf3d36a1bc7eea71b"></a><!-- doxytag: member="CDDB_CAT_CLASSICAL" ref="ea1998e6495d2f0dfa3b6e45b4fcd50d972c8a3921023a3bf3d36a1bc7eea71b" args="" -->CDDB_CAT_CLASSICAL</em> </td><td>
classical music </td></tr>
<tr><td valign="top"><em><a class="anchor" name="ea1998e6495d2f0dfa3b6e45b4fcd50dd14ebd2fbcb735c6b0b691f25e1f5d1a"></a><!-- doxytag: member="CDDB_CAT_SOUNDTRACK" ref="ea1998e6495d2f0dfa3b6e45b4fcd50dd14ebd2fbcb735c6b0b691f25e1f5d1a" args="" -->CDDB_CAT_SOUNDTRACK</em> </td><td>
soundtracks </td></tr>
<tr><td valign="top"><em><a class="anchor" name="ea1998e6495d2f0dfa3b6e45b4fcd50d2ac79dd8e881a742a2f41bffbdf9f837"></a><!-- doxytag: member="CDDB_CAT_INVALID" ref="ea1998e6495d2f0dfa3b6e45b4fcd50d2ac79dd8e881a742a2f41bffbdf9f837" args="" -->CDDB_CAT_INVALID</em> </td><td>
(internal) invalid category </td></tr>
<tr><td valign="top"><em><a class="anchor" name="ea1998e6495d2f0dfa3b6e45b4fcd50dcafef062c916223441fd1bcb8a7d3feb"></a><!-- doxytag: member="CDDB_CAT_LAST" ref="ea1998e6495d2f0dfa3b6e45b4fcd50dcafef062c916223441fd1bcb8a7d3feb" args="" -->CDDB_CAT_LAST</em> </td><td>
(internal) category counter </td></tr>
</table>
</dl>
</td>
</tr>
</table>
<hr><h2>Function Documentation</h2>
<a class="anchor" name="efcd9b6f9709284955af3f02598ba339"></a><!-- doxytag: member="cddb_disc.h::cddb_disc_add_track" ref="efcd9b6f9709284955af3f02598ba339" args="(cddb_disc_t *disc, cddb_track_t *track)" --><p>
<table class="mdTable" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top">void cddb_disc_add_track </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="cddb__disc_8h.html#42efa38614123ddc2bcc8a889443ceda">cddb_disc_t</a> * </td>
<td class="mdname" nowrap> <em>disc</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td class="md"></td>
<td class="md" nowrap><a class="el" href="cddb__track_8h.html#1f656d30547194e5a6d9b75406f6b515">cddb_track_t</a> * </td>
<td class="mdname" nowrap> <em>track</em></td>
</tr>
<tr>
<td class="md"></td>
<td class="md">) </td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
</td>
<td>
<p>
Add a new track to a disc.
<p>
The track is added to the end of the existing list of tracks.<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>disc</em> </td><td>The CDDB disc structure. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>track</em> </td><td>The CDDB track structure. </td></tr>
</table>
</dl>
</td>
</tr>
</table>
<a class="anchor" name="37ba4c6c3aa25702e5523dba68169326"></a><!-- doxytag: member="cddb_disc.h::cddb_disc_append_artist" ref="37ba4c6c3aa25702e5523dba68169326" args="(cddb_disc_t *disc, const char *artist)" --><p>
<table class="mdTable" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top">void cddb_disc_append_artist </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="cddb__disc_8h.html#42efa38614123ddc2bcc8a889443ceda">cddb_disc_t</a> * </td>
<td class="mdname" nowrap> <em>disc</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td class="md"></td>
<td class="md" nowrap>const char * </td>
<td class="mdname" nowrap> <em>artist</em></td>
</tr>
<tr>
<td class="md"></td>
<td class="md">) </td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
</td>
<td>
<p>
Append to the disc artist.
<p>
If the disc does not have an artist yet, then a new one will be created from the given string, otherwise that string will be appended to the existing artist.<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>disc</em> </td><td>The CDDB disc structure. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>artist</em> </td><td>Part of the artist name. </td></tr>
</table>
</dl>
</td>
</tr>
</table>
<a class="anchor" name="3f1ec775985eb470dcbe6b07221c4ce0"></a><!-- doxytag: member="cddb_disc.h::cddb_disc_append_ext_data" ref="3f1ec775985eb470dcbe6b07221c4ce0" args="(cddb_disc_t *disc, const char *ext_data)" --><p>
<table class="mdTable" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top">void cddb_disc_append_ext_data </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="cddb__disc_8h.html#42efa38614123ddc2bcc8a889443ceda">cddb_disc_t</a> * </td>
<td class="mdname" nowrap> <em>disc</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td class="md"></td>
<td class="md" nowrap>const char * </td>
<td class="mdname" nowrap> <em>ext_data</em></td>
</tr>
<tr>
<td class="md"></td>
<td class="md">) </td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
</td>
<td>
<p>
Append to the extended disc data.
<p>
If the disc does not have an extended data section yet, then a new one will be created from the given string, otherwise that string will be appended to the existing data.<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>disc</em> </td><td>The CDDB disc structure. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>ext_data</em> </td><td>Part of the extended disc data. </td></tr>
</table>
</dl>
</td>
</tr>
</table>
<a class="anchor" name="0e8654c2dd88aa7df9973553d728c805"></a><!-- doxytag: member="cddb_disc.h::cddb_disc_append_title" ref="0e8654c2dd88aa7df9973553d728c805" args="(cddb_disc_t *disc, const char *title)" --><p>
<table class="mdTable" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top">void cddb_disc_append_title </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="cddb__disc_8h.html#42efa38614123ddc2bcc8a889443ceda">cddb_disc_t</a> * </td>
<td class="mdname" nowrap> <em>disc</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td class="md"></td>
<td class="md" nowrap>const char * </td>
<td class="mdname" nowrap> <em>title</em></td>
</tr>
<tr>
<td class="md"></td>
<td class="md">) </td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
</td>
<td>
<p>
Append to the disc title.
<p>
If the disc does not have a title yet, then a new one will be created from the given string, otherwise that string will be appended to the existing title.<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>disc</em> </td><td>The CDDB disc structure. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>title</em> </td><td>Part of the disc title. </td></tr>
</table>
</dl>
</td>
</tr>
</table>
<a class="anchor" name="b2fa8d342aceba66a116c24dda7a7d61"></a><!-- doxytag: member="cddb_disc.h::cddb_disc_calc_discid" ref="b2fa8d342aceba66a116c24dda7a7d61" args="(cddb_disc_t *disc)" --><p>
<table class="mdTable" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top">int cddb_disc_calc_discid </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="cddb__disc_8h.html#42efa38614123ddc2bcc8a889443ceda">cddb_disc_t</a> * </td>
<td class="mdname1" valign="top" nowrap> <em>disc</em> </td>
<td class="md" valign="top"> ) </td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
</td>
<td>
<p>
Calculate the CDDB disc ID.
<p>
To calculate a disc ID the provided disc needs to have its length set, and every track in the disc structure needs to have its frame offset initialized. The disc ID field will be set in the disc structure.<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>disc</em> </td><td>The CDDB disc structure. </td></tr>
</table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>A non-zero value if the calculation succeeded, zero otherwise. </dd></dl>
</td>
</tr>
</table>
<a class="anchor" name="f2d40d56a702f692fb6c359d0af83277"></a><!-- doxytag: member="cddb_disc.h::cddb_disc_clone" ref="f2d40d56a702f692fb6c359d0af83277" args="(const cddb_disc_t *disc)" --><p>
<table class="mdTable" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"><a class="el" href="cddb__disc_8h.html#42efa38614123ddc2bcc8a889443ceda">cddb_disc_t</a>* cddb_disc_clone </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top">const <a class="el" href="cddb__disc_8h.html#42efa38614123ddc2bcc8a889443ceda">cddb_disc_t</a> * </td>
<td class="mdname1" valign="top" nowrap> <em>disc</em> </td>
<td class="md" valign="top"> ) </td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
</td>
<td>
<p>
Creates a clone of the given disc.
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>disc</em> </td><td>The CDDB disc structure. </td></tr>
</table>
</dl>
</td>
</tr>
</table>
<a class="anchor" name="dbd8b7d0ecf569edf10af5e304a86f3d"></a><!-- doxytag: member="cddb_disc.h::cddb_disc_copy" ref="dbd8b7d0ecf569edf10af5e304a86f3d" args="(cddb_disc_t *dst, cddb_disc_t *src)" --><p>
<table class="mdTable" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top">void cddb_disc_copy </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="cddb__disc_8h.html#42efa38614123ddc2bcc8a889443ceda">cddb_disc_t</a> * </td>
<td class="mdname" nowrap> <em>dst</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td class="md"></td>
<td class="md" nowrap><a class="el" href="cddb__disc_8h.html#42efa38614123ddc2bcc8a889443ceda">cddb_disc_t</a> * </td>
<td class="mdname" nowrap> <em>src</em></td>
</tr>
<tr>
<td class="md"></td>
<td class="md">) </td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
</td>
<td>
<p>
Copy all data from one disc to another.
<p>
Any fields that are unavailable in the source disc structure will not result in a reset of the same field in the destination disc structure; e.g. if there is no title in the source disc, but there is one in the destination disc, then the destination's title will remain unchanged.<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>dst</em> </td><td>The destination CDDB disc structure. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>src</em> </td><td>The source CDDB disc structure. </td></tr>
</table>
</dl>
</td>
</tr>
</table>
<a class="anchor" name="9bf985f08f176b23dffdee7af8440b21"></a><!-- doxytag: member="cddb_disc.h::cddb_disc_destroy" ref="9bf985f08f176b23dffdee7af8440b21" args="(cddb_disc_t *disc)" --><p>
<table class="mdTable" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top">void cddb_disc_destroy </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="cddb__disc_8h.html#42efa38614123ddc2bcc8a889443ceda">cddb_disc_t</a> * </td>
<td class="mdname1" valign="top" nowrap> <em>disc</em> </td>
<td class="md" valign="top"> ) </td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
</td>
<td>
<p>
Free all resources associated with the given CDDB disc structure.
<p>
The tracks will also be freed automatically.<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>disc</em> </td><td>The CDDB disc structure. </td></tr>
</table>
</dl>
</td>
</tr>
</table>
<a class="anchor" name="9f966d8c5085d0673257a8b05e31e1af"></a><!-- doxytag: member="cddb_disc.h::cddb_disc_get_artist" ref="9f966d8c5085d0673257a8b05e31e1af" args="(const cddb_disc_t *disc)" --><p>
<table class="mdTable" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top">const char* cddb_disc_get_artist </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top">const <a class="el" href="cddb__disc_8h.html#42efa38614123ddc2bcc8a889443ceda">cddb_disc_t</a> * </td>
<td class="mdname1" valign="top" nowrap> <em>disc</em> </td>
<td class="md" valign="top"> ) </td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
</td>
<td>
<p>
Get the disc artist name.
<p>
If the disc is invalid or no artist is set then NULL will be returned.<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>disc</em> </td><td>The CDDB disc structure. </td></tr>
</table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>The disc artist name. </dd></dl>
</td>
</tr>
</table>
<a class="anchor" name="6456f3f885f08a54efd1382ccd0408f4"></a><!-- doxytag: member="cddb_disc.h::cddb_disc_get_category" ref="6456f3f885f08a54efd1382ccd0408f4" args="(const cddb_disc_t *disc)" --><p>
<table class="mdTable" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"><a class="el" href="cddb__disc_8h.html#ea1998e6495d2f0dfa3b6e45b4fcd50d">cddb_cat_t</a> cddb_disc_get_category </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top">const <a class="el" href="cddb__disc_8h.html#42efa38614123ddc2bcc8a889443ceda">cddb_disc_t</a> * </td>
<td class="mdname1" valign="top" nowrap> <em>disc</em> </td>
<td class="md" valign="top"> ) </td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
</td>
<td>
<p>
Get the disc CDDB category ID.
<p>
If the disc is invalid or no category is set then CDDB_CAT_INVALID will be returned. If you want a string representation of the category use the cddb_disc_get_category_str function.<p>
<dl compact><dt><b>See also:</b></dt><dd><a class="el" href="cddb__disc_8h.html#fb23b487f2168c0fa75ebf8b7d641b38">cddb_disc_set_category</a> <p>
<a class="el" href="cddb__disc_8h.html#b7aa4e8f6be9849f434db3d62bceb5cb">cddb_disc_get_category_str</a> <p>
<a class="el" href="cddb__disc_8h.html#a2af35dfbffa7c8a91c9a5fc36671264">cddb_disc_set_category_str</a> <p>
<a class="el" href="cddb__disc_8h.html#ea1998e6495d2f0dfa3b6e45b4fcd50d">cddb_cat_t</a> <p>
<a class="el" href="cddb__disc_8h.html#7daed1a7b8097e953f1666ba44833452">CDDB_CATEGORY</a></dd></dl>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>disc</em> </td><td>The CDDB disc structure. </td></tr>
</table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>The CDDB category ID. </dd></dl>
</td>
</tr>
</table>
<a class="anchor" name="b7aa4e8f6be9849f434db3d62bceb5cb"></a><!-- doxytag: member="cddb_disc.h::cddb_disc_get_category_str" ref="b7aa4e8f6be9849f434db3d62bceb5cb" args="(cddb_disc_t *disc)" --><p>
<table class="mdTable" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top">const char* cddb_disc_get_category_str </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="cddb__disc_8h.html#42efa38614123ddc2bcc8a889443ceda">cddb_disc_t</a> * </td>
<td class="mdname1" valign="top" nowrap> <em>disc</em> </td>
<td class="md" valign="top"> ) </td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
</td>
<td>
<p>
Get the disc CDDB category as a string.
<p>
If no category is set for this disc then 'invalid' will be returned. If the disc structure is invalid NULL is returned. If you only want the ID of the category use the cddb_disc_get_category function.<p>
<dl compact><dt><b>See also:</b></dt><dd><a class="el" href="cddb__disc_8h.html#6456f3f885f08a54efd1382ccd0408f4">cddb_disc_get_category</a> <p>
<a class="el" href="cddb__disc_8h.html#fb23b487f2168c0fa75ebf8b7d641b38">cddb_disc_set_category</a> <p>
<a class="el" href="cddb__disc_8h.html#a2af35dfbffa7c8a91c9a5fc36671264">cddb_disc_set_category_str</a></dd></dl>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>disc</em> </td><td>The CDDB disc structure. </td></tr>
</table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>The CDDB category ID. </dd></dl>
</td>
</tr>
</table>
<a class="anchor" name="6a2d71c68dfd943575d43094eb96a43b"></a><!-- doxytag: member="cddb_disc.h::cddb_disc_get_discid" ref="6a2d71c68dfd943575d43094eb96a43b" args="(const cddb_disc_t *disc)" --><p>
<table class="mdTable" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top">unsigned int cddb_disc_get_discid </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top">const <a class="el" href="cddb__disc_8h.html#42efa38614123ddc2bcc8a889443ceda">cddb_disc_t</a> * </td>
<td class="mdname1" valign="top" nowrap> <em>disc</em> </td>
<td class="md" valign="top"> ) </td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
</td>
<td>
<p>
Get the ID of the disc.
<p>
If the disc is invalid or the disc ID is not yet initialized 0 will be returned.<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>disc</em> </td><td>The CDDB disc structure. </td></tr>
</table>
</dl>
</td>
</tr>
</table>
<a class="anchor" name="78c6056e55bb22274d6867b7b2db09d7"></a><!-- doxytag: member="cddb_disc.h::cddb_disc_get_ext_data" ref="78c6056e55bb22274d6867b7b2db09d7" args="(const cddb_disc_t *disc)" --><p>
<table class="mdTable" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top">const char* cddb_disc_get_ext_data </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top">const <a class="el" href="cddb__disc_8h.html#42efa38614123ddc2bcc8a889443ceda">cddb_disc_t</a> * </td>
<td class="mdname1" valign="top" nowrap> <em>disc</em> </td>
<td class="md" valign="top"> ) </td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
</td>
<td>
<p>
Get the extended disc data.
<p>
If the disc is invalid or no extended data is set then NULL will be returned.<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>disc</em> </td><td>The CDDB disc structure. </td></tr>
</table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>The extended data. </dd></dl>
</td>
</tr>
</table>
<a class="anchor" name="091f945e67254eb4fc07082c0fb4c484"></a><!-- doxytag: member="cddb_disc.h::cddb_disc_get_genre" ref="091f945e67254eb4fc07082c0fb4c484" args="(const cddb_disc_t *disc)" --><p>
<table class="mdTable" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top">const char* cddb_disc_get_genre </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top">const <a class="el" href="cddb__disc_8h.html#42efa38614123ddc2bcc8a889443ceda">cddb_disc_t</a> * </td>
<td class="mdname1" valign="top" nowrap> <em>disc</em> </td>
<td class="md" valign="top"> ) </td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
</td>
<td>
<p>
Get the disc genre.
<p>
If no genre is set for this disc then NULL will be returned. As opposed to the disc category, this field is not limited to a predefined set.<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>disc</em> </td><td>The CDDB disc structure. </td></tr>
</table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>The disc genre. </dd></dl>
</td>
</tr>
</table>
<a class="anchor" name="22b7b572663a4ebc3aa605c25601b74b"></a><!-- doxytag: member="cddb_disc.h::cddb_disc_get_length" ref="22b7b572663a4ebc3aa605c25601b74b" args="(const cddb_disc_t *disc)" --><p>
<table class="mdTable" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top">unsigned int cddb_disc_get_length </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top">const <a class="el" href="cddb__disc_8h.html#42efa38614123ddc2bcc8a889443ceda">cddb_disc_t</a> * </td>
<td class="mdname1" valign="top" nowrap> <em>disc</em> </td>
<td class="md" valign="top"> ) </td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
</td>
<td>
<p>
Get the disc length.
<p>
If no length is set for this disc then 0 will be returned.<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>disc</em> </td><td>The CDDB disc structure. </td></tr>
</table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>The disc length in seconds. </dd></dl>
</td>
</tr>
</table>
<a class="anchor" name="9d48a38c091fe03197e9fe49b0085b72"></a><!-- doxytag: member="cddb_disc.h::cddb_disc_get_title" ref="9d48a38c091fe03197e9fe49b0085b72" args="(const cddb_disc_t *disc)" --><p>
<table class="mdTable" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top">const char* cddb_disc_get_title </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top">const <a class="el" href="cddb__disc_8h.html#42efa38614123ddc2bcc8a889443ceda">cddb_disc_t</a> * </td>
<td class="mdname1" valign="top" nowrap> <em>disc</em> </td>
<td class="md" valign="top"> ) </td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
</td>
<td>
<p>
Get the disc title.
<p>
If the disc is invalid or no title is set then NULL will be returned.<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>disc</em> </td><td>The CDDB disc structure. </td></tr>
</table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>The disc title. </dd></dl>
</td>
</tr>
</table>
<a class="anchor" name="af9a585d49e308b061a06119f4466f93"></a><!-- doxytag: member="cddb_disc.h::cddb_disc_get_track" ref="af9a585d49e308b061a06119f4466f93" args="(const cddb_disc_t *disc, int track_no)" --><p>
<table class="mdTable" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"><a class="el" href="cddb__track_8h.html#1f656d30547194e5a6d9b75406f6b515">cddb_track_t</a>* cddb_disc_get_track </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top">const <a class="el" href="cddb__disc_8h.html#42efa38614123ddc2bcc8a889443ceda">cddb_disc_t</a> * </td>
<td class="mdname" nowrap> <em>disc</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td class="md"></td>
<td class="md" nowrap>int </td>
<td class="mdname" nowrap> <em>track_no</em></td>
</tr>
<tr>
<td class="md"></td>
<td class="md">) </td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
</td>
<td>
<p>
Retrieves a numbered track from the disc.
<p>
If there is no track with the given number, then NULL will be returned.<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>disc</em> </td><td>The CDDB disc structure. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>track_no</em> </td><td>The track number; starting at 0. </td></tr>
</table>
</dl>
</td>
</tr>
</table>
<a class="anchor" name="53b3f46734570bd853ae9b1689c8529d"></a><!-- doxytag: member="cddb_disc.h::cddb_disc_get_track_count" ref="53b3f46734570bd853ae9b1689c8529d" args="(const cddb_disc_t *disc)" --><p>
<table class="mdTable" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top">int cddb_disc_get_track_count </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top">const <a class="el" href="cddb__disc_8h.html#42efa38614123ddc2bcc8a889443ceda">cddb_disc_t</a> * </td>
<td class="mdname1" valign="top" nowrap> <em>disc</em> </td>
<td class="md" valign="top"> ) </td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
</td>
<td>
<p>
Get the number of tracks on the disc.
<p>
If the disc is invalid -1 is returned.<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>disc</em> </td><td>The CDDB disc structure. </td></tr>
</table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>The number of tracks. </dd></dl>
</td>
</tr>
</table>
<a class="anchor" name="d77ce7b226c41f297af9270a97a0c5e1"></a><!-- doxytag: member="cddb_disc.h::cddb_disc_get_track_first" ref="d77ce7b226c41f297af9270a97a0c5e1" args="(cddb_disc_t *disc)" --><p>
<table class="mdTable" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"><a class="el" href="cddb__track_8h.html#1f656d30547194e5a6d9b75406f6b515">cddb_track_t</a>* cddb_disc_get_track_first </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="cddb__disc_8h.html#42efa38614123ddc2bcc8a889443ceda">cddb_disc_t</a> * </td>
<td class="mdname1" valign="top" nowrap> <em>disc</em> </td>
<td class="md" valign="top"> ) </td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
</td>
<td>
<p>
Returns the first track of the disc.
<p>
If there is no such track then NULL will be returned. The internal track iterator will also be reset. This function should be called before the first call to cddb_disc_get_track_next.<p>
<dl compact><dt><b>See also:</b></dt><dd><a class="el" href="cddb__disc_8h.html#64792c14e85b0d5419c1d2ed5596843f">cddb_disc_get_track_next</a></dd></dl>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>disc</em> </td><td>The CDDB disc structure. </td></tr>
</table>
</dl>
</td>
</tr>
</table>
<a class="anchor" name="64792c14e85b0d5419c1d2ed5596843f"></a><!-- doxytag: member="cddb_disc.h::cddb_disc_get_track_next" ref="64792c14e85b0d5419c1d2ed5596843f" args="(cddb_disc_t *disc)" --><p>
<table class="mdTable" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"><a class="el" href="cddb__track_8h.html#1f656d30547194e5a6d9b75406f6b515">cddb_track_t</a>* cddb_disc_get_track_next </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="cddb__disc_8h.html#42efa38614123ddc2bcc8a889443ceda">cddb_disc_t</a> * </td>
<td class="mdname1" valign="top" nowrap> <em>disc</em> </td>
<td class="md" valign="top"> ) </td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
</td>
<td>
<p>
Returns the next track on the disc and advances the internal track iterator.
<p>
If there is no such track then NULL will be returned. This function should be called after calling cddb_disc_get_track_first.<p>
<dl compact><dt><b>See also:</b></dt><dd><a class="el" href="cddb__disc_8h.html#d77ce7b226c41f297af9270a97a0c5e1">cddb_disc_get_track_first</a></dd></dl>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>disc</em> </td><td>The CDDB disc structure. </td></tr>
</table>
</dl>
</td>
</tr>
</table>
<a class="anchor" name="93babf05aaf15b2d933163d8b737586f"></a><!-- doxytag: member="cddb_disc.h::cddb_disc_get_year" ref="93babf05aaf15b2d933163d8b737586f" args="(const cddb_disc_t *disc)" --><p>
<table class="mdTable" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top">unsigned int cddb_disc_get_year </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top">const <a class="el" href="cddb__disc_8h.html#42efa38614123ddc2bcc8a889443ceda">cddb_disc_t</a> * </td>
<td class="mdname1" valign="top" nowrap> <em>disc</em> </td>
<td class="md" valign="top"> ) </td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
</td>
<td>
<p>
Get the year of publication for this disc.
<p>
If no year is defined 0 is returned.<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>disc</em> </td><td>The CDDB disc structure. </td></tr>
</table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>The disc year. </dd></dl>
</td>
</tr>
</table>
<a class="anchor" name="d3f011e11da576beb06fc0873aa769bc"></a><!-- doxytag: member="cddb_disc.h::cddb_disc_new" ref="d3f011e11da576beb06fc0873aa769bc" args="(void)" --><p>
<table class="mdTable" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"><a class="el" href="cddb__disc_8h.html#42efa38614123ddc2bcc8a889443ceda">cddb_disc_t</a>* cddb_disc_new </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top">void </td>
<td class="mdname1" valign="top" nowrap> </td>
<td class="md" valign="top"> ) </td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
</td>
<td>
<p>
Creates a new CDDB disc structure.
<p>
<dl compact><dt><b>Returns:</b></dt><dd>The CDDB disc structure or NULL if memory allocation failed. </dd></dl>
</td>
</tr>
</table>
<a class="anchor" name="243a14dfefa00e988d8bded925cc376e"></a><!-- doxytag: member="cddb_disc.h::cddb_disc_print" ref="243a14dfefa00e988d8bded925cc376e" args="(cddb_disc_t *disc)" --><p>
<table class="mdTable" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top">void cddb_disc_print </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="cddb__disc_8h.html#42efa38614123ddc2bcc8a889443ceda">cddb_disc_t</a> * </td>
<td class="mdname1" valign="top" nowrap> <em>disc</em> </td>
<td class="md" valign="top"> ) </td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
</td>
<td>
<p>
Prints information about the disc on stdout.
<p>
This is just a debugging routine to display the structure's content.<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>disc</em> </td><td>The CDDB disc structure. </td></tr>
</table>
</dl>
</td>
</tr>
</table>
<a class="anchor" name="f565e51732e48511ce5eb50d4849f09e"></a><!-- doxytag: member="cddb_disc.h::cddb_disc_set_artist" ref="f565e51732e48511ce5eb50d4849f09e" args="(cddb_disc_t *disc, const char *artist)" --><p>
<table class="mdTable" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top">void cddb_disc_set_artist </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="cddb__disc_8h.html#42efa38614123ddc2bcc8a889443ceda">cddb_disc_t</a> * </td>
<td class="mdname" nowrap> <em>disc</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td class="md"></td>
<td class="md" nowrap>const char * </td>
<td class="mdname" nowrap> <em>artist</em></td>
</tr>
<tr>
<td class="md"></td>
<td class="md">) </td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
</td>
<td>
<p>
Set the disc artist name.
<p>
If the disc already had an artist name, then the memory for that string will be freed. The new artist name will be copied into a new chunk of memory. If the given artist name is NULL, then the artist name of the disc will be deleted.<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>disc</em> </td><td>The CDDB disc structure. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>artist</em> </td><td>The new disc artist name. </td></tr>
</table>
</dl>
</td>
</tr>
</table>
<a class="anchor" name="fb23b487f2168c0fa75ebf8b7d641b38"></a><!-- doxytag: member="cddb_disc.h::cddb_disc_set_category" ref="fb23b487f2168c0fa75ebf8b7d641b38" args="(cddb_disc_t *disc, cddb_cat_t cat)" --><p>
<table class="mdTable" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top">void cddb_disc_set_category </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="cddb__disc_8h.html#42efa38614123ddc2bcc8a889443ceda">cddb_disc_t</a> * </td>
<td class="mdname" nowrap> <em>disc</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td class="md"></td>
<td class="md" nowrap><a class="el" href="cddb__disc_8h.html#ea1998e6495d2f0dfa3b6e45b4fcd50d">cddb_cat_t</a> </td>
<td class="mdname" nowrap> <em>cat</em></td>
</tr>
<tr>
<td class="md"></td>
<td class="md">) </td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
</td>
<td>
<p>
Set the disc CDDB category ID.
<p>
<dl compact><dt><b>See also:</b></dt><dd><a class="el" href="cddb__disc_8h.html#6456f3f885f08a54efd1382ccd0408f4">cddb_disc_get_category</a> <p>
<a class="el" href="cddb__disc_8h.html#b7aa4e8f6be9849f434db3d62bceb5cb">cddb_disc_get_category_str</a> <p>
<a class="el" href="cddb__disc_8h.html#a2af35dfbffa7c8a91c9a5fc36671264">cddb_disc_set_category_str</a> <p>
<a class="el" href="cddb__disc_8h.html#ea1998e6495d2f0dfa3b6e45b4fcd50d">cddb_cat_t</a> <p>
<a class="el" href="cddb__disc_8h.html#7daed1a7b8097e953f1666ba44833452">CDDB_CATEGORY</a></dd></dl>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>disc</em> </td><td>The CDDB disc structure. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>cat</em> </td><td>The CDDB category ID. </td></tr>
</table>
</dl>
</td>
</tr>
</table>
<a class="anchor" name="a2af35dfbffa7c8a91c9a5fc36671264"></a><!-- doxytag: member="cddb_disc.h::cddb_disc_set_category_str" ref="a2af35dfbffa7c8a91c9a5fc36671264" args="(cddb_disc_t *disc, const char *cat)" --><p>
<table class="mdTable" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top">void cddb_disc_set_category_str </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="cddb__disc_8h.html#42efa38614123ddc2bcc8a889443ceda">cddb_disc_t</a> * </td>
<td class="mdname" nowrap> <em>disc</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td class="md"></td>
<td class="md" nowrap>const char * </td>
<td class="mdname" nowrap> <em>cat</em></td>
</tr>
<tr>
<td class="md"></td>
<td class="md">) </td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
</td>
<td>
<p>
Sets the category of the disc.
<p>
If the specified category is an invalid CDDB category, then CDDB_CAT_MISC will be used.<p>
<dl compact><dt><b>See also:</b></dt><dd><a class="el" href="cddb__disc_8h.html#6456f3f885f08a54efd1382ccd0408f4">cddb_disc_get_category</a> <p>
<a class="el" href="cddb__disc_8h.html#fb23b487f2168c0fa75ebf8b7d641b38">cddb_disc_set_category</a> <p>
<a class="el" href="cddb__disc_8h.html#b7aa4e8f6be9849f434db3d62bceb5cb">cddb_disc_get_category_str</a> <p>
<a class="el" href="cddb__disc_8h.html#7daed1a7b8097e953f1666ba44833452">CDDB_CATEGORY</a></dd></dl>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>disc</em> </td><td>The CDDB disc structure. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>cat</em> </td><td>The category string. </td></tr>
</table>
</dl>
</td>
</tr>
</table>
<a class="anchor" name="5c30ddb662dbfc62cc0992aa6898b794"></a><!-- doxytag: member="cddb_disc.h::cddb_disc_set_discid" ref="5c30ddb662dbfc62cc0992aa6898b794" args="(cddb_disc_t *disc, unsigned int id)" --><p>
<table class="mdTable" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top">void cddb_disc_set_discid </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="cddb__disc_8h.html#42efa38614123ddc2bcc8a889443ceda">cddb_disc_t</a> * </td>
<td class="mdname" nowrap> <em>disc</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td class="md"></td>
<td class="md" nowrap>unsigned int </td>
<td class="mdname" nowrap> <em>id</em></td>
</tr>
<tr>
<td class="md"></td>
<td class="md">) </td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
</td>
<td>
<p>
Set the ID of the disc.
<p>
When the disc ID is not known yet, then it can be calculated with the cddb_disc_calc_discid function (which will automatically initialize the correct field in the disc structure).<p>
<dl compact><dt><b>See also:</b></dt><dd><a class="el" href="cddb__disc_8h.html#b2fa8d342aceba66a116c24dda7a7d61">cddb_disc_calc_discid</a></dd></dl>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>disc</em> </td><td>The CDDB disc structure. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>id</em> </td><td>The disc ID. </td></tr>
</table>
</dl>
</td>
</tr>
</table>
<a class="anchor" name="ad940b347f5ef58cec2da0fd105ab0b6"></a><!-- doxytag: member="cddb_disc.h::cddb_disc_set_ext_data" ref="ad940b347f5ef58cec2da0fd105ab0b6" args="(cddb_disc_t *disc, const char *ext_data)" --><p>
<table class="mdTable" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top">void cddb_disc_set_ext_data </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="cddb__disc_8h.html#42efa38614123ddc2bcc8a889443ceda">cddb_disc_t</a> * </td>
<td class="mdname" nowrap> <em>disc</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td class="md"></td>
<td class="md" nowrap>const char * </td>
<td class="mdname" nowrap> <em>ext_data</em></td>
</tr>
<tr>
<td class="md"></td>
<td class="md">) </td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
</td>
<td>
<p>
Set the extended data for the disc.
<p>
If the disc already had extended data, then the memory for that string will be freed. The new extended data will be copied into a new chunk of memory. If the given extended data is NULL, then the existing data will be deleted.<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>disc</em> </td><td>The CDDB disc structure. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>ext_data</em> </td><td>The new extended data. </td></tr>
</table>
</dl>
</td>
</tr>
</table>
<a class="anchor" name="35e3e624c4d55d16faf0f7563d965f1f"></a><!-- doxytag: member="cddb_disc.h::cddb_disc_set_genre" ref="35e3e624c4d55d16faf0f7563d965f1f" args="(cddb_disc_t *disc, const char *genre)" --><p>
<table class="mdTable" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top">void cddb_disc_set_genre </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="cddb__disc_8h.html#42efa38614123ddc2bcc8a889443ceda">cddb_disc_t</a> * </td>
<td class="mdname" nowrap> <em>disc</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td class="md"></td>
<td class="md" nowrap>const char * </td>
<td class="mdname" nowrap> <em>genre</em></td>
</tr>
<tr>
<td class="md"></td>
<td class="md">) </td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
</td>
<td>
<p>
Set the disc genre.
<p>
As opposed to the disc category, this field is not limited to a predefined set. If the disc already had a genre, then the memory for that string will be freed. The new genre will be copied into a new chunk of memory.<p>
<dl compact><dt><b>See also:</b></dt><dd><a class="el" href="cddb__disc_8h.html#b7aa4e8f6be9849f434db3d62bceb5cb">cddb_disc_get_category_str</a></dd></dl>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>disc</em> </td><td>The CDDB disc structure. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>genre</em> </td><td>The disc genre. </td></tr>
</table>
</dl>
</td>
</tr>
</table>
<a class="anchor" name="403ea0c84c8075fefa6adfaad8184c8c"></a><!-- doxytag: member="cddb_disc.h::cddb_disc_set_length" ref="403ea0c84c8075fefa6adfaad8184c8c" args="(cddb_disc_t *disc, unsigned int l)" --><p>
<table class="mdTable" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top">void cddb_disc_set_length </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="cddb__disc_8h.html#42efa38614123ddc2bcc8a889443ceda">cddb_disc_t</a> * </td>
<td class="mdname" nowrap> <em>disc</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td class="md"></td>
<td class="md" nowrap>unsigned int </td>
<td class="mdname" nowrap> <em>l</em></td>
</tr>
<tr>
<td class="md"></td>
<td class="md">) </td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
</td>
<td>
<p>
Set the disc length.
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>disc</em> </td><td>The CDDB disc structure. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>l</em> </td><td>The disc length in seconds. </td></tr>
</table>
</dl>
</td>
</tr>
</table>
<a class="anchor" name="b0c2032a4f21ad0e61c30583cc1bb941"></a><!-- doxytag: member="cddb_disc.h::cddb_disc_set_title" ref="b0c2032a4f21ad0e61c30583cc1bb941" args="(cddb_disc_t *disc, const char *title)" --><p>
<table class="mdTable" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top">void cddb_disc_set_title </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="cddb__disc_8h.html#42efa38614123ddc2bcc8a889443ceda">cddb_disc_t</a> * </td>
<td class="mdname" nowrap> <em>disc</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td class="md"></td>
<td class="md" nowrap>const char * </td>
<td class="mdname" nowrap> <em>title</em></td>
</tr>
<tr>
<td class="md"></td>
<td class="md">) </td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
</td>
<td>
<p>
Set the disc title.
<p>
If the disc already had a title, then the memory for that string will be freed. The new title will be copied into a new chunk of memory. If the given title is NULL, then the title of the disc will be deleted.<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>disc</em> </td><td>The CDDB disc structure. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>title</em> </td><td>The new disc title. </td></tr>
</table>
</dl>
</td>
</tr>
</table>
<a class="anchor" name="160b7bade529a2c286f51e57e37e9aae"></a><!-- doxytag: member="cddb_disc.h::cddb_disc_set_year" ref="160b7bade529a2c286f51e57e37e9aae" args="(cddb_disc_t *disc, unsigned int y)" --><p>
<table class="mdTable" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top">void cddb_disc_set_year </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="cddb__disc_8h.html#42efa38614123ddc2bcc8a889443ceda">cddb_disc_t</a> * </td>
<td class="mdname" nowrap> <em>disc</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td class="md"></td>
<td class="md" nowrap>unsigned int </td>
<td class="mdname" nowrap> <em>y</em></td>
</tr>
<tr>
<td class="md"></td>
<td class="md">) </td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
</td>
<td>
<p>
Set the year of publication for this disc.
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>disc</em> </td><td>The CDDB disc structure. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>y</em> </td><td>The disc year. </td></tr>
</table>
</dl>
</td>
</tr>
</table>
<hr><h2>Variable Documentation</h2>
<a class="anchor" name="7daed1a7b8097e953f1666ba44833452"></a><!-- doxytag: member="cddb_disc.h::CDDB_CATEGORY" ref="7daed1a7b8097e953f1666ba44833452" args="[CDDB_CAT_LAST]" --><p>
<table class="mdTable" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top">const char* <a class="el" href="cddb__disc_8h.html#7daed1a7b8097e953f1666ba44833452">CDDB_CATEGORY</a>[CDDB_CAT_LAST] </td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
</td>
<td>
<p>
String values for the CDDB categories.
<p>
</td>
</tr>
</table>
<hr size="1"><address style="align: right;"><small>Generated on Sun Oct 15 14:49:15 2006 for libcddb by
<a href="http://www.doxygen.org/index.html">
<img src="doxygen.png" alt="doxygen" align="middle" border="0"></a> 1.4.6 </small></address>
</body>
</html>
