<!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_track.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_track.h File Reference</h1>
<p>
<a href="cddb__track_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__track_8h.html#0dbaef7beec374c2d28eec2db84da5b3">CDDB_TRACK_H</a> 1</td></tr>
<tr><td colspan="2"><br><h2>Typedefs</h2></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">typedef cddb_track_s </td><td class="memItemRight" valign="bottom"><a class="el" href="cddb__track_8h.html#1f656d30547194e5a6d9b75406f6b515">cddb_track_t</a></td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">The CDDB track structure. <a href="#1f656d30547194e5a6d9b75406f6b515"></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__track_8h.html#1f656d30547194e5a6d9b75406f6b515">cddb_track_t</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="cddb__track_8h.html#1ff23780b5f261609d253d5f382a9dbe">cddb_track_new</a> (void)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Creates a new CDDB track structure. <a href="#1ff23780b5f261609d253d5f382a9dbe"></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__track_8h.html#2e2a6b9d7dede4137355181716e372d5">cddb_track_destroy</a> (<a class="el" href="cddb__track_8h.html#1f656d30547194e5a6d9b75406f6b515">cddb_track_t</a> *track)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Free all resources associated with the given CDDB track structure. <a href="#2e2a6b9d7dede4137355181716e372d5"></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__track_8h.html#4f5e232db8905a37e8e21e86d07a3a8b">cddb_track_clone</a> (const <a class="el" href="cddb__track_8h.html#1f656d30547194e5a6d9b75406f6b515">cddb_track_t</a> *track)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Creates a clone of the given track. <a href="#4f5e232db8905a37e8e21e86d07a3a8b"></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__track_8h.html#c56671ac6022cccbb71724cb5116f169">cddb_track_get_number</a> (const <a class="el" href="cddb__track_8h.html#1f656d30547194e5a6d9b75406f6b515">cddb_track_t</a> *track)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Get the number of this track. <a href="#c56671ac6022cccbb71724cb5116f169"></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__track_8h.html#ca213caee5c7075ee077c89bea7cbdd2">cddb_track_get_frame_offset</a> (const <a class="el" href="cddb__track_8h.html#1f656d30547194e5a6d9b75406f6b515">cddb_track_t</a> *track)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Get the frame offset of this track on the disc. <a href="#ca213caee5c7075ee077c89bea7cbdd2"></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__track_8h.html#1db69a3085ebf75430ccc3f4cca7025c">cddb_track_set_frame_offset</a> (<a class="el" href="cddb__track_8h.html#1f656d30547194e5a6d9b75406f6b515">cddb_track_t</a> *track, int offset)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Set the frame offset of this track on the disc. <a href="#1db69a3085ebf75430ccc3f4cca7025c"></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__track_8h.html#ec922bbc2dc375c2c272db133f13e16e">cddb_track_get_length</a> (<a class="el" href="cddb__track_8h.html#1f656d30547194e5a6d9b75406f6b515">cddb_track_t</a> *track)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Get the length of the track in seconds. <a href="#ec922bbc2dc375c2c272db133f13e16e"></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__track_8h.html#f3d9820f75e10322bf1847316fcb3e98">cddb_track_set_length</a> (<a class="el" href="cddb__track_8h.html#1f656d30547194e5a6d9b75406f6b515">cddb_track_t</a> *track, int length)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Set the length of the track. <a href="#f3d9820f75e10322bf1847316fcb3e98"></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__track_8h.html#c0fd2e634bd2594e1dbed53d44b01355">cddb_track_get_title</a> (const <a class="el" href="cddb__track_8h.html#1f656d30547194e5a6d9b75406f6b515">cddb_track_t</a> *track)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Get the track title. <a href="#c0fd2e634bd2594e1dbed53d44b01355"></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__track_8h.html#105143caf0f925d39a8672279270fdcf">cddb_track_set_title</a> (<a class="el" href="cddb__track_8h.html#1f656d30547194e5a6d9b75406f6b515">cddb_track_t</a> *track, const char *title)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Set the track title. <a href="#105143caf0f925d39a8672279270fdcf"></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__track_8h.html#7c12cbe3ba0c2cba52b503d85bedec98">cddb_track_append_title</a> (<a class="el" href="cddb__track_8h.html#1f656d30547194e5a6d9b75406f6b515">cddb_track_t</a> *track, const char *title)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Append to the track title. <a href="#7c12cbe3ba0c2cba52b503d85bedec98"></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__track_8h.html#06ef335da307c849d57eead1bb059391">cddb_track_get_artist</a> (<a class="el" href="cddb__track_8h.html#1f656d30547194e5a6d9b75406f6b515">cddb_track_t</a> *track)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Get the track artist name. <a href="#06ef335da307c849d57eead1bb059391"></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__track_8h.html#78764d0cf156ecaa5e907067e424494e">cddb_track_set_artist</a> (<a class="el" href="cddb__track_8h.html#1f656d30547194e5a6d9b75406f6b515">cddb_track_t</a> *track, const char *artist)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Set the track artist name. <a href="#78764d0cf156ecaa5e907067e424494e"></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__track_8h.html#a8df7b050e2d76dfc7185430de5dee51">cddb_track_append_artist</a> (<a class="el" href="cddb__track_8h.html#1f656d30547194e5a6d9b75406f6b515">cddb_track_t</a> *track, const char *artist)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Append to the track artist. <a href="#a8df7b050e2d76dfc7185430de5dee51"></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__track_8h.html#a09b734d43c50759a707e0d563f88c3d">cddb_track_get_ext_data</a> (<a class="el" href="cddb__track_8h.html#1f656d30547194e5a6d9b75406f6b515">cddb_track_t</a> *track)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Get the extended track data. <a href="#a09b734d43c50759a707e0d563f88c3d"></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__track_8h.html#9dfe7e399216d6cbdc8ef44336878ce4">cddb_track_set_ext_data</a> (<a class="el" href="cddb__track_8h.html#1f656d30547194e5a6d9b75406f6b515">cddb_track_t</a> *track, const char *ext_data)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Set the extended data for the track. <a href="#9dfe7e399216d6cbdc8ef44336878ce4"></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__track_8h.html#3e6ff99c770637568911b4a1050f19c5">cddb_track_append_ext_data</a> (<a class="el" href="cddb__track_8h.html#1f656d30547194e5a6d9b75406f6b515">cddb_track_t</a> *track, const char *ext_data)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Append to the extended track data. <a href="#3e6ff99c770637568911b4a1050f19c5"></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__track_8h.html#1918ba8826aed51573b9187821c668a1">cddb_track_copy</a> (<a class="el" href="cddb__track_8h.html#1f656d30547194e5a6d9b75406f6b515">cddb_track_t</a> *dst, <a class="el" href="cddb__track_8h.html#1f656d30547194e5a6d9b75406f6b515">cddb_track_t</a> *src)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Copy all data from one track to another. <a href="#1918ba8826aed51573b9187821c668a1"></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__track_8h.html#6505f260c2a5e99d4afe7f136554da22">cddb_track_print</a> (<a class="el" href="cddb__track_8h.html#1f656d30547194e5a6d9b75406f6b515">cddb_track_t</a> *track)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Prints information about the track on stdout. <a href="#6505f260c2a5e99d4afe7f136554da22"></a><br></td></tr>
</table>
<hr><h2>Define Documentation</h2>
<a class="anchor" name="0dbaef7beec374c2d28eec2db84da5b3"></a><!-- doxytag: member="cddb_track.h::CDDB_TRACK_H" ref="0dbaef7beec374c2d28eec2db84da5b3" 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_TRACK_H 1 </td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
</td>
<td>
<p>
</td>
</tr>
</table>
<hr><h2>Typedef Documentation</h2>
<a class="anchor" name="1f656d30547194e5a6d9b75406f6b515"></a><!-- doxytag: member="cddb_track.h::cddb_track_t" ref="1f656d30547194e5a6d9b75406f6b515" 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_track_s <a class="el" href="cddb__track_8h.html#1f656d30547194e5a6d9b75406f6b515">cddb_track_t</a> </td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
</td>
<td>
<p>
The CDDB track structure.
<p>
Contains all information associated with a single CD track. This structure will be used to populate the tracks linked list of the cddb_disc_s structure. </td>
</tr>
</table>
<hr><h2>Function Documentation</h2>
<a class="anchor" name="a8df7b050e2d76dfc7185430de5dee51"></a><!-- doxytag: member="cddb_track.h::cddb_track_append_artist" ref="a8df7b050e2d76dfc7185430de5dee51" args="(cddb_track_t *track, 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_track_append_artist </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><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" 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 track artist.
<p>
If the track 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>track</em> </td><td>The CDDB track 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="3e6ff99c770637568911b4a1050f19c5"></a><!-- doxytag: member="cddb_track.h::cddb_track_append_ext_data" ref="3e6ff99c770637568911b4a1050f19c5" args="(cddb_track_t *track, 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_track_append_ext_data </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><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" 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 track data.
<p>
If the track 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>track</em> </td><td>The CDDB track structure. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>ext_data</em> </td><td>Part of the extended track data. </td></tr>
</table>
</dl>
</td>
</tr>
</table>
<a class="anchor" name="7c12cbe3ba0c2cba52b503d85bedec98"></a><!-- doxytag: member="cddb_track.h::cddb_track_append_title" ref="7c12cbe3ba0c2cba52b503d85bedec98" args="(cddb_track_t *track, 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_track_append_title </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><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" 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 track title.
<p>
If the track 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>track</em> </td><td>The CDDB track structure. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>title</em> </td><td>Part of the track title. </td></tr>
</table>
</dl>
</td>
</tr>
</table>
<a class="anchor" name="4f5e232db8905a37e8e21e86d07a3a8b"></a><!-- doxytag: member="cddb_track.h::cddb_track_clone" ref="4f5e232db8905a37e8e21e86d07a3a8b" args="(const 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"><a class="el" href="cddb__track_8h.html#1f656d30547194e5a6d9b75406f6b515">cddb_track_t</a>* cddb_track_clone </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top">const <a class="el" href="cddb__track_8h.html#1f656d30547194e5a6d9b75406f6b515">cddb_track_t</a> * </td>
<td class="mdname1" valign="top" nowrap> <em>track</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 track.
<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>track</em> </td><td>The CDDB track structure. </td></tr>
</table>
</dl>
</td>
</tr>
</table>
<a class="anchor" name="1918ba8826aed51573b9187821c668a1"></a><!-- doxytag: member="cddb_track.h::cddb_track_copy" ref="1918ba8826aed51573b9187821c668a1" args="(cddb_track_t *dst, cddb_track_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_track_copy </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="cddb__track_8h.html#1f656d30547194e5a6d9b75406f6b515">cddb_track_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__track_8h.html#1f656d30547194e5a6d9b75406f6b515">cddb_track_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 track to another.
<p>
Any fields that are unavailable in the source track structure will not result in a reset of the same field in the destination track structure; e.g. if there is no title in the source track, but there is one in the destination track, 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 track structure. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>src</em> </td><td>The source CDDB track structure. </td></tr>
</table>
</dl>
</td>
</tr>
</table>
<a class="anchor" name="2e2a6b9d7dede4137355181716e372d5"></a><!-- doxytag: member="cddb_track.h::cddb_track_destroy" ref="2e2a6b9d7dede4137355181716e372d5" args="(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_track_destroy </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="cddb__track_8h.html#1f656d30547194e5a6d9b75406f6b515">cddb_track_t</a> * </td>
<td class="mdname1" valign="top" nowrap> <em>track</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 track structure.
<p>
The linked list pointer (next) will not be touched. So you have to make sure that no other tracks are attached to this one before calling this function.<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>track</em> </td><td>The CDDB track structure. </td></tr>
</table>
</dl>
</td>
</tr>
</table>
<a class="anchor" name="06ef335da307c849d57eead1bb059391"></a><!-- doxytag: member="cddb_track.h::cddb_track_get_artist" ref="06ef335da307c849d57eead1bb059391" args="(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">const char* cddb_track_get_artist </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="cddb__track_8h.html#1f656d30547194e5a6d9b75406f6b515">cddb_track_t</a> * </td>
<td class="mdname1" valign="top" nowrap> <em>track</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 track artist name.
<p>
If there is no track artist defined, the disc artist will be returned. NULL will be returned if neither is defined.<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>track</em> </td><td>The CDDB track structure. </td></tr>
</table>
</dl>
</td>
</tr>
</table>
<a class="anchor" name="a09b734d43c50759a707e0d563f88c3d"></a><!-- doxytag: member="cddb_track.h::cddb_track_get_ext_data" ref="a09b734d43c50759a707e0d563f88c3d" args="(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">const char* cddb_track_get_ext_data </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="cddb__track_8h.html#1f656d30547194e5a6d9b75406f6b515">cddb_track_t</a> * </td>
<td class="mdname1" valign="top" nowrap> <em>track</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 track data.
<p>
If no extended data is set for this track 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>track</em> </td><td>The CDDB track 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="ca213caee5c7075ee077c89bea7cbdd2"></a><!-- doxytag: member="cddb_track.h::cddb_track_get_frame_offset" ref="ca213caee5c7075ee077c89bea7cbdd2" args="(const 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">int cddb_track_get_frame_offset </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top">const <a class="el" href="cddb__track_8h.html#1f656d30547194e5a6d9b75406f6b515">cddb_track_t</a> * </td>
<td class="mdname1" valign="top" nowrap> <em>track</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 frame offset of this track on the disc.
<p>
If the track is invalid -1 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>track</em> </td><td>The CDDB track structure. </td></tr>
</table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>The frame offset. </dd></dl>
</td>
</tr>
</table>
<a class="anchor" name="ec922bbc2dc375c2c272db133f13e16e"></a><!-- doxytag: member="cddb_track.h::cddb_track_get_length" ref="ec922bbc2dc375c2c272db133f13e16e" args="(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">int cddb_track_get_length </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="cddb__track_8h.html#1f656d30547194e5a6d9b75406f6b515">cddb_track_t</a> * </td>
<td class="mdname1" valign="top" nowrap> <em>track</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 length of the track in seconds.
<p>
If the track length is not defined this routine will try to calculate it using the frame offsets of the tracks and the total disc length. These calculations will do no rounding to the nearest second. So it is possible that the sum off all track lengths does not add up to the actual disc length. If the length can not be calculated -1 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>track</em> </td><td>The CDDB track structure. </td></tr>
</table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>The track length. </dd></dl>
</td>
</tr>
</table>
<a class="anchor" name="c56671ac6022cccbb71724cb5116f169"></a><!-- doxytag: member="cddb_track.h::cddb_track_get_number" ref="c56671ac6022cccbb71724cb5116f169" args="(const 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">int cddb_track_get_number </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top">const <a class="el" href="cddb__track_8h.html#1f656d30547194e5a6d9b75406f6b515">cddb_track_t</a> * </td>
<td class="mdname1" valign="top" nowrap> <em>track</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 this track.
<p>
This track number starts counting at 1. If the track is invalid or the track number is not defined -1 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>track</em> </td><td>The CDDB track structure. </td></tr>
</table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>The track number. </dd></dl>
</td>
</tr>
</table>
<a class="anchor" name="c0fd2e634bd2594e1dbed53d44b01355"></a><!-- doxytag: member="cddb_track.h::cddb_track_get_title" ref="c0fd2e634bd2594e1dbed53d44b01355" args="(const 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">const char* cddb_track_get_title </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top">const <a class="el" href="cddb__track_8h.html#1f656d30547194e5a6d9b75406f6b515">cddb_track_t</a> * </td>
<td class="mdname1" valign="top" nowrap> <em>track</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 track title.
<p>
If the track is invalid or no title is set for this track 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>track</em> </td><td>The CDDB track structure. </td></tr>
</table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>The track title. </dd></dl>
</td>
</tr>
</table>
<a class="anchor" name="1ff23780b5f261609d253d5f382a9dbe"></a><!-- doxytag: member="cddb_track.h::cddb_track_new" ref="1ff23780b5f261609d253d5f382a9dbe" 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__track_8h.html#1f656d30547194e5a6d9b75406f6b515">cddb_track_t</a>* cddb_track_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 track structure.
<p>
<dl compact><dt><b>Returns:</b></dt><dd>The CDDB track structure or NULL if memory allocation failed. </dd></dl>
</td>
</tr>
</table>
<a class="anchor" name="6505f260c2a5e99d4afe7f136554da22"></a><!-- doxytag: member="cddb_track.h::cddb_track_print" ref="6505f260c2a5e99d4afe7f136554da22" args="(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_track_print </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="cddb__track_8h.html#1f656d30547194e5a6d9b75406f6b515">cddb_track_t</a> * </td>
<td class="mdname1" valign="top" nowrap> <em>track</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 track on stdout.
<p>
This is just a debugging routine to display the structure's content. It is used by cddb_disc_print to print the contents of a complete 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>track</em> </td><td>The CDDB track structure. </td></tr>
</table>
</dl>
</td>
</tr>
</table>
<a class="anchor" name="78764d0cf156ecaa5e907067e424494e"></a><!-- doxytag: member="cddb_track.h::cddb_track_set_artist" ref="78764d0cf156ecaa5e907067e424494e" args="(cddb_track_t *track, 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_track_set_artist </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><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" 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 track artist name.
<p>
If the track 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 track 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>track</em> </td><td>The CDDB track structure. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>artist</em> </td><td>The new track artist name. </td></tr>
</table>
</dl>
</td>
</tr>
</table>
<a class="anchor" name="9dfe7e399216d6cbdc8ef44336878ce4"></a><!-- doxytag: member="cddb_track.h::cddb_track_set_ext_data" ref="9dfe7e399216d6cbdc8ef44336878ce4" args="(cddb_track_t *track, 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_track_set_ext_data </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><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" 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 track.
<p>
If the track 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>track</em> </td><td>The CDDB track 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="1db69a3085ebf75430ccc3f4cca7025c"></a><!-- doxytag: member="cddb_track.h::cddb_track_set_frame_offset" ref="1db69a3085ebf75430ccc3f4cca7025c" args="(cddb_track_t *track, int offset)" --><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_track_set_frame_offset </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><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" nowrap align="right"></td>
<td class="md"></td>
<td class="md" nowrap>int </td>
<td class="mdname" nowrap> <em>offset</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 frame offset of this track on the 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>track</em> </td><td>The CDDB track structure. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>offset</em> </td><td>The frame offset. </td></tr>
</table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>The frame offset. </dd></dl>
</td>
</tr>
</table>
<a class="anchor" name="f3d9820f75e10322bf1847316fcb3e98"></a><!-- doxytag: member="cddb_track.h::cddb_track_set_length" ref="f3d9820f75e10322bf1847316fcb3e98" args="(cddb_track_t *track, int length)" --><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_track_set_length </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><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" nowrap align="right"></td>
<td class="md"></td>
<td class="md" nowrap>int </td>
<td class="mdname" nowrap> <em>length</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 length of the track.
<p>
If no frame offset is yet known for this track, and it is part of a disc, then the frame offset will be calculated.<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>track</em> </td><td>The CDDB track structure. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>length</em> </td><td>The track length in seconds. </td></tr>
</table>
</dl>
</td>
</tr>
</table>
<a class="anchor" name="105143caf0f925d39a8672279270fdcf"></a><!-- doxytag: member="cddb_track.h::cddb_track_set_title" ref="105143caf0f925d39a8672279270fdcf" args="(cddb_track_t *track, 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_track_set_title </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><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" 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 track title.
<p>
If the track 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 track 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>track</em> </td><td>The CDDB track structure. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>title</em> </td><td>The new track title. </td></tr>
</table>
</dl>
</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>
