~ubuntu-branches/ubuntu/karmic/flac/karmic

</h1>The level 0 interface consists of individual routines to read the STREAMINFO and VORBIS_COMMENT blocks, requiring only a filename. 

<tr><td nowrap align=right valign=top>FLAC__bool&nbsp;</td><td valign=bottom><a class="el" href="group__flac__metadata__level0.html#a1">FLAC__metadata_get_tags</a> (const char *filename, <a class="el" href="structFLAC____StreamMetadata.html">FLAC__StreamMetadata</a> **tags)</td></tr>

The level 0 interface consists of individual routines to read the STREAMINFO and VORBIS_COMMENT blocks, requiring only a filename.

A pointer to space for the STREAMINFO block. Since <a class="el" href="structFLAC____StreamMetadata.html">FLAC__StreamMetadata</a> is a simple structure with no memory allocation involved, you pass the address of an existing structure. It need not be initialized. </td></tr>

</table>

</dl><dl compact><dt><b>

Assertions:</b><dd>

 <div class="fragment"><pre>filename != NULL 

</pre></div> <div class="fragment"><pre>streaminfo != NULL 

</pre></div> </dl><dl compact><dt><b>

Return values: </b><dd>

<table border=0 cellspacing=2 cellpadding=0>

<tr><td valign=top><em>FLAC__bool</em>&nbsp;</td><td>

<code>true</code> if a valid STREAMINFO block was read from <em>filename</em>. Returns <code>false</code> if there was a memory allocation error, a file decoder error, or the file contained no STREAMINFO block. (A memory allocation error is possible because this function must set up a file decoder.) </td></tr>

</table>

</dl>    </td>

  </tr>

</table>

<a name="a1" doxytag="metadata.h::FLAC__metadata_get_tags"></a><p>

<table width="100%" cellpadding="2" cellspacing="0" border="0">

  <tr>

    <td class="md">

      <table cellpadding="0" cellspacing="0" border="0">

        <tr>

          <td class="md" nowrap valign="top"> FLAC__bool FLAC__metadata_get_tags </td>

          <td class="md" valign="top">(&nbsp;</td>

          <td class="md" nowrap valign="top">const char *&nbsp;</td>

          <td class="mdname" nowrap>&nbsp; <em>filename</em>, </td>

        </tr>

        <tr>

          <td></td>

          <td></td>

          <td class="md" nowrap><a class="el" href="structFLAC____StreamMetadata.html">FLAC__StreamMetadata</a> **&nbsp;</td>

          <td class="mdname" nowrap>&nbsp; <em>tags</em></td>

        </tr>

        <tr>

          <td></td>

          <td class="md">)&nbsp;</td>

          <td class="md" colspan="2"></td>

        </tr>

 

      </table>

    </td>

  </tr>

</table>

<table cellspacing=5 cellpadding=0 border=0>

  <tr>

    <td>

      &nbsp;

    </td>

    <td>

 

<p>

Read the VORBIS_COMMENT metadata block of the given FLAC file. This function will skip any ID3v2 tag at the head of the file.<dl compact><dt><b>

Parameters: </b><dd>

<table border=0 cellspacing=2 cellpadding=0>

<tr><td valign=top><em>filename</em>&nbsp;</td><td>

The path to the FLAC file to read. </td></tr>

<tr><td valign=top><em>tags</em>&nbsp;</td><td>

The address where the returned pointer will be stored. The <em>tags</em> object must be deleted by the caller using <a class="el" href="group__flac__metadata__object.html#a2">FLAC__metadata_object_delete</a>(). </td></tr>

</table>

</dl><dl compact><dt><b>

Assertions:</b><dd>

 <div class="fragment"><pre>filename != NULL 

</pre></div> <div class="fragment"><pre>streaminfo != NULL 

</pre></div> </dl><dl compact><dt><b>

Return values: </b><dd>

<table border=0 cellspacing=2 cellpadding=0>

<tr><td valign=top><em>FLAC__bool</em>&nbsp;</td><td>

<code>true</code> if a valid VORBIS_COMMENT block was read from <em>filename</em>, and <em>*tags</em> will be set to the address of the tag structure. Returns <code>false</code> if there was a memory allocation error, a file decoder error, or the file contained no VORBIS_COMMENT block, and <em>*tags</em> will be set to <code>NULL</code>. </td></tr>

</table>

</dl>    </td>

  </tr>

</table>

<hr><address><small>Generated on Tue Sep 28 21:19:43 2004 for FLAC by