1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> 2<html><head><meta http-equiv="Content-Type" content="text/html;charset=iso-8859-1"> 3<title>FLAC: include/FLAC/metadata.h Source File</title> 4<link href="doxygen.css" rel="stylesheet" type="text/css"> 5</head><body> 6<!-- Generated by Doxygen 1.4.2 --> 7<div class="qindex"><a class="qindex" href="index.html">Main Page</a> | <a class="qindex" href="modules.html">Modules</a> | <a class="qindex" href="hierarchy.html">Class Hierarchy</a> | <a class="qindex" href="classes.html">Alphabetical List</a> | <a class="qindex" href="annotated.html">Class List</a> | <a class="qindex" href="dirs.html">Directories</a> | <a class="qindex" href="files.html">File List</a> | <a class="qindex" href="functions.html">Class Members</a> | <a class="qindex" href="globals.html">File Members</a></div> 8<div class="nav"> 9<a class="el" href="dir_000000.html">include</a> / <a class="el" href="dir_000002.html">FLAC</a></div> 10<h1>metadata.h</h1><a href="metadata_8h.html">Go to the documentation of this file.</a><div class="fragment"><pre class="fragment">00001 <span class="comment">/* libFLAC - Free Lossless Audio Codec library</span> 1100002 <span class="comment"> * Copyright (C) 2001,2002,2003,2004,2005,2006,2007 Josh Coalson</span> 1200003 <span class="comment"> *</span> 1300004 <span class="comment"> * Redistribution and use in source and binary forms, with or without</span> 1400005 <span class="comment"> * modification, are permitted provided that the following conditions</span> 1500006 <span class="comment"> * are met:</span> 1600007 <span class="comment"> *</span> 1700008 <span class="comment"> * - Redistributions of source code must retain the above copyright</span> 1800009 <span class="comment"> * notice, this list of conditions and the following disclaimer.</span> 1900010 <span class="comment"> *</span> 2000011 <span class="comment"> * - Redistributions in binary form must reproduce the above copyright</span> 2100012 <span class="comment"> * notice, this list of conditions and the following disclaimer in the</span> 2200013 <span class="comment"> * documentation and/or other materials provided with the distribution.</span> 2300014 <span class="comment"> *</span> 2400015 <span class="comment"> * - Neither the name of the Xiph.org Foundation nor the names of its</span> 2500016 <span class="comment"> * contributors may be used to endorse or promote products derived from</span> 2600017 <span class="comment"> * this software without specific prior written permission.</span> 2700018 <span class="comment"> *</span> 2800019 <span class="comment"> * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS</span> 2900020 <span class="comment"> * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT</span> 3000021 <span class="comment"> * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR</span> 3100022 <span class="comment"> * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR</span> 3200023 <span class="comment"> * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,</span> 3300024 <span class="comment"> * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,</span> 3400025 <span class="comment"> * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR</span> 3500026 <span class="comment"> * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF</span> 3600027 <span class="comment"> * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING</span> 3700028 <span class="comment"> * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS</span> 3800029 <span class="comment"> * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.</span> 3900030 <span class="comment"> */</span> 4000031 4100032 <span class="preprocessor">#ifndef FLAC__METADATA_H</span> 4200033 <span class="preprocessor"></span><span class="preprocessor">#define FLAC__METADATA_H</span> 4300034 <span class="preprocessor"></span> 4400035 <span class="preprocessor">#include <sys/types.h></span> <span class="comment">/* for off_t */</span> 4500036 <span class="preprocessor">#include "<a class="code" href="export_8h.html">export.h</a>"</span> 4600037 <span class="preprocessor">#include "<a class="code" href="callback_8h.html">callback.h</a>"</span> 4700038 <span class="preprocessor">#include "<a class="code" href="format_8h.html">format.h</a>"</span> 4800039 4900040 <span class="comment">/* --------------------------------------------------------------------</span> 5000041 <span class="comment"> (For an example of how all these routines are used, see the source</span> 5100042 <span class="comment"> code for the unit tests in src/test_libFLAC/metadata_*.c, or</span> 5200043 <span class="comment"> metaflac in src/metaflac/)</span> 5300044 <span class="comment"> ------------------------------------------------------------------*/</span> 5400045 5500123 <span class="preprocessor">#ifdef __cplusplus</span> 5600124 <span class="preprocessor"></span><span class="keyword">extern</span> <span class="stringliteral">"C"</span> { 5700125 <span class="preprocessor">#endif</span> 5800126 <span class="preprocessor"></span> 5900127 6000158 FLAC_API FLAC__bool <a class="code" href="group__flac__metadata__level0.html#ga0">FLAC__metadata_get_streaminfo</a>(<span class="keyword">const</span> <span class="keywordtype">char</span> *filename, <a class="code" href="structFLAC____StreamMetadata.html">FLAC__StreamMetadata</a> *streaminfo); 6100159 6200177 FLAC_API FLAC__bool <a class="code" href="group__flac__metadata__level0.html#ga1">FLAC__metadata_get_tags</a>(<span class="keyword">const</span> <span class="keywordtype">char</span> *filename, <a class="code" href="structFLAC____StreamMetadata.html">FLAC__StreamMetadata</a> **tags); 6300178 6400196 FLAC_API FLAC__bool <a class="code" href="group__flac__metadata__level0.html#ga2">FLAC__metadata_get_cuesheet</a>(<span class="keyword">const</span> <span class="keywordtype">char</span> *filename, <a class="code" href="structFLAC____StreamMetadata.html">FLAC__StreamMetadata</a> **cuesheet); 6500197 6600236 FLAC_API FLAC__bool <a class="code" href="group__flac__metadata__level0.html#ga3">FLAC__metadata_get_picture</a>(<span class="keyword">const</span> <span class="keywordtype">char</span> *filename, <a class="code" href="structFLAC____StreamMetadata.html">FLAC__StreamMetadata</a> **picture, <a class="code" href="group__flac__format.html#ga114">FLAC__StreamMetadata_Picture_Type</a> type, <span class="keyword">const</span> <span class="keywordtype">char</span> *mime_type, <span class="keyword">const</span> FLAC__byte *description, <span class="keywordtype">unsigned</span> max_width, <span class="keywordtype">unsigned</span> max_height, <span class="keywordtype">unsigned</span> max_depth, <span class="keywordtype">unsigned</span> max_colors); 6700237 6800238 <span class="comment">/* \} */</span> 6900239 7000240 7100296 <span class="keyword">struct </span><a class="code" href="group__flac__metadata__level1.html#ga0">FLAC__Metadata_SimpleIterator</a>; 72<a name="l00302"></a><a class="code" href="group__flac__metadata__level1.html#ga0">00302</a> <span class="keyword">typedef</span> <span class="keyword">struct </span><a class="code" href="group__flac__metadata__level1.html#ga0">FLAC__Metadata_SimpleIterator</a> FLAC__Metadata_SimpleIterator; 7300303 74<a name="l00308"></a><a class="code" href="group__flac__metadata__level1.html#ga18">00308</a> <span class="keyword">typedef</span> <span class="keyword">enum</span> { 7500309 7600310 <a class="code" href="group__flac__metadata__level1.html#gga18a5">FLAC__METADATA_SIMPLE_ITERATOR_STATUS_OK</a> = 0, 7700313 <a class="code" href="group__flac__metadata__level1.html#gga18a6">FLAC__METADATA_SIMPLE_ITERATOR_STATUS_ILLEGAL_INPUT</a>, 7800316 <a class="code" href="group__flac__metadata__level1.html#gga18a7">FLAC__METADATA_SIMPLE_ITERATOR_STATUS_ERROR_OPENING_FILE</a>, 7900319 <a class="code" href="group__flac__metadata__level1.html#gga18a8">FLAC__METADATA_SIMPLE_ITERATOR_STATUS_NOT_A_FLAC_FILE</a>, 8000322 <a class="code" href="group__flac__metadata__level1.html#gga18a9">FLAC__METADATA_SIMPLE_ITERATOR_STATUS_NOT_WRITABLE</a>, 8100325 <a class="code" href="group__flac__metadata__level1.html#gga18a10">FLAC__METADATA_SIMPLE_ITERATOR_STATUS_BAD_METADATA</a>, 8200328 <a class="code" href="group__flac__metadata__level1.html#gga18a11">FLAC__METADATA_SIMPLE_ITERATOR_STATUS_READ_ERROR</a>, 8300331 <a class="code" href="group__flac__metadata__level1.html#gga18a12">FLAC__METADATA_SIMPLE_ITERATOR_STATUS_SEEK_ERROR</a>, 8400334 <a class="code" href="group__flac__metadata__level1.html#gga18a13">FLAC__METADATA_SIMPLE_ITERATOR_STATUS_WRITE_ERROR</a>, 8500337 <a class="code" href="group__flac__metadata__level1.html#gga18a14">FLAC__METADATA_SIMPLE_ITERATOR_STATUS_RENAME_ERROR</a>, 8600340 <a class="code" href="group__flac__metadata__level1.html#gga18a15">FLAC__METADATA_SIMPLE_ITERATOR_STATUS_UNLINK_ERROR</a>, 8700343 <a class="code" href="group__flac__metadata__level1.html#gga18a16">FLAC__METADATA_SIMPLE_ITERATOR_STATUS_MEMORY_ALLOCATION_ERROR</a>, 8800346 <a class="code" href="group__flac__metadata__level1.html#gga18a17">FLAC__METADATA_SIMPLE_ITERATOR_STATUS_INTERNAL_ERROR</a> 8900349 } <a class="code" href="group__flac__metadata__level1.html#ga18">FLAC__Metadata_SimpleIteratorStatus</a>; 9000350 9100356 <span class="keyword">extern</span> FLAC_API <span class="keyword">const</span> <span class="keywordtype">char</span> * <span class="keyword">const</span> <a class="code" href="group__flac__metadata__level1.html#ga1">FLAC__Metadata_SimpleIteratorStatusString</a>[]; 9200357 9300358 9400364 FLAC_API FLAC__Metadata_SimpleIterator *<a class="code" href="group__flac__metadata__level1.html#ga2">FLAC__metadata_simple_iterator_new</a>(<span class="keywordtype">void</span>); 9500365 9600372 FLAC_API <span class="keywordtype">void</span> <a class="code" href="group__flac__metadata__level1.html#ga3">FLAC__metadata_simple_iterator_delete</a>(FLAC__Metadata_SimpleIterator *iterator); 9700373 9800384 FLAC_API FLAC__Metadata_SimpleIteratorStatus <a class="code" href="group__flac__metadata__level1.html#ga4">FLAC__metadata_simple_iterator_status</a>(FLAC__Metadata_SimpleIterator *iterator); 9900385 10000405 FLAC_API FLAC__bool <a class="code" href="group__flac__metadata__level1.html#ga5">FLAC__metadata_simple_iterator_init</a>(FLAC__Metadata_SimpleIterator *iterator, <span class="keyword">const</span> <span class="keywordtype">char</span> *filename, FLAC__bool read_only, FLAC__bool preserve_file_stats); 10100406 10200417 FLAC_API FLAC__bool <a class="code" href="group__flac__metadata__level1.html#ga6">FLAC__metadata_simple_iterator_is_writable</a>(<span class="keyword">const</span> FLAC__Metadata_SimpleIterator *iterator); 10300418 10400431 FLAC_API FLAC__bool <a class="code" href="group__flac__metadata__level1.html#ga7">FLAC__metadata_simple_iterator_next</a>(FLAC__Metadata_SimpleIterator *iterator); 10500432 10600445 FLAC_API FLAC__bool <a class="code" href="group__flac__metadata__level1.html#ga8">FLAC__metadata_simple_iterator_prev</a>(FLAC__Metadata_SimpleIterator *iterator); 10700446 10800458 FLAC_API FLAC__bool <a class="code" href="group__flac__metadata__level1.html#ga9">FLAC__metadata_simple_iterator_is_last</a>(<span class="keyword">const</span> FLAC__Metadata_SimpleIterator *iterator); 10900459 11000474 FLAC_API off_t <a class="code" href="group__flac__metadata__level1.html#ga10">FLAC__metadata_simple_iterator_get_block_offset</a>(<span class="keyword">const</span> FLAC__Metadata_SimpleIterator *iterator); 11100475 11200488 FLAC_API <a class="code" href="group__flac__format.html#ga113">FLAC__MetadataType</a> <a class="code" href="group__flac__metadata__level1.html#ga11">FLAC__metadata_simple_iterator_get_block_type</a>(<span class="keyword">const</span> FLAC__Metadata_SimpleIterator *iterator); 11300489 11400505 FLAC_API <span class="keywordtype">unsigned</span> <a class="code" href="group__flac__metadata__level1.html#ga12">FLAC__metadata_simple_iterator_get_block_length</a>(<span class="keyword">const</span> FLAC__Metadata_SimpleIterator *iterator); 11500506 11600530 FLAC_API FLAC__bool <a class="code" href="group__flac__metadata__level1.html#ga13">FLAC__metadata_simple_iterator_get_application_id</a>(FLAC__Metadata_SimpleIterator *iterator, FLAC__byte *<span class="keywordtype">id</span>); 11700531 11800548 FLAC_API <a class="code" href="structFLAC____StreamMetadata.html">FLAC__StreamMetadata</a> *<a class="code" href="group__flac__metadata__level1.html#ga14">FLAC__metadata_simple_iterator_get_block</a>(FLAC__Metadata_SimpleIterator *iterator); 11900549 12000604 FLAC_API FLAC__bool <a class="code" href="group__flac__metadata__level1.html#ga15">FLAC__metadata_simple_iterator_set_block</a>(FLAC__Metadata_SimpleIterator *iterator, <a class="code" href="structFLAC____StreamMetadata.html">FLAC__StreamMetadata</a> *block, FLAC__bool use_padding); 12100605 12200629 FLAC_API FLAC__bool <a class="code" href="group__flac__metadata__level1.html#ga16">FLAC__metadata_simple_iterator_insert_block_after</a>(FLAC__Metadata_SimpleIterator *iterator, <a class="code" href="structFLAC____StreamMetadata.html">FLAC__StreamMetadata</a> *block, FLAC__bool use_padding); 12300630 12400648 FLAC_API FLAC__bool <a class="code" href="group__flac__metadata__level1.html#ga17">FLAC__metadata_simple_iterator_delete_block</a>(FLAC__Metadata_SimpleIterator *iterator, FLAC__bool use_padding); 12500649 12600650 <span class="comment">/* \} */</span> 12700651 12800652 12900710 <span class="keyword">struct </span><a class="code" href="group__flac__metadata__level2.html#ga0">FLAC__Metadata_Chain</a>; 130<a name="l00713"></a><a class="code" href="group__flac__metadata__level2.html#ga0">00713</a> <span class="keyword">typedef</span> <span class="keyword">struct </span><a class="code" href="group__flac__metadata__level2.html#ga0">FLAC__Metadata_Chain</a> FLAC__Metadata_Chain; 13100714 13200715 <span class="keyword">struct </span><a class="code" href="group__flac__metadata__level2.html#ga1">FLAC__Metadata_Iterator</a>; 133<a name="l00718"></a><a class="code" href="group__flac__metadata__level2.html#ga1">00718</a> <span class="keyword">typedef</span> <span class="keyword">struct </span><a class="code" href="group__flac__metadata__level2.html#ga1">FLAC__Metadata_Iterator</a> FLAC__Metadata_Iterator; 13400719 135<a name="l00720"></a><a class="code" href="group__flac__metadata__level2.html#ga27">00720</a> <span class="keyword">typedef</span> <span class="keyword">enum</span> { 13600721 <a class="code" href="group__flac__metadata__level2.html#gga27a18">FLAC__METADATA_CHAIN_STATUS_OK</a> = 0, 13700724 <a class="code" href="group__flac__metadata__level2.html#gga27a19">FLAC__METADATA_CHAIN_STATUS_ILLEGAL_INPUT</a>, 13800727 <a class="code" href="group__flac__metadata__level2.html#gga27a20">FLAC__METADATA_CHAIN_STATUS_ERROR_OPENING_FILE</a>, 13900730 <a class="code" href="group__flac__metadata__level2.html#gga27a21">FLAC__METADATA_CHAIN_STATUS_NOT_A_FLAC_FILE</a>, 14000733 <a class="code" href="group__flac__metadata__level2.html#gga27a22">FLAC__METADATA_CHAIN_STATUS_NOT_WRITABLE</a>, 14100736 <a class="code" href="group__flac__metadata__level2.html#gga27a23">FLAC__METADATA_CHAIN_STATUS_BAD_METADATA</a>, 14200739 <a class="code" href="group__flac__metadata__level2.html#gga27a24">FLAC__METADATA_CHAIN_STATUS_READ_ERROR</a>, 14300742 <a class="code" href="group__flac__metadata__level2.html#gga27a25">FLAC__METADATA_CHAIN_STATUS_SEEK_ERROR</a>, 14400745 <a class="code" href="group__flac__metadata__level2.html#gga27a26">FLAC__METADATA_CHAIN_STATUS_WRITE_ERROR</a>, 14500748 <a class="code" href="group__flac__metadata__level2.html#gga27a27">FLAC__METADATA_CHAIN_STATUS_RENAME_ERROR</a>, 14600751 <a class="code" href="group__flac__metadata__level2.html#gga27a28">FLAC__METADATA_CHAIN_STATUS_UNLINK_ERROR</a>, 14700754 <a class="code" href="group__flac__metadata__level2.html#gga27a29">FLAC__METADATA_CHAIN_STATUS_MEMORY_ALLOCATION_ERROR</a>, 14800757 <a class="code" href="group__flac__metadata__level2.html#gga27a30">FLAC__METADATA_CHAIN_STATUS_INTERNAL_ERROR</a>, 14900760 <a class="code" href="group__flac__metadata__level2.html#gga27a31">FLAC__METADATA_CHAIN_STATUS_INVALID_CALLBACKS</a>, 15000763 <a class="code" href="group__flac__metadata__level2.html#gga27a32">FLAC__METADATA_CHAIN_STATUS_READ_WRITE_MISMATCH</a>, 15100772 <a class="code" href="group__flac__metadata__level2.html#gga27a33">FLAC__METADATA_CHAIN_STATUS_WRONG_WRITE_CALL</a> 15200782 } <a class="code" href="group__flac__metadata__level2.html#ga27">FLAC__Metadata_ChainStatus</a>; 15300783 15400789 <span class="keyword">extern</span> FLAC_API <span class="keyword">const</span> <span class="keywordtype">char</span> * <span class="keyword">const</span> <a class="code" href="group__flac__metadata__level2.html#ga2">FLAC__Metadata_ChainStatusString</a>[]; 15500790 15600791 <span class="comment">/*********** FLAC__Metadata_Chain ***********/</span> 15700792 15800798 FLAC_API FLAC__Metadata_Chain *<a class="code" href="group__flac__metadata__level2.html#ga3">FLAC__metadata_chain_new</a>(<span class="keywordtype">void</span>); 15900799 16000806 FLAC_API <span class="keywordtype">void</span> <a class="code" href="group__flac__metadata__level2.html#ga4">FLAC__metadata_chain_delete</a>(FLAC__Metadata_Chain *chain); 16100807 16200818 FLAC_API FLAC__Metadata_ChainStatus <a class="code" href="group__flac__metadata__level2.html#ga5">FLAC__metadata_chain_status</a>(FLAC__Metadata_Chain *chain); 16300819 16400832 FLAC_API FLAC__bool <a class="code" href="group__flac__metadata__level2.html#ga6">FLAC__metadata_chain_read</a>(FLAC__Metadata_Chain *chain, <span class="keyword">const</span> <span class="keywordtype">char</span> *filename); 16500833 16600849 FLAC_API FLAC__bool <a class="code" href="group__flac__metadata__level2.html#ga7">FLAC__metadata_chain_read_ogg</a>(FLAC__Metadata_Chain *chain, <span class="keyword">const</span> <span class="keywordtype">char</span> *filename); 16700850 16800871 FLAC_API FLAC__bool <a class="code" href="group__flac__metadata__level2.html#ga8">FLAC__metadata_chain_read_with_callbacks</a>(FLAC__Metadata_Chain *chain, <a class="code" href="group__flac__callbacks.html#ga0">FLAC__IOHandle</a> handle, <a class="code" href="structFLAC____IOCallbacks.html">FLAC__IOCallbacks</a> callbacks); 16900872 17000896 FLAC_API FLAC__bool <a class="code" href="group__flac__metadata__level2.html#ga9">FLAC__metadata_chain_read_ogg_with_callbacks</a>(FLAC__Metadata_Chain *chain, <a class="code" href="group__flac__callbacks.html#ga0">FLAC__IOHandle</a> handle, <a class="code" href="structFLAC____IOCallbacks.html">FLAC__IOCallbacks</a> callbacks); 17100897 17200924 FLAC_API FLAC__bool <a class="code" href="group__flac__metadata__level2.html#ga10">FLAC__metadata_chain_check_if_tempfile_needed</a>(FLAC__Metadata_Chain *chain, FLAC__bool use_padding); 17300925 17400970 FLAC_API FLAC__bool <a class="code" href="group__flac__metadata__level2.html#ga11">FLAC__metadata_chain_write</a>(FLAC__Metadata_Chain *chain, FLAC__bool use_padding, FLAC__bool preserve_file_stats); 17500971 17601000 FLAC_API FLAC__bool <a class="code" href="group__flac__metadata__level2.html#ga12">FLAC__metadata_chain_write_with_callbacks</a>(FLAC__Metadata_Chain *chain, FLAC__bool use_padding, <a class="code" href="group__flac__callbacks.html#ga0">FLAC__IOHandle</a> handle, <a class="code" href="structFLAC____IOCallbacks.html">FLAC__IOCallbacks</a> callbacks); 17701001 17801051 FLAC_API FLAC__bool <a class="code" href="group__flac__metadata__level2.html#ga13">FLAC__metadata_chain_write_with_callbacks_and_tempfile</a>(FLAC__Metadata_Chain *chain, FLAC__bool use_padding, <a class="code" href="group__flac__callbacks.html#ga0">FLAC__IOHandle</a> handle, <a class="code" href="structFLAC____IOCallbacks.html">FLAC__IOCallbacks</a> callbacks, <a class="code" href="group__flac__callbacks.html#ga0">FLAC__IOHandle</a> temp_handle, <a class="code" href="structFLAC____IOCallbacks.html">FLAC__IOCallbacks</a> temp_callbacks); 17901052 18001065 FLAC_API <span class="keywordtype">void</span> <a class="code" href="group__flac__metadata__level2.html#ga14">FLAC__metadata_chain_merge_padding</a>(FLAC__Metadata_Chain *chain); 18101066 18201080 FLAC_API <span class="keywordtype">void</span> <a class="code" href="group__flac__metadata__level2.html#ga15">FLAC__metadata_chain_sort_padding</a>(FLAC__Metadata_Chain *chain); 18301081 18401082 18501083 <span class="comment">/*********** FLAC__Metadata_Iterator ***********/</span> 18601084 18701090 FLAC_API FLAC__Metadata_Iterator *<a class="code" href="group__flac__metadata__level2.html#ga16">FLAC__metadata_iterator_new</a>(<span class="keywordtype">void</span>); 18801091 18901098 FLAC_API <span class="keywordtype">void</span> <a class="code" href="group__flac__metadata__level2.html#ga17">FLAC__metadata_iterator_delete</a>(FLAC__Metadata_Iterator *iterator); 19001099 19101109 FLAC_API <span class="keywordtype">void</span> <a class="code" href="group__flac__metadata__level2.html#ga18">FLAC__metadata_iterator_init</a>(FLAC__Metadata_Iterator *iterator, FLAC__Metadata_Chain *chain); 19201110 19301123 FLAC_API FLAC__bool <a class="code" href="group__flac__metadata__level2.html#ga19">FLAC__metadata_iterator_next</a>(FLAC__Metadata_Iterator *iterator); 19401124 19501137 FLAC_API FLAC__bool <a class="code" href="group__flac__metadata__level2.html#ga20">FLAC__metadata_iterator_prev</a>(FLAC__Metadata_Iterator *iterator); 19601138 19701149 FLAC_API <a class="code" href="group__flac__format.html#ga113">FLAC__MetadataType</a> <a class="code" href="group__flac__metadata__level2.html#ga21">FLAC__metadata_iterator_get_block_type</a>(<span class="keyword">const</span> FLAC__Metadata_Iterator *iterator); 19801150 19901170 FLAC_API <a class="code" href="structFLAC____StreamMetadata.html">FLAC__StreamMetadata</a> *<a class="code" href="group__flac__metadata__level2.html#ga22">FLAC__metadata_iterator_get_block</a>(FLAC__Metadata_Iterator *iterator); 20001171 20101187 FLAC_API FLAC__bool <a class="code" href="group__flac__metadata__level2.html#ga23">FLAC__metadata_iterator_set_block</a>(FLAC__Metadata_Iterator *iterator, <a class="code" href="structFLAC____StreamMetadata.html">FLAC__StreamMetadata</a> *block); 20201188 20301205 FLAC_API FLAC__bool <a class="code" href="group__flac__metadata__level2.html#ga24">FLAC__metadata_iterator_delete_block</a>(FLAC__Metadata_Iterator *iterator, FLAC__bool replace_with_padding); 20401206 20501224 FLAC_API FLAC__bool <a class="code" href="group__flac__metadata__level2.html#ga25">FLAC__metadata_iterator_insert_block_before</a>(FLAC__Metadata_Iterator *iterator, <a class="code" href="structFLAC____StreamMetadata.html">FLAC__StreamMetadata</a> *block); 20601225 20701242 FLAC_API FLAC__bool <a class="code" href="group__flac__metadata__level2.html#ga26">FLAC__metadata_iterator_insert_block_after</a>(FLAC__Metadata_Iterator *iterator, <a class="code" href="structFLAC____StreamMetadata.html">FLAC__StreamMetadata</a> *block); 20801243 20901244 <span class="comment">/* \} */</span> 21001245 21101246 21201312 FLAC_API <a class="code" href="structFLAC____StreamMetadata.html">FLAC__StreamMetadata</a> *<a class="code" href="group__flac__metadata__object.html#ga0">FLAC__metadata_object_new</a>(<a class="code" href="group__flac__format.html#ga113">FLAC__MetadataType</a> type); 21301313 21401326 FLAC_API <a class="code" href="structFLAC____StreamMetadata.html">FLAC__StreamMetadata</a> *<a class="code" href="group__flac__metadata__object.html#ga1">FLAC__metadata_object_clone</a>(<span class="keyword">const</span> <a class="code" href="structFLAC____StreamMetadata.html">FLAC__StreamMetadata</a> *object); 21501327 21601337 FLAC_API <span class="keywordtype">void</span> <a class="code" href="group__flac__metadata__object.html#ga2">FLAC__metadata_object_delete</a>(<a class="code" href="structFLAC____StreamMetadata.html">FLAC__StreamMetadata</a> *object); 21701338 21801352 FLAC_API FLAC__bool <a class="code" href="group__flac__metadata__object.html#ga3">FLAC__metadata_object_is_equal</a>(<span class="keyword">const</span> <a class="code" href="structFLAC____StreamMetadata.html">FLAC__StreamMetadata</a> *block1, <span class="keyword">const</span> <a class="code" href="structFLAC____StreamMetadata.html">FLAC__StreamMetadata</a> *block2); 21901353 22001375 FLAC_API FLAC__bool <a class="code" href="group__flac__metadata__object.html#ga4">FLAC__metadata_object_application_set_data</a>(<a class="code" href="structFLAC____StreamMetadata.html">FLAC__StreamMetadata</a> *object, FLAC__byte *data, <span class="keywordtype">unsigned</span> length, FLAC__bool copy); 22101376 22201392 FLAC_API FLAC__bool <a class="code" href="group__flac__metadata__object.html#ga5">FLAC__metadata_object_seektable_resize_points</a>(<a class="code" href="structFLAC____StreamMetadata.html">FLAC__StreamMetadata</a> *object, <span class="keywordtype">unsigned</span> new_num_points); 22301393 22401404 FLAC_API <span class="keywordtype">void</span> <a class="code" href="group__flac__metadata__object.html#ga6">FLAC__metadata_object_seektable_set_point</a>(<a class="code" href="structFLAC____StreamMetadata.html">FLAC__StreamMetadata</a> *object, <span class="keywordtype">unsigned</span> point_num, <a class="code" href="structFLAC____StreamMetadata__SeekPoint.html">FLAC__StreamMetadata_SeekPoint</a> point); 22501405 22601418 FLAC_API FLAC__bool <a class="code" href="group__flac__metadata__object.html#ga7">FLAC__metadata_object_seektable_insert_point</a>(<a class="code" href="structFLAC____StreamMetadata.html">FLAC__StreamMetadata</a> *object, <span class="keywordtype">unsigned</span> point_num, <a class="code" href="structFLAC____StreamMetadata__SeekPoint.html">FLAC__StreamMetadata_SeekPoint</a> point); 22701419 22801431 FLAC_API FLAC__bool <a class="code" href="group__flac__metadata__object.html#ga8">FLAC__metadata_object_seektable_delete_point</a>(<a class="code" href="structFLAC____StreamMetadata.html">FLAC__StreamMetadata</a> *object, <span class="keywordtype">unsigned</span> point_num); 22901432 23001444 FLAC_API FLAC__bool <a class="code" href="group__flac__metadata__object.html#ga9">FLAC__metadata_object_seektable_is_legal</a>(<span class="keyword">const</span> <a class="code" href="structFLAC____StreamMetadata.html">FLAC__StreamMetadata</a> *object); 23101445 23201461 FLAC_API FLAC__bool <a class="code" href="group__flac__metadata__object.html#ga10">FLAC__metadata_object_seektable_template_append_placeholders</a>(<a class="code" href="structFLAC____StreamMetadata.html">FLAC__StreamMetadata</a> *object, <span class="keywordtype">unsigned</span> num); 23301462 23401478 FLAC_API FLAC__bool <a class="code" href="group__flac__metadata__object.html#ga11">FLAC__metadata_object_seektable_template_append_point</a>(<a class="code" href="structFLAC____StreamMetadata.html">FLAC__StreamMetadata</a> *object, FLAC__uint64 sample_number); 23501479 23601496 FLAC_API FLAC__bool <a class="code" href="group__flac__metadata__object.html#ga12">FLAC__metadata_object_seektable_template_append_points</a>(<a class="code" href="structFLAC____StreamMetadata.html">FLAC__StreamMetadata</a> *object, FLAC__uint64 sample_numbers[], <span class="keywordtype">unsigned</span> num); 23701497 23801518 FLAC_API FLAC__bool <a class="code" href="group__flac__metadata__object.html#ga13">FLAC__metadata_object_seektable_template_append_spaced_points</a>(<a class="code" href="structFLAC____StreamMetadata.html">FLAC__StreamMetadata</a> *object, <span class="keywordtype">unsigned</span> num, FLAC__uint64 total_samples); 23901519 24001546 FLAC_API FLAC__bool <a class="code" href="group__flac__metadata__object.html#ga14">FLAC__metadata_object_seektable_template_append_spaced_points_by_samples</a>(<a class="code" href="structFLAC____StreamMetadata.html">FLAC__StreamMetadata</a> *object, <span class="keywordtype">unsigned</span> samples, FLAC__uint64 total_samples); 24101547 24201563 FLAC_API FLAC__bool <a class="code" href="group__flac__metadata__object.html#ga15">FLAC__metadata_object_seektable_template_sort</a>(<a class="code" href="structFLAC____StreamMetadata.html">FLAC__StreamMetadata</a> *object, FLAC__bool compact); 24301564 24401588 FLAC_API FLAC__bool <a class="code" href="group__flac__metadata__object.html#ga16">FLAC__metadata_object_vorbiscomment_set_vendor_string</a>(<a class="code" href="structFLAC____StreamMetadata.html">FLAC__StreamMetadata</a> *object, <a class="code" href="structFLAC____StreamMetadata__VorbisComment__Entry.html">FLAC__StreamMetadata_VorbisComment_Entry</a> entry, FLAC__bool copy); 24501589 24601605 FLAC_API FLAC__bool <a class="code" href="group__flac__metadata__object.html#ga17">FLAC__metadata_object_vorbiscomment_resize_comments</a>(<a class="code" href="structFLAC____StreamMetadata.html">FLAC__StreamMetadata</a> *object, <span class="keywordtype">unsigned</span> new_num_comments); 24701606 24801632 FLAC_API FLAC__bool <a class="code" href="group__flac__metadata__object.html#ga18">FLAC__metadata_object_vorbiscomment_set_comment</a>(<a class="code" href="structFLAC____StreamMetadata.html">FLAC__StreamMetadata</a> *object, <span class="keywordtype">unsigned</span> comment_num, <a class="code" href="structFLAC____StreamMetadata__VorbisComment__Entry.html">FLAC__StreamMetadata_VorbisComment_Entry</a> entry, FLAC__bool copy); 24901633 25001662 FLAC_API FLAC__bool <a class="code" href="group__flac__metadata__object.html#ga19">FLAC__metadata_object_vorbiscomment_insert_comment</a>(<a class="code" href="structFLAC____StreamMetadata.html">FLAC__StreamMetadata</a> *object, <span class="keywordtype">unsigned</span> comment_num, <a class="code" href="structFLAC____StreamMetadata__VorbisComment__Entry.html">FLAC__StreamMetadata_VorbisComment_Entry</a> entry, FLAC__bool copy); 25101663 25201687 FLAC_API FLAC__bool <a class="code" href="group__flac__metadata__object.html#ga20">FLAC__metadata_object_vorbiscomment_append_comment</a>(<a class="code" href="structFLAC____StreamMetadata.html">FLAC__StreamMetadata</a> *object, <a class="code" href="structFLAC____StreamMetadata__VorbisComment__Entry.html">FLAC__StreamMetadata_VorbisComment_Entry</a> entry, FLAC__bool copy); 25301688 25401722 FLAC_API FLAC__bool <a class="code" href="group__flac__metadata__object.html#ga21">FLAC__metadata_object_vorbiscomment_replace_comment</a>(<a class="code" href="structFLAC____StreamMetadata.html">FLAC__StreamMetadata</a> *object, <a class="code" href="structFLAC____StreamMetadata__VorbisComment__Entry.html">FLAC__StreamMetadata_VorbisComment_Entry</a> entry, FLAC__bool all, FLAC__bool copy); 25501723 25601735 FLAC_API FLAC__bool <a class="code" href="group__flac__metadata__object.html#ga22">FLAC__metadata_object_vorbiscomment_delete_comment</a>(<a class="code" href="structFLAC____StreamMetadata.html">FLAC__StreamMetadata</a> *object, <span class="keywordtype">unsigned</span> comment_num); 25701736 25801756 FLAC_API FLAC__bool <a class="code" href="group__flac__metadata__object.html#ga23">FLAC__metadata_object_vorbiscomment_entry_from_name_value_pair</a>(<a class="code" href="structFLAC____StreamMetadata__VorbisComment__Entry.html">FLAC__StreamMetadata_VorbisComment_Entry</a> *entry, <span class="keyword">const</span> <span class="keywordtype">char</span> *field_name, <span class="keyword">const</span> <span class="keywordtype">char</span> *field_value); 25901757 26001777 FLAC_API FLAC__bool <a class="code" href="group__flac__metadata__object.html#ga24">FLAC__metadata_object_vorbiscomment_entry_to_name_value_pair</a>(<span class="keyword">const</span> <a class="code" href="structFLAC____StreamMetadata__VorbisComment__Entry.html">FLAC__StreamMetadata_VorbisComment_Entry</a> entry, <span class="keywordtype">char</span> **field_name, <span class="keywordtype">char</span> **field_value); 26101778 26201791 FLAC_API FLAC__bool <a class="code" href="group__flac__metadata__object.html#ga25">FLAC__metadata_object_vorbiscomment_entry_matches</a>(<span class="keyword">const</span> <a class="code" href="structFLAC____StreamMetadata__VorbisComment__Entry.html">FLAC__StreamMetadata_VorbisComment_Entry</a> entry, <span class="keyword">const</span> <span class="keywordtype">char</span> *field_name, <span class="keywordtype">unsigned</span> field_name_length); 26301792 26401810 FLAC_API <span class="keywordtype">int</span> <a class="code" href="group__flac__metadata__object.html#ga26">FLAC__metadata_object_vorbiscomment_find_entry_from</a>(<span class="keyword">const</span> <a class="code" href="structFLAC____StreamMetadata.html">FLAC__StreamMetadata</a> *object, <span class="keywordtype">unsigned</span> offset, <span class="keyword">const</span> <span class="keywordtype">char</span> *field_name); 26501811 26601823 FLAC_API <span class="keywordtype">int</span> <a class="code" href="group__flac__metadata__object.html#ga27">FLAC__metadata_object_vorbiscomment_remove_entry_matching</a>(<a class="code" href="structFLAC____StreamMetadata.html">FLAC__StreamMetadata</a> *object, <span class="keyword">const</span> <span class="keywordtype">char</span> *field_name); 26701824 26801836 FLAC_API <span class="keywordtype">int</span> <a class="code" href="group__flac__metadata__object.html#ga28">FLAC__metadata_object_vorbiscomment_remove_entries_matching</a>(<a class="code" href="structFLAC____StreamMetadata.html">FLAC__StreamMetadata</a> *object, <span class="keyword">const</span> <span class="keywordtype">char</span> *field_name); 26901837 27001845 FLAC_API <a class="code" href="structFLAC____StreamMetadata__CueSheet__Track.html">FLAC__StreamMetadata_CueSheet_Track</a> *<a class="code" href="group__flac__metadata__object.html#ga29">FLAC__metadata_object_cuesheet_track_new</a>(<span class="keywordtype">void</span>); 27101846 27201860 FLAC_API <a class="code" href="structFLAC____StreamMetadata__CueSheet__Track.html">FLAC__StreamMetadata_CueSheet_Track</a> *<a class="code" href="group__flac__metadata__object.html#ga30">FLAC__metadata_object_cuesheet_track_clone</a>(<span class="keyword">const</span> <a class="code" href="structFLAC____StreamMetadata__CueSheet__Track.html">FLAC__StreamMetadata_CueSheet_Track</a> *object); 27301861 27401868 FLAC_API <span class="keywordtype">void</span> <a class="code" href="group__flac__metadata__object.html#ga31">FLAC__metadata_object_cuesheet_track_delete</a>(<a class="code" href="structFLAC____StreamMetadata__CueSheet__Track.html">FLAC__StreamMetadata_CueSheet_Track</a> *object); 27501869 27601888 FLAC_API FLAC__bool <a class="code" href="group__flac__metadata__object.html#ga32">FLAC__metadata_object_cuesheet_track_resize_indices</a>(<a class="code" href="structFLAC____StreamMetadata.html">FLAC__StreamMetadata</a> *object, <span class="keywordtype">unsigned</span> track_num, <span class="keywordtype">unsigned</span> new_num_indices); 27701889 27801911 FLAC_API FLAC__bool <a class="code" href="group__flac__metadata__object.html#ga33">FLAC__metadata_object_cuesheet_track_insert_index</a>(<a class="code" href="structFLAC____StreamMetadata.html">FLAC__StreamMetadata</a> *object, <span class="keywordtype">unsigned</span> track_num, <span class="keywordtype">unsigned</span> index_num, <a class="code" href="structFLAC____StreamMetadata__CueSheet__Index.html">FLAC__StreamMetadata_CueSheet_Index</a> index); 27901912 28001935 FLAC_API FLAC__bool <a class="code" href="group__flac__metadata__object.html#ga34">FLAC__metadata_object_cuesheet_track_insert_blank_index</a>(<a class="code" href="structFLAC____StreamMetadata.html">FLAC__StreamMetadata</a> *object, <span class="keywordtype">unsigned</span> track_num, <span class="keywordtype">unsigned</span> index_num); 28101936 28201954 FLAC_API FLAC__bool <a class="code" href="group__flac__metadata__object.html#ga35">FLAC__metadata_object_cuesheet_track_delete_index</a>(<a class="code" href="structFLAC____StreamMetadata.html">FLAC__StreamMetadata</a> *object, <span class="keywordtype">unsigned</span> track_num, <span class="keywordtype">unsigned</span> index_num); 28301955 28401971 FLAC_API FLAC__bool <a class="code" href="group__flac__metadata__object.html#ga36">FLAC__metadata_object_cuesheet_resize_tracks</a>(<a class="code" href="structFLAC____StreamMetadata.html">FLAC__StreamMetadata</a> *object, <span class="keywordtype">unsigned</span> new_num_tracks); 28501972 28601993 FLAC_API FLAC__bool FLAC__metadata_object_cuesheet_set_track(<a class="code" href="structFLAC____StreamMetadata.html">FLAC__StreamMetadata</a> *object, <span class="keywordtype">unsigned</span> track_num, <a class="code" href="structFLAC____StreamMetadata__CueSheet__Track.html">FLAC__StreamMetadata_CueSheet_Track</a> *track, FLAC__bool copy); 28701994 28802016 FLAC_API FLAC__bool <a class="code" href="group__flac__metadata__object.html#ga37">FLAC__metadata_object_cuesheet_insert_track</a>(<a class="code" href="structFLAC____StreamMetadata.html">FLAC__StreamMetadata</a> *object, <span class="keywordtype">unsigned</span> track_num, <a class="code" href="structFLAC____StreamMetadata__CueSheet__Track.html">FLAC__StreamMetadata_CueSheet_Track</a> *track, FLAC__bool copy); 28902017 29002035 FLAC_API FLAC__bool <a class="code" href="group__flac__metadata__object.html#ga38">FLAC__metadata_object_cuesheet_insert_blank_track</a>(<a class="code" href="structFLAC____StreamMetadata.html">FLAC__StreamMetadata</a> *object, <span class="keywordtype">unsigned</span> track_num); 29102036 29202050 FLAC_API FLAC__bool <a class="code" href="group__flac__metadata__object.html#ga39">FLAC__metadata_object_cuesheet_delete_track</a>(<a class="code" href="structFLAC____StreamMetadata.html">FLAC__StreamMetadata</a> *object, <span class="keywordtype">unsigned</span> track_num); 29302051 29402071 FLAC_API FLAC__bool <a class="code" href="group__flac__metadata__object.html#ga40">FLAC__metadata_object_cuesheet_is_legal</a>(<span class="keyword">const</span> <a class="code" href="structFLAC____StreamMetadata.html">FLAC__StreamMetadata</a> *object, FLAC__bool check_cd_da_subset, <span class="keyword">const</span> <span class="keywordtype">char</span> **violation); 29502072 29602084 FLAC_API FLAC__uint32 <a class="code" href="group__flac__metadata__object.html#ga41">FLAC__metadata_object_cuesheet_calculate_cddb_id</a>(<span class="keyword">const</span> <a class="code" href="structFLAC____StreamMetadata.html">FLAC__StreamMetadata</a> *object); 29702085 29802107 FLAC_API FLAC__bool <a class="code" href="group__flac__metadata__object.html#ga42">FLAC__metadata_object_picture_set_mime_type</a>(<a class="code" href="structFLAC____StreamMetadata.html">FLAC__StreamMetadata</a> *object, <span class="keywordtype">char</span> *mime_type, FLAC__bool copy); 29902108 30002129 FLAC_API FLAC__bool <a class="code" href="group__flac__metadata__object.html#ga43">FLAC__metadata_object_picture_set_description</a>(<a class="code" href="structFLAC____StreamMetadata.html">FLAC__StreamMetadata</a> *object, FLAC__byte *description, FLAC__bool copy); 30102130 30202154 FLAC_API FLAC__bool <a class="code" href="group__flac__metadata__object.html#ga44">FLAC__metadata_object_picture_set_data</a>(<a class="code" href="structFLAC____StreamMetadata.html">FLAC__StreamMetadata</a> *object, FLAC__byte *data, FLAC__uint32 length, FLAC__bool copy); 30302155 30402173 FLAC_API FLAC__bool <a class="code" href="group__flac__metadata__object.html#ga45">FLAC__metadata_object_picture_is_legal</a>(<span class="keyword">const</span> <a class="code" href="structFLAC____StreamMetadata.html">FLAC__StreamMetadata</a> *object, <span class="keyword">const</span> <span class="keywordtype">char</span> **violation); 30502174 30602175 <span class="comment">/* \} */</span> 30702176 30802177 <span class="preprocessor">#ifdef __cplusplus</span> 30902178 <span class="preprocessor"></span>} 31002179 <span class="preprocessor">#endif</span> 31102180 <span class="preprocessor"></span> 31202181 <span class="preprocessor">#endif</span> 313</pre></div> 314<hr size="1"> 315<div class="copyright"> 316 <!-- @@@ oh so hacky --> 317 <table> 318 <tr> 319 <td align="left"> 320 Copyright (c) 2000,2001,2002,2003,2004,2005,2006,2007 Josh Coalson 321 </td> 322 <td width="1%" align="right"> 323 <a href="http://sourceforge.net"><img src="http://sflogo.sourceforge.net/sflogo.php?group_id=13478&type=1" width="88" height="31" border="0" alt="SourceForge.net Logo" /></a> 324 </td> 325 </tr> 326 </table> 327</div> 328<!-- Copyright (c) 2000,2001,2002,2003,2004,2005,2006,2007 Josh Coalson --> 329<!-- Permission is granted to copy, distribute and/or modify this document --> 330<!-- under the terms of the GNU Free Documentation License, Version 1.1 --> 331<!-- or any later version published by the Free Software Foundation; --> 332<!-- with no invariant sections. --> 333<!-- A copy of the license can be found at http://www.gnu.org/copyleft/fdl.html --> 334</body> 335</html> 336