<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> <html xmlns="http://www.w3.org/1999/xhtml"> <head> <meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/> <title>id3lib: src/misc_support.cpp Source File</title> <link href="tabs.css" rel="stylesheet" type="text/css"/> <link href="id3lib.css" rel="stylesheet" type="text/css"/> </head> <body> <!-- Generated by Doxygen 1.7.3 --> <div id="top"> <div id="titlearea"> <table cellspacing="0" cellpadding="0"> <tbody> <tr style="height: 56px;"> <td style="padding-left: 0.5em;"> <div id="projectname">id3lib <span id="projectnumber">3.8.3</span></div> </td> </tr> </tbody> </table> </div> <div id="navrow1" class="tabs"> <ul class="tablist"> <li><a href="index.html"><span>Main Page</span></a></li> <li><a href="namespaces.html"><span>Namespaces</span></a></li> <li><a href="annotated.html"><span>Classes</span></a></li> <li class="current"><a href="files.html"><span>Files</span></a></li> </ul> </div> <div id="navrow2" class="tabs2"> <ul class="tablist"> <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="header"> <div class="headertitle"> <h1>src/misc_support.cpp</h1> </div> </div> <div class="contents"> <a href="misc__support_8cpp.html">Go to the documentation of this file.</a><div class="fragment"><pre class="fragment"><a name="l00001"></a>00001 <span class="comment">// $Id: misc_support.cpp,v 1.39 2002/09/19 10:20:45 t1mpy Exp $</span> <a name="l00002"></a>00002 <a name="l00003"></a>00003 <span class="comment">// id3lib: a C++ library for creating and manipulating id3v1/v2 tags</span> <a name="l00004"></a>00004 <span class="comment">// Copyright 1999, 2000 Scott Thomas Haug</span> <a name="l00005"></a>00005 <span class="comment">// Copyright 2002 Thijmen Klok (thijmen@id3lib.org)</span> <a name="l00006"></a>00006 <a name="l00007"></a>00007 <span class="comment">// This library is free software; you can redistribute it and/or modify it</span> <a name="l00008"></a>00008 <span class="comment">// under the terms of the GNU Library General Public License as published by</span> <a name="l00009"></a>00009 <span class="comment">// the Free Software Foundation; either version 2 of the License, or (at your</span> <a name="l00010"></a>00010 <span class="comment">// option) any later version.</span> <a name="l00011"></a>00011 <span class="comment">//</span> <a name="l00012"></a>00012 <span class="comment">// This library is distributed in the hope that it will be useful, but WITHOUT</span> <a name="l00013"></a>00013 <span class="comment">// ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or</span> <a name="l00014"></a>00014 <span class="comment">// FITNESS FOR A PARTICULAR PURPOSE. See the GNU Library General Public</span> <a name="l00015"></a>00015 <span class="comment">// License for more details.</span> <a name="l00016"></a>00016 <span class="comment">//</span> <a name="l00017"></a>00017 <span class="comment">// You should have received a copy of the GNU Library General Public License</span> <a name="l00018"></a>00018 <span class="comment">// along with this library; if not, write to the Free Software Foundation,</span> <a name="l00019"></a>00019 <span class="comment">// Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.</span> <a name="l00020"></a>00020 <a name="l00021"></a>00021 <span class="comment">// The id3lib authors encourage improvements and optimisations to be sent to</span> <a name="l00022"></a>00022 <span class="comment">// the id3lib coordinator. Please see the README file for details on where to</span> <a name="l00023"></a>00023 <span class="comment">// send such submissions. See the AUTHORS file for a list of people who have</span> <a name="l00024"></a>00024 <span class="comment">// contributed to id3lib. See the ChangeLog file for a list of changes to</span> <a name="l00025"></a>00025 <span class="comment">// id3lib. These files are distributed with id3lib at</span> <a name="l00026"></a>00026 <span class="comment">// http://download.sourceforge.net/id3lib/</span> <a name="l00027"></a>00027 <a name="l00028"></a>00028 <span class="comment">//#include <ctype.h></span> <a name="l00029"></a>00029 <span class="preprocessor">#include <stdio.h></span> <a name="l00030"></a>00030 <a name="l00031"></a>00031 <span class="preprocessor">#include "misc_support.h"</span> <a name="l00032"></a>00032 <span class="comment">//#include "field.h"</span> <a name="l00033"></a>00033 <span class="preprocessor">#include "id3/utils.h"</span> <span class="comment">// has <config.h> "id3/id3lib_streams.h" "id3/globals.h" "id3/id3lib_strings.h"</span> <a name="l00034"></a>00034 <a name="l00035"></a>00035 <span class="comment">//using namespace dami;</span> <a name="l00036"></a>00036 <a name="l00037"></a><a class="code" href="misc__support_8h.html#a164be7b94d00aec08d9ca5b58bacf8f5">00037</a> <span class="keywordtype">char</span> *<a class="code" href="misc__support_8cpp.html#aeb3ba3ba28ea24ffe6a6d8a5fce9f4ed">ID3_GetString</a>(<span class="keyword">const</span> <a class="code" href="class_i_d3___frame.html" title="The representative class of an id3v2 frame.">ID3_Frame</a> *frame, <a class="code" href="globals_8h.html#a23cab982426a968437cd731900cfeb2c" title="Enumeration of the different types of fields in a frame.">ID3_FieldID</a> fldName) <a name="l00038"></a>00038 { <a name="l00039"></a>00039 <span class="keywordtype">char</span> *text = <a class="code" href="globals_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a>; <a name="l00040"></a>00040 <span class="comment">// if (NULL != frame)</span> <a name="l00041"></a>00041 <a class="code" href="class_i_d3___field.html" title="The representative class of an ID3v2 field.">ID3_Field</a>* fld; <a name="l00042"></a>00042 <span class="keywordflow">if</span> (<a class="code" href="globals_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a> != frame && <a class="code" href="globals_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a> != (fld = frame-><a class="code" href="class_i_d3___frame.html#a6491b36aee70776ed656896daa42ef80">GetField</a>(fldName))) <a name="l00043"></a>00043 { <a name="l00044"></a>00044 <span class="comment">// ID3_Field* fld = frame->GetField(fldName);</span> <a name="l00045"></a>00045 <a class="code" href="globals_8h.html#a2a414b8e1666bd6dd8dce86cdcf74a39" title="Enumeration of the types of text encodings: ascii or unicode.">ID3_TextEnc</a> enc = fld-><a class="code" href="class_i_d3___field.html#a524fc008d3f7cfb458ccf3cf25d28875">GetEncoding</a>(); <a name="l00046"></a>00046 fld-><a class="code" href="class_i_d3___field.html#a9f3b7f8b5ee007ee64caa133804c38f2">SetEncoding</a>(<a class="code" href="globals_8h.html#a2a414b8e1666bd6dd8dce86cdcf74a39a7f1d22c45b1a520e6261b73d1e54b0c9">ID3TE_ISO8859_1</a>); <a name="l00047"></a>00047 <span class="keywordtype">size_t</span> nText = fld-><a class="code" href="class_i_d3___field.html#a4eed557e9f540d3c9347ac31f0f8e55b" title="Returns the size of a field.">Size</a>(); <a name="l00048"></a>00048 text = <span class="keyword">new</span> <span class="keywordtype">char</span>[nText + 1]; <a name="l00049"></a>00049 fld-><a class="code" href="class_i_d3___field.html#a363d1034fb4e60e85f15bcf9818d33ef" title="Returns the value of the integer field.">Get</a>(text, nText + 1); <a name="l00050"></a>00050 fld-><a class="code" href="class_i_d3___field.html#a9f3b7f8b5ee007ee64caa133804c38f2">SetEncoding</a>(enc); <a name="l00051"></a>00051 } <a name="l00052"></a>00052 <span class="keywordflow">return</span> text; <a name="l00053"></a>00053 } <a name="l00054"></a>00054 <a name="l00055"></a><a class="code" href="misc__support_8h.html#a76a891dec2e91580b8aed4c59130154e">00055</a> <span class="keywordtype">char</span> *<a class="code" href="misc__support_8cpp.html#aeb3ba3ba28ea24ffe6a6d8a5fce9f4ed">ID3_GetString</a>(<span class="keyword">const</span> <a class="code" href="class_i_d3___frame.html" title="The representative class of an id3v2 frame.">ID3_Frame</a> *frame, <a class="code" href="globals_8h.html#a23cab982426a968437cd731900cfeb2c" title="Enumeration of the different types of fields in a frame.">ID3_FieldID</a> fldName, <span class="keywordtype">size_t</span> nIndex) <a name="l00056"></a>00056 { <a name="l00057"></a>00057 <span class="keywordtype">char</span> *text = <a class="code" href="globals_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a>; <a name="l00058"></a>00058 <span class="keywordflow">if</span> (<a class="code" href="globals_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a> != frame) <a name="l00059"></a>00059 { <a name="l00060"></a>00060 <span class="keywordtype">size_t</span> nText = frame-><a class="code" href="class_i_d3___frame.html#a6491b36aee70776ed656896daa42ef80">GetField</a>(fldName)-><a class="code" href="class_i_d3___field.html#a4eed557e9f540d3c9347ac31f0f8e55b" title="Returns the size of a field.">Size</a>(); <a name="l00061"></a>00061 text = <span class="keyword">new</span> <span class="keywordtype">char</span>[nText + 1]; <a name="l00062"></a>00062 frame-><a class="code" href="class_i_d3___frame.html#a6491b36aee70776ed656896daa42ef80">GetField</a>(fldName)-><a class="code" href="class_i_d3___field.html#a363d1034fb4e60e85f15bcf9818d33ef" title="Returns the value of the integer field.">Get</a>(text, nText + 1, nIndex); <a name="l00063"></a>00063 } <a name="l00064"></a>00064 <span class="keywordflow">return</span> text; <a name="l00065"></a>00065 } <a name="l00066"></a>00066 <a name="l00067"></a><a class="code" href="misc__support_8h.html#ac1c1e65fdcb50a8b42aa76e9fcfb72ff">00067</a> <span class="keywordtype">void</span> <a class="code" href="misc__support_8cpp.html#a686a75136af25fb1e15985273b1708e9">ID3_FreeString</a>(<span class="keywordtype">char</span> *str) <a name="l00068"></a>00068 { <a name="l00069"></a>00069 <span class="keywordflow">if</span>(str != <a class="code" href="globals_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a>) <a name="l00070"></a>00070 <span class="keyword">delete</span> [] str; <a name="l00071"></a>00071 } <a name="l00072"></a>00072 <a name="l00073"></a><a class="code" href="misc__support_8h.html#acd8acd49e1dfe014d334f40b7b10f811">00073</a> <span class="keywordtype">char</span> *<a class="code" href="misc__support_8cpp.html#a05b64ac86c88700209b5432e91da5737">ID3_GetArtist</a>(<span class="keyword">const</span> <a class="code" href="class_i_d3___tag.html" title="The representative class of an id3 tag.">ID3_Tag</a> *tag) <a name="l00074"></a>00074 { <a name="l00075"></a>00075 <span class="keywordtype">char</span> *sArtist = <a class="code" href="globals_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a>; <a name="l00076"></a>00076 <span class="keywordflow">if</span> (<a class="code" href="globals_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a> == tag) <a name="l00077"></a>00077 { <a name="l00078"></a>00078 <span class="keywordflow">return</span> sArtist; <a name="l00079"></a>00079 } <a name="l00080"></a>00080 <a name="l00081"></a>00081 <a class="code" href="class_i_d3___frame.html" title="The representative class of an id3v2 frame.">ID3_Frame</a> *frame = <a class="code" href="globals_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a>; <a name="l00082"></a>00082 <span class="keywordflow">if</span> ((frame = tag-><a class="code" href="class_i_d3___tag.html#aad2a8e5a801bc09eac967d24ff3539c3" title="Finds frame with given frame id, fld id, and integer data.">Find</a>(<a class="code" href="globals_8h.html#a78f454bf66f16b1e1c9f8e37bda9ab8aa01ed8e673c6a4b5b55cca106cd35a961" title="Lead performer(s)/Soloist(s)">ID3FID_LEADARTIST</a>)) || <a name="l00083"></a>00083 (frame = tag-><a class="code" href="class_i_d3___tag.html#aad2a8e5a801bc09eac967d24ff3539c3" title="Finds frame with given frame id, fld id, and integer data.">Find</a>(<a class="code" href="globals_8h.html#a78f454bf66f16b1e1c9f8e37bda9ab8aa80b4cd55d507e07f8134bccb01055864" title="Band/orchestra/accompaniment.">ID3FID_BAND</a>)) || <a name="l00084"></a>00084 (frame = tag-><a class="code" href="class_i_d3___tag.html#aad2a8e5a801bc09eac967d24ff3539c3" title="Finds frame with given frame id, fld id, and integer data.">Find</a>(<a class="code" href="globals_8h.html#a78f454bf66f16b1e1c9f8e37bda9ab8aab432ac53f663b747e24774582ce35368" title="Conductor/performer refinement.">ID3FID_CONDUCTOR</a>)) || <a name="l00085"></a>00085 (frame = tag-><a class="code" href="class_i_d3___tag.html#aad2a8e5a801bc09eac967d24ff3539c3" title="Finds frame with given frame id, fld id, and integer data.">Find</a>(<a class="code" href="globals_8h.html#a78f454bf66f16b1e1c9f8e37bda9ab8aa1d2b0478593a40fec84fa5f7ba6416cd" title="Composer.">ID3FID_COMPOSER</a>))) <a name="l00086"></a>00086 { <a name="l00087"></a>00087 sArtist = <a class="code" href="misc__support_8cpp.html#aeb3ba3ba28ea24ffe6a6d8a5fce9f4ed">ID3_GetString</a>(frame, <a class="code" href="globals_8h.html#a23cab982426a968437cd731900cfeb2cab4a3b9cafedc2cede90380c79edca044" title="Text field.">ID3FN_TEXT</a>); <a name="l00088"></a>00088 } <a name="l00089"></a>00089 <span class="keywordflow">return</span> sArtist; <a name="l00090"></a>00090 } <a name="l00091"></a>00091 <a name="l00092"></a><a class="code" href="misc__support_8h.html#a745baf95b9c0fbb4c70bdf6d7fcbfc58">00092</a> <a class="code" href="class_i_d3___frame.html" title="The representative class of an id3v2 frame.">ID3_Frame</a>* <a class="code" href="misc__support_8cpp.html#a9da7b9274f65ee689f2c769fcdf7dd21">ID3_AddArtist</a>(<a class="code" href="class_i_d3___tag.html" title="The representative class of an id3 tag.">ID3_Tag</a> *tag, <span class="keyword">const</span> <span class="keywordtype">char</span> *text, <span class="keywordtype">bool</span> replace) <a name="l00093"></a>00093 { <a name="l00094"></a>00094 <a class="code" href="class_i_d3___frame.html" title="The representative class of an id3v2 frame.">ID3_Frame</a>* frame = <a class="code" href="globals_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a>; <a name="l00095"></a>00095 <span class="keywordflow">if</span> (<a class="code" href="globals_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a> != tag && <a class="code" href="globals_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a> != text && strlen(text) > 0) <a name="l00096"></a>00096 { <a name="l00097"></a>00097 <span class="keywordflow">if</span> (replace) <a name="l00098"></a>00098 { <a name="l00099"></a>00099 <a class="code" href="misc__support_8cpp.html#af6da7997e3fcc45be5dd8f0b5f3fc7f3">ID3_RemoveArtists</a>(tag); <a name="l00100"></a>00100 } <a name="l00101"></a>00101 <span class="keywordflow">if</span> (replace || <a name="l00102"></a>00102 (tag-><a class="code" href="class_i_d3___tag.html#aad2a8e5a801bc09eac967d24ff3539c3" title="Finds frame with given frame id, fld id, and integer data.">Find</a>(<a class="code" href="globals_8h.html#a78f454bf66f16b1e1c9f8e37bda9ab8aa01ed8e673c6a4b5b55cca106cd35a961" title="Lead performer(s)/Soloist(s)">ID3FID_LEADARTIST</a>) == <a class="code" href="globals_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a> && <a name="l00103"></a>00103 tag-><a class="code" href="class_i_d3___tag.html#aad2a8e5a801bc09eac967d24ff3539c3" title="Finds frame with given frame id, fld id, and integer data.">Find</a>(<a class="code" href="globals_8h.html#a78f454bf66f16b1e1c9f8e37bda9ab8aa80b4cd55d507e07f8134bccb01055864" title="Band/orchestra/accompaniment.">ID3FID_BAND</a>) == <a class="code" href="globals_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a> && <a name="l00104"></a>00104 tag-><a class="code" href="class_i_d3___tag.html#aad2a8e5a801bc09eac967d24ff3539c3" title="Finds frame with given frame id, fld id, and integer data.">Find</a>(<a class="code" href="globals_8h.html#a78f454bf66f16b1e1c9f8e37bda9ab8aab432ac53f663b747e24774582ce35368" title="Conductor/performer refinement.">ID3FID_CONDUCTOR</a>) == <a class="code" href="globals_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a> && <a name="l00105"></a>00105 tag-><a class="code" href="class_i_d3___tag.html#aad2a8e5a801bc09eac967d24ff3539c3" title="Finds frame with given frame id, fld id, and integer data.">Find</a>(<a class="code" href="globals_8h.html#a78f454bf66f16b1e1c9f8e37bda9ab8aa1d2b0478593a40fec84fa5f7ba6416cd" title="Composer.">ID3FID_COMPOSER</a>) == <a class="code" href="globals_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a>)) <a name="l00106"></a>00106 { <a name="l00107"></a>00107 frame = <span class="keyword">new</span> <a class="code" href="class_i_d3___frame.html" title="The representative class of an id3v2 frame.">ID3_Frame</a>(<a class="code" href="globals_8h.html#a78f454bf66f16b1e1c9f8e37bda9ab8aa01ed8e673c6a4b5b55cca106cd35a961" title="Lead performer(s)/Soloist(s)">ID3FID_LEADARTIST</a>); <a name="l00108"></a>00108 <span class="keywordflow">if</span> (frame) <a name="l00109"></a>00109 { <a name="l00110"></a>00110 frame-><a class="code" href="class_i_d3___frame.html#a6491b36aee70776ed656896daa42ef80">GetField</a>(<a class="code" href="globals_8h.html#a23cab982426a968437cd731900cfeb2cab4a3b9cafedc2cede90380c79edca044" title="Text field.">ID3FN_TEXT</a>)-><a class="code" href="class_i_d3___field.html#a16387cf6c54df5432a0c048d6a931f03">Set</a>(text); <a name="l00111"></a>00111 tag-><a class="code" href="class_i_d3___tag.html#a8760bcb5321fc95ee0e91a2057b4eb9c" title="Attaches a frame to the tag; the tag takes responsibility for releasing the frame&#39;s memory when t...">AttachFrame</a>(frame); <a name="l00112"></a>00112 } <a name="l00113"></a>00113 } <a name="l00114"></a>00114 } <a name="l00115"></a>00115 <span class="keywordflow">return</span> frame; <a name="l00116"></a>00116 } <a name="l00117"></a>00117 <a name="l00118"></a><a class="code" href="misc__support_8h.html#a62f4b2d8181d44807fec57aaf0a0dea5">00118</a> <span class="keywordtype">size_t</span> <a class="code" href="misc__support_8cpp.html#af6da7997e3fcc45be5dd8f0b5f3fc7f3">ID3_RemoveArtists</a>(<a class="code" href="class_i_d3___tag.html" title="The representative class of an id3 tag.">ID3_Tag</a> *tag) <a name="l00119"></a>00119 { <a name="l00120"></a>00120 <span class="keywordtype">size_t</span> num_removed = 0; <a name="l00121"></a>00121 <a class="code" href="class_i_d3___frame.html" title="The representative class of an id3v2 frame.">ID3_Frame</a> *frame = <a class="code" href="globals_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a>; <a name="l00122"></a>00122 <a name="l00123"></a>00123 <span class="keywordflow">if</span> (<a class="code" href="globals_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a> == tag) <a name="l00124"></a>00124 { <a name="l00125"></a>00125 <span class="keywordflow">return</span> num_removed; <a name="l00126"></a>00126 } <a name="l00127"></a>00127 <a name="l00128"></a>00128 <span class="keywordflow">while</span> ((frame = tag-><a class="code" href="class_i_d3___tag.html#aad2a8e5a801bc09eac967d24ff3539c3" title="Finds frame with given frame id, fld id, and integer data.">Find</a>(<a class="code" href="globals_8h.html#a78f454bf66f16b1e1c9f8e37bda9ab8aa01ed8e673c6a4b5b55cca106cd35a961" title="Lead performer(s)/Soloist(s)">ID3FID_LEADARTIST</a>))) <a name="l00129"></a>00129 { <a name="l00130"></a>00130 frame = tag-><a class="code" href="class_i_d3___tag.html#ae21522e16cb899c5cd1c42d8f7fdfad9" title="Removes a frame from the tag.">RemoveFrame</a>(frame); <a name="l00131"></a>00131 <span class="keyword">delete</span> frame; <a name="l00132"></a>00132 num_removed++; <a name="l00133"></a>00133 } <a name="l00134"></a>00134 <span class="keywordflow">while</span> ((frame = tag-><a class="code" href="class_i_d3___tag.html#aad2a8e5a801bc09eac967d24ff3539c3" title="Finds frame with given frame id, fld id, and integer data.">Find</a>(<a class="code" href="globals_8h.html#a78f454bf66f16b1e1c9f8e37bda9ab8aa80b4cd55d507e07f8134bccb01055864" title="Band/orchestra/accompaniment.">ID3FID_BAND</a>))) <a name="l00135"></a>00135 { <a name="l00136"></a>00136 frame = tag-><a class="code" href="class_i_d3___tag.html#ae21522e16cb899c5cd1c42d8f7fdfad9" title="Removes a frame from the tag.">RemoveFrame</a>(frame); <a name="l00137"></a>00137 <span class="keyword">delete</span> frame; <a name="l00138"></a>00138 num_removed++; <a name="l00139"></a>00139 } <a name="l00140"></a>00140 <span class="keywordflow">while</span> ((frame = tag-><a class="code" href="class_i_d3___tag.html#aad2a8e5a801bc09eac967d24ff3539c3" title="Finds frame with given frame id, fld id, and integer data.">Find</a>(<a class="code" href="globals_8h.html#a78f454bf66f16b1e1c9f8e37bda9ab8aab432ac53f663b747e24774582ce35368" title="Conductor/performer refinement.">ID3FID_CONDUCTOR</a>))) <a name="l00141"></a>00141 { <a name="l00142"></a>00142 frame = tag-><a class="code" href="class_i_d3___tag.html#ae21522e16cb899c5cd1c42d8f7fdfad9" title="Removes a frame from the tag.">RemoveFrame</a>(frame); <a name="l00143"></a>00143 <span class="keyword">delete</span> frame; <a name="l00144"></a>00144 num_removed++; <a name="l00145"></a>00145 } <a name="l00146"></a>00146 <span class="keywordflow">while</span> ((frame = tag-><a class="code" href="class_i_d3___tag.html#aad2a8e5a801bc09eac967d24ff3539c3" title="Finds frame with given frame id, fld id, and integer data.">Find</a>(<a class="code" href="globals_8h.html#a78f454bf66f16b1e1c9f8e37bda9ab8aa1d2b0478593a40fec84fa5f7ba6416cd" title="Composer.">ID3FID_COMPOSER</a>))) <a name="l00147"></a>00147 { <a name="l00148"></a>00148 frame = tag-><a class="code" href="class_i_d3___tag.html#ae21522e16cb899c5cd1c42d8f7fdfad9" title="Removes a frame from the tag.">RemoveFrame</a>(frame); <a name="l00149"></a>00149 <span class="keyword">delete</span> frame; <a name="l00150"></a>00150 num_removed++; <a name="l00151"></a>00151 } <a name="l00152"></a>00152 <a name="l00153"></a>00153 <span class="keywordflow">return</span> num_removed; <a name="l00154"></a>00154 } <a name="l00155"></a>00155 <a name="l00156"></a><a class="code" href="misc__support_8h.html#a6a35c179717d32109fb4767424dc680e">00156</a> <span class="keywordtype">char</span> *<a class="code" href="misc__support_8cpp.html#a81369bb2f59c0c5633ebc1888847244c">ID3_GetAlbum</a>(<span class="keyword">const</span> <a class="code" href="class_i_d3___tag.html" title="The representative class of an id3 tag.">ID3_Tag</a> *tag) <a name="l00157"></a>00157 { <a name="l00158"></a>00158 <span class="keywordtype">char</span> *sAlbum = <a class="code" href="globals_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a>; <a name="l00159"></a>00159 <span class="keywordflow">if</span> (<a class="code" href="globals_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a> == tag) <a name="l00160"></a>00160 { <a name="l00161"></a>00161 <span class="keywordflow">return</span> sAlbum; <a name="l00162"></a>00162 } <a name="l00163"></a>00163 <a name="l00164"></a>00164 <a class="code" href="class_i_d3___frame.html" title="The representative class of an id3v2 frame.">ID3_Frame</a> *frame = tag-><a class="code" href="class_i_d3___tag.html#aad2a8e5a801bc09eac967d24ff3539c3" title="Finds frame with given frame id, fld id, and integer data.">Find</a>(<a class="code" href="globals_8h.html#a78f454bf66f16b1e1c9f8e37bda9ab8aa8b1cc72205175363486074e6e56b072a" title="Album/Movie/Show title.">ID3FID_ALBUM</a>); <a name="l00165"></a>00165 <span class="keywordflow">if</span> (frame != <a class="code" href="globals_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a>) <a name="l00166"></a>00166 { <a name="l00167"></a>00167 sAlbum = <a class="code" href="misc__support_8cpp.html#aeb3ba3ba28ea24ffe6a6d8a5fce9f4ed">ID3_GetString</a>(frame, <a class="code" href="globals_8h.html#a23cab982426a968437cd731900cfeb2cab4a3b9cafedc2cede90380c79edca044" title="Text field.">ID3FN_TEXT</a>); <a name="l00168"></a>00168 } <a name="l00169"></a>00169 <span class="keywordflow">return</span> sAlbum; <a name="l00170"></a>00170 } <a name="l00171"></a>00171 <a name="l00172"></a><a class="code" href="misc__support_8h.html#aa6ee0df505ca6fb4f0d7f27311a8f986">00172</a> <a class="code" href="class_i_d3___frame.html" title="The representative class of an id3v2 frame.">ID3_Frame</a>* <a class="code" href="misc__support_8cpp.html#a9d966139a2da23665ea271bf47119079">ID3_AddAlbum</a>(<a class="code" href="class_i_d3___tag.html" title="The representative class of an id3 tag.">ID3_Tag</a> *tag, <span class="keyword">const</span> <span class="keywordtype">char</span> *text, <span class="keywordtype">bool</span> replace) <a name="l00173"></a>00173 { <a name="l00174"></a>00174 <a class="code" href="class_i_d3___frame.html" title="The representative class of an id3v2 frame.">ID3_Frame</a>* frame = <a class="code" href="globals_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a>; <a name="l00175"></a>00175 <span class="keywordflow">if</span> (<a class="code" href="globals_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a> != tag && <a class="code" href="globals_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a> != text && strlen(text) > 0) <a name="l00176"></a>00176 { <a name="l00177"></a>00177 <span class="keywordflow">if</span> (replace) <a name="l00178"></a>00178 { <a name="l00179"></a>00179 <a class="code" href="misc__support_8cpp.html#aa83386c0e2810b911f9e177507bb5f9d">ID3_RemoveAlbums</a>(tag); <a name="l00180"></a>00180 } <a name="l00181"></a>00181 <span class="keywordflow">if</span> (replace || tag-><a class="code" href="class_i_d3___tag.html#aad2a8e5a801bc09eac967d24ff3539c3" title="Finds frame with given frame id, fld id, and integer data.">Find</a>(<a class="code" href="globals_8h.html#a78f454bf66f16b1e1c9f8e37bda9ab8aa8b1cc72205175363486074e6e56b072a" title="Album/Movie/Show title.">ID3FID_ALBUM</a>) == <a class="code" href="globals_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a>) <a name="l00182"></a>00182 { <a name="l00183"></a>00183 frame = <span class="keyword">new</span> <a class="code" href="class_i_d3___frame.html" title="The representative class of an id3v2 frame.">ID3_Frame</a>(<a class="code" href="globals_8h.html#a78f454bf66f16b1e1c9f8e37bda9ab8aa8b1cc72205175363486074e6e56b072a" title="Album/Movie/Show title.">ID3FID_ALBUM</a>); <a name="l00184"></a>00184 <span class="keywordflow">if</span> (frame) <a name="l00185"></a>00185 { <a name="l00186"></a>00186 frame-><a class="code" href="class_i_d3___frame.html#a6491b36aee70776ed656896daa42ef80">GetField</a>(<a class="code" href="globals_8h.html#a23cab982426a968437cd731900cfeb2cab4a3b9cafedc2cede90380c79edca044" title="Text field.">ID3FN_TEXT</a>)-><a class="code" href="class_i_d3___field.html#a16387cf6c54df5432a0c048d6a931f03">Set</a>(text); <a name="l00187"></a>00187 tag-><a class="code" href="class_i_d3___tag.html#a8760bcb5321fc95ee0e91a2057b4eb9c" title="Attaches a frame to the tag; the tag takes responsibility for releasing the frame&#39;s memory when t...">AttachFrame</a>(frame); <a name="l00188"></a>00188 } <a name="l00189"></a>00189 } <a name="l00190"></a>00190 } <a name="l00191"></a>00191 <a name="l00192"></a>00192 <span class="keywordflow">return</span> frame; <a name="l00193"></a>00193 } <a name="l00194"></a>00194 <a name="l00195"></a><a class="code" href="misc__support_8h.html#a644f14c13431367394fad0c3c6163c92">00195</a> <span class="keywordtype">size_t</span> <a class="code" href="misc__support_8cpp.html#aa83386c0e2810b911f9e177507bb5f9d">ID3_RemoveAlbums</a>(<a class="code" href="class_i_d3___tag.html" title="The representative class of an id3 tag.">ID3_Tag</a> *tag) <a name="l00196"></a>00196 { <a name="l00197"></a>00197 <span class="keywordtype">size_t</span> num_removed = 0; <a name="l00198"></a>00198 <a class="code" href="class_i_d3___frame.html" title="The representative class of an id3v2 frame.">ID3_Frame</a> *frame = <a class="code" href="globals_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a>; <a name="l00199"></a>00199 <a name="l00200"></a>00200 <span class="keywordflow">if</span> (<a class="code" href="globals_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a> == tag) <a name="l00201"></a>00201 { <a name="l00202"></a>00202 <span class="keywordflow">return</span> num_removed; <a name="l00203"></a>00203 } <a name="l00204"></a>00204 <a name="l00205"></a>00205 <span class="keywordflow">while</span> ((frame = tag-><a class="code" href="class_i_d3___tag.html#aad2a8e5a801bc09eac967d24ff3539c3" title="Finds frame with given frame id, fld id, and integer data.">Find</a>(<a class="code" href="globals_8h.html#a78f454bf66f16b1e1c9f8e37bda9ab8aa8b1cc72205175363486074e6e56b072a" title="Album/Movie/Show title.">ID3FID_ALBUM</a>))) <a name="l00206"></a>00206 { <a name="l00207"></a>00207 frame = tag-><a class="code" href="class_i_d3___tag.html#ae21522e16cb899c5cd1c42d8f7fdfad9" title="Removes a frame from the tag.">RemoveFrame</a>(frame); <a name="l00208"></a>00208 <span class="keyword">delete</span> frame; <a name="l00209"></a>00209 num_removed++; <a name="l00210"></a>00210 } <a name="l00211"></a>00211 <a name="l00212"></a>00212 <span class="keywordflow">return</span> num_removed; <a name="l00213"></a>00213 } <a name="l00214"></a>00214 <a name="l00215"></a><a class="code" href="misc__support_8h.html#aa7281186e5caec36b6b5beb5f798e988">00215</a> <span class="keywordtype">char</span> *<a class="code" href="misc__support_8cpp.html#a47d197e738371925c86a135137edbb37">ID3_GetTitle</a>(<span class="keyword">const</span> <a class="code" href="class_i_d3___tag.html" title="The representative class of an id3 tag.">ID3_Tag</a> *tag) <a name="l00216"></a>00216 { <a name="l00217"></a>00217 <span class="keywordtype">char</span> *sTitle = <a class="code" href="globals_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a>; <a name="l00218"></a>00218 <span class="keywordflow">if</span> (<a class="code" href="globals_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a> == tag) <a name="l00219"></a>00219 { <a name="l00220"></a>00220 <span class="keywordflow">return</span> sTitle; <a name="l00221"></a>00221 } <a name="l00222"></a>00222 <a name="l00223"></a>00223 <a class="code" href="class_i_d3___frame.html" title="The representative class of an id3v2 frame.">ID3_Frame</a> *frame = tag-><a class="code" href="class_i_d3___tag.html#aad2a8e5a801bc09eac967d24ff3539c3" title="Finds frame with given frame id, fld id, and integer data.">Find</a>(<a class="code" href="globals_8h.html#a78f454bf66f16b1e1c9f8e37bda9ab8aaf7e8a066a7c9debd6dfd742cfb5a080b" title="Title/songname/content description.">ID3FID_TITLE</a>); <a name="l00224"></a>00224 <span class="keywordflow">if</span> (frame != <a class="code" href="globals_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a>) <a name="l00225"></a>00225 { <a name="l00226"></a>00226 sTitle = <a class="code" href="misc__support_8cpp.html#aeb3ba3ba28ea24ffe6a6d8a5fce9f4ed">ID3_GetString</a>(frame, <a class="code" href="globals_8h.html#a23cab982426a968437cd731900cfeb2cab4a3b9cafedc2cede90380c79edca044" title="Text field.">ID3FN_TEXT</a>); <a name="l00227"></a>00227 } <a name="l00228"></a>00228 <span class="keywordflow">return</span> sTitle; <a name="l00229"></a>00229 } <a name="l00230"></a>00230 <a name="l00231"></a><a class="code" href="misc__support_8h.html#a1fbeba1044fe55c3edf4638d592d1503">00231</a> <a class="code" href="class_i_d3___frame.html" title="The representative class of an id3v2 frame.">ID3_Frame</a>* <a class="code" href="misc__support_8cpp.html#ac52136e1c8fd0c090eeb02c7c0d9e242">ID3_AddTitle</a>(<a class="code" href="class_i_d3___tag.html" title="The representative class of an id3 tag.">ID3_Tag</a> *tag, <span class="keyword">const</span> <span class="keywordtype">char</span> *text, <span class="keywordtype">bool</span> replace) <a name="l00232"></a>00232 { <a name="l00233"></a>00233 <a class="code" href="class_i_d3___frame.html" title="The representative class of an id3v2 frame.">ID3_Frame</a>* frame = <a class="code" href="globals_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a>; <a name="l00234"></a>00234 <span class="keywordflow">if</span> (<a class="code" href="globals_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a> != tag && <a class="code" href="globals_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a> != text && strlen(text) > 0) <a name="l00235"></a>00235 { <a name="l00236"></a>00236 <span class="keywordflow">if</span> (replace) <a name="l00237"></a>00237 { <a name="l00238"></a>00238 <a class="code" href="misc__support_8cpp.html#ace770754133269149a2ba28f65a6c644">ID3_RemoveTitles</a>(tag); <a name="l00239"></a>00239 } <a name="l00240"></a>00240 <span class="keywordflow">if</span> (replace || tag-><a class="code" href="class_i_d3___tag.html#aad2a8e5a801bc09eac967d24ff3539c3" title="Finds frame with given frame id, fld id, and integer data.">Find</a>(<a class="code" href="globals_8h.html#a78f454bf66f16b1e1c9f8e37bda9ab8aaf7e8a066a7c9debd6dfd742cfb5a080b" title="Title/songname/content description.">ID3FID_TITLE</a>) == <a class="code" href="globals_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a>) <a name="l00241"></a>00241 { <a name="l00242"></a>00242 frame = <span class="keyword">new</span> <a class="code" href="class_i_d3___frame.html" title="The representative class of an id3v2 frame.">ID3_Frame</a>(<a class="code" href="globals_8h.html#a78f454bf66f16b1e1c9f8e37bda9ab8aaf7e8a066a7c9debd6dfd742cfb5a080b" title="Title/songname/content description.">ID3FID_TITLE</a>); <a name="l00243"></a>00243 <span class="keywordflow">if</span> (frame) <a name="l00244"></a>00244 { <a name="l00245"></a>00245 frame-><a class="code" href="class_i_d3___frame.html#a6491b36aee70776ed656896daa42ef80">GetField</a>(<a class="code" href="globals_8h.html#a23cab982426a968437cd731900cfeb2cab4a3b9cafedc2cede90380c79edca044" title="Text field.">ID3FN_TEXT</a>)-><a class="code" href="class_i_d3___field.html#a16387cf6c54df5432a0c048d6a931f03">Set</a>(text); <a name="l00246"></a>00246 tag-><a class="code" href="class_i_d3___tag.html#a8760bcb5321fc95ee0e91a2057b4eb9c" title="Attaches a frame to the tag; the tag takes responsibility for releasing the frame&#39;s memory when t...">AttachFrame</a>(frame); <a name="l00247"></a>00247 } <a name="l00248"></a>00248 } <a name="l00249"></a>00249 } <a name="l00250"></a>00250 <a name="l00251"></a>00251 <span class="keywordflow">return</span> frame; <a name="l00252"></a>00252 } <a name="l00253"></a>00253 <a name="l00254"></a><a class="code" href="misc__support_8h.html#ac7010c90d2fa383250afc15fe19dda9d">00254</a> <span class="keywordtype">size_t</span> <a class="code" href="misc__support_8cpp.html#ace770754133269149a2ba28f65a6c644">ID3_RemoveTitles</a>(<a class="code" href="class_i_d3___tag.html" title="The representative class of an id3 tag.">ID3_Tag</a> *tag) <a name="l00255"></a>00255 { <a name="l00256"></a>00256 <span class="keywordtype">size_t</span> num_removed = 0; <a name="l00257"></a>00257 <a class="code" href="class_i_d3___frame.html" title="The representative class of an id3v2 frame.">ID3_Frame</a> *frame = <a class="code" href="globals_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a>; <a name="l00258"></a>00258 <a name="l00259"></a>00259 <span class="keywordflow">if</span> (<a class="code" href="globals_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a> == tag) <a name="l00260"></a>00260 { <a name="l00261"></a>00261 <span class="keywordflow">return</span> num_removed; <a name="l00262"></a>00262 } <a name="l00263"></a>00263 <a name="l00264"></a>00264 <span class="keywordflow">while</span> ((frame = tag-><a class="code" href="class_i_d3___tag.html#aad2a8e5a801bc09eac967d24ff3539c3" title="Finds frame with given frame id, fld id, and integer data.">Find</a>(<a class="code" href="globals_8h.html#a78f454bf66f16b1e1c9f8e37bda9ab8aaf7e8a066a7c9debd6dfd742cfb5a080b" title="Title/songname/content description.">ID3FID_TITLE</a>))) <a name="l00265"></a>00265 { <a name="l00266"></a>00266 frame = tag-><a class="code" href="class_i_d3___tag.html#ae21522e16cb899c5cd1c42d8f7fdfad9" title="Removes a frame from the tag.">RemoveFrame</a>(frame); <a name="l00267"></a>00267 <span class="keyword">delete</span> frame; <a name="l00268"></a>00268 num_removed++; <a name="l00269"></a>00269 } <a name="l00270"></a>00270 <a name="l00271"></a>00271 <span class="keywordflow">return</span> num_removed; <a name="l00272"></a>00272 } <a name="l00273"></a>00273 <a name="l00274"></a><a class="code" href="misc__support_8h.html#a126093c77a79b2d575566a5f1b5fce2c">00274</a> <span class="keywordtype">char</span> *<a class="code" href="misc__support_8cpp.html#abe06f72a464cefc354e40314bbc44b6d">ID3_GetYear</a>(<span class="keyword">const</span> <a class="code" href="class_i_d3___tag.html" title="The representative class of an id3 tag.">ID3_Tag</a> *tag) <a name="l00275"></a>00275 { <a name="l00276"></a>00276 <span class="keywordtype">char</span> *sYear = <a class="code" href="globals_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a>; <a name="l00277"></a>00277 <span class="keywordflow">if</span> (<a class="code" href="globals_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a> == tag) <a name="l00278"></a>00278 { <a name="l00279"></a>00279 <span class="keywordflow">return</span> sYear; <a name="l00280"></a>00280 } <a name="l00281"></a>00281 <a name="l00282"></a>00282 <a class="code" href="class_i_d3___frame.html" title="The representative class of an id3v2 frame.">ID3_Frame</a> *frame = tag-><a class="code" href="class_i_d3___tag.html#aad2a8e5a801bc09eac967d24ff3539c3" title="Finds frame with given frame id, fld id, and integer data.">Find</a>(<a class="code" href="globals_8h.html#a78f454bf66f16b1e1c9f8e37bda9ab8aabcb5af26e4995a9cf303c93e37f5e23f" title="Year.">ID3FID_YEAR</a>); <a name="l00283"></a>00283 <span class="keywordflow">if</span> (frame != <a class="code" href="globals_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a>) <a name="l00284"></a>00284 { <a name="l00285"></a>00285 sYear = <a class="code" href="misc__support_8cpp.html#aeb3ba3ba28ea24ffe6a6d8a5fce9f4ed">ID3_GetString</a>(frame, <a class="code" href="globals_8h.html#a23cab982426a968437cd731900cfeb2cab4a3b9cafedc2cede90380c79edca044" title="Text field.">ID3FN_TEXT</a>); <a name="l00286"></a>00286 } <a name="l00287"></a>00287 <span class="keywordflow">return</span> sYear; <a name="l00288"></a>00288 } <a name="l00289"></a>00289 <a name="l00290"></a><a class="code" href="misc__support_8h.html#a4941a7cabd2c2cb57ac77b29f55609cc">00290</a> <a class="code" href="class_i_d3___frame.html" title="The representative class of an id3v2 frame.">ID3_Frame</a>* <a class="code" href="misc__support_8cpp.html#a6005e5d52b3f0eb50b6e89a71b543b41">ID3_AddYear</a>(<a class="code" href="class_i_d3___tag.html" title="The representative class of an id3 tag.">ID3_Tag</a> *tag, <span class="keyword">const</span> <span class="keywordtype">char</span> *text, <span class="keywordtype">bool</span> replace) <a name="l00291"></a>00291 { <a name="l00292"></a>00292 <a class="code" href="class_i_d3___frame.html" title="The representative class of an id3v2 frame.">ID3_Frame</a>* frame = <a class="code" href="globals_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a>; <a name="l00293"></a>00293 <span class="keywordflow">if</span> (<a class="code" href="globals_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a> != tag && <a class="code" href="globals_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a> != text && strlen(text) > 0) <a name="l00294"></a>00294 { <a name="l00295"></a>00295 <span class="keywordflow">if</span> (replace) <a name="l00296"></a>00296 { <a name="l00297"></a>00297 <a class="code" href="misc__support_8cpp.html#ace42d757b74ceebefaca281d56ff8358">ID3_RemoveYears</a>(tag); <a name="l00298"></a>00298 } <a name="l00299"></a>00299 <span class="keywordflow">if</span> (replace || tag-><a class="code" href="class_i_d3___tag.html#aad2a8e5a801bc09eac967d24ff3539c3" title="Finds frame with given frame id, fld id, and integer data.">Find</a>(<a class="code" href="globals_8h.html#a78f454bf66f16b1e1c9f8e37bda9ab8aabcb5af26e4995a9cf303c93e37f5e23f" title="Year.">ID3FID_YEAR</a>) == <a class="code" href="globals_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a>) <a name="l00300"></a>00300 { <a name="l00301"></a>00301 frame = <span class="keyword">new</span> <a class="code" href="class_i_d3___frame.html" title="The representative class of an id3v2 frame.">ID3_Frame</a>(<a class="code" href="globals_8h.html#a78f454bf66f16b1e1c9f8e37bda9ab8aabcb5af26e4995a9cf303c93e37f5e23f" title="Year.">ID3FID_YEAR</a>); <a name="l00302"></a>00302 <span class="keywordflow">if</span> (<a class="code" href="globals_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a> != frame) <a name="l00303"></a>00303 { <a name="l00304"></a>00304 frame-><a class="code" href="class_i_d3___frame.html#a6491b36aee70776ed656896daa42ef80">GetField</a>(<a class="code" href="globals_8h.html#a23cab982426a968437cd731900cfeb2cab4a3b9cafedc2cede90380c79edca044" title="Text field.">ID3FN_TEXT</a>)-><a class="code" href="class_i_d3___field.html#a16387cf6c54df5432a0c048d6a931f03">Set</a>(text); <a name="l00305"></a>00305 tag-><a class="code" href="class_i_d3___tag.html#a8760bcb5321fc95ee0e91a2057b4eb9c" title="Attaches a frame to the tag; the tag takes responsibility for releasing the frame&#39;s memory when t...">AttachFrame</a>(frame); <a name="l00306"></a>00306 } <a name="l00307"></a>00307 } <a name="l00308"></a>00308 } <a name="l00309"></a>00309 <a name="l00310"></a>00310 <span class="keywordflow">return</span> frame; <a name="l00311"></a>00311 } <a name="l00312"></a>00312 <a name="l00313"></a><a class="code" href="misc__support_8h.html#a63a83c07912b613d1f2f730fc70211d7">00313</a> <span class="keywordtype">size_t</span> <a class="code" href="misc__support_8cpp.html#ace42d757b74ceebefaca281d56ff8358">ID3_RemoveYears</a>(<a class="code" href="class_i_d3___tag.html" title="The representative class of an id3 tag.">ID3_Tag</a> *tag) <a name="l00314"></a>00314 { <a name="l00315"></a>00315 <span class="keywordtype">size_t</span> num_removed = 0; <a name="l00316"></a>00316 <a class="code" href="class_i_d3___frame.html" title="The representative class of an id3v2 frame.">ID3_Frame</a> *frame = <a class="code" href="globals_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a>; <a name="l00317"></a>00317 <a name="l00318"></a>00318 <span class="keywordflow">if</span> (<a class="code" href="globals_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a> == tag) <a name="l00319"></a>00319 { <a name="l00320"></a>00320 <span class="keywordflow">return</span> num_removed; <a name="l00321"></a>00321 } <a name="l00322"></a>00322 <a name="l00323"></a>00323 <span class="keywordflow">while</span> ((frame = tag-><a class="code" href="class_i_d3___tag.html#aad2a8e5a801bc09eac967d24ff3539c3" title="Finds frame with given frame id, fld id, and integer data.">Find</a>(<a class="code" href="globals_8h.html#a78f454bf66f16b1e1c9f8e37bda9ab8aabcb5af26e4995a9cf303c93e37f5e23f" title="Year.">ID3FID_YEAR</a>))) <a name="l00324"></a>00324 { <a name="l00325"></a>00325 frame = tag-><a class="code" href="class_i_d3___tag.html#ae21522e16cb899c5cd1c42d8f7fdfad9" title="Removes a frame from the tag.">RemoveFrame</a>(frame); <a name="l00326"></a>00326 <span class="keyword">delete</span> frame; <a name="l00327"></a>00327 num_removed++; <a name="l00328"></a>00328 } <a name="l00329"></a>00329 <a name="l00330"></a>00330 <span class="keywordflow">return</span> num_removed; <a name="l00331"></a>00331 } <a name="l00332"></a>00332 <a name="l00333"></a><a class="code" href="misc__support_8h.html#adb33fc76cdba0a133b1d23bfb4ec2a9c">00333</a> <span class="keywordtype">char</span> *<a class="code" href="misc__support_8cpp.html#ac68bb501bb5d7dc3f4c38514d9a68a79">ID3_GetComment</a>(<span class="keyword">const</span> <a class="code" href="class_i_d3___tag.html" title="The representative class of an id3 tag.">ID3_Tag</a> *tag, <span class="keyword">const</span> <span class="keywordtype">char</span>* desc) <a name="l00334"></a>00334 { <a name="l00335"></a>00335 <span class="keywordtype">char</span> *comment = <a class="code" href="globals_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a>; <a name="l00336"></a>00336 <span class="keywordflow">if</span> (<a class="code" href="globals_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a> == tag) <a name="l00337"></a>00337 { <a name="l00338"></a>00338 <span class="keywordflow">return</span> comment; <a name="l00339"></a>00339 } <a name="l00340"></a>00340 <a name="l00341"></a>00341 <a class="code" href="class_i_d3___frame.html" title="The representative class of an id3v2 frame.">ID3_Frame</a>* frame = <a class="code" href="globals_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a>; <a name="l00342"></a>00342 <span class="keywordflow">if</span> (desc) <a name="l00343"></a>00343 { <a name="l00344"></a>00344 frame = tag-><a class="code" href="class_i_d3___tag.html#aad2a8e5a801bc09eac967d24ff3539c3" title="Finds frame with given frame id, fld id, and integer data.">Find</a>(<a class="code" href="globals_8h.html#a78f454bf66f16b1e1c9f8e37bda9ab8aa8df694633e118d601850e497b132de0f" title="Comments.">ID3FID_COMMENT</a>, <a class="code" href="globals_8h.html#a23cab982426a968437cd731900cfeb2ca6898b894ce725eb89b42dc6f4f9117e5" title="Description field.">ID3FN_DESCRIPTION</a>, desc); <a name="l00345"></a>00345 } <a name="l00346"></a>00346 <span class="keywordflow">else</span> <a name="l00347"></a>00347 { <a name="l00348"></a>00348 frame = tag-><a class="code" href="class_i_d3___tag.html#aad2a8e5a801bc09eac967d24ff3539c3" title="Finds frame with given frame id, fld id, and integer data.">Find</a>(<a class="code" href="globals_8h.html#a78f454bf66f16b1e1c9f8e37bda9ab8aa8df694633e118d601850e497b132de0f" title="Comments.">ID3FID_COMMENT</a>); <a name="l00349"></a>00349 <span class="keywordflow">if</span>(frame == tag-><a class="code" href="class_i_d3___tag.html#aad2a8e5a801bc09eac967d24ff3539c3" title="Finds frame with given frame id, fld id, and integer data.">Find</a>(<a class="code" href="globals_8h.html#a78f454bf66f16b1e1c9f8e37bda9ab8aa8df694633e118d601850e497b132de0f" title="Comments.">ID3FID_COMMENT</a>, <a class="code" href="globals_8h.html#a23cab982426a968437cd731900cfeb2ca6898b894ce725eb89b42dc6f4f9117e5" title="Description field.">ID3FN_DESCRIPTION</a>, <a class="code" href="globals_8h.html#a543e9aefba16c7f820350bc6bcfae54c" title="String used for the description field of a comment tag converted from an id3v1 tag to an id3v2 tag...">STR_V1_COMMENT_DESC</a>)) <a name="l00350"></a>00350 frame = tag-><a class="code" href="class_i_d3___tag.html#aad2a8e5a801bc09eac967d24ff3539c3" title="Finds frame with given frame id, fld id, and integer data.">Find</a>(<a class="code" href="globals_8h.html#a78f454bf66f16b1e1c9f8e37bda9ab8aa8df694633e118d601850e497b132de0f" title="Comments.">ID3FID_COMMENT</a>); <a name="l00351"></a>00351 } <a name="l00352"></a>00352 <a name="l00353"></a>00353 <span class="keywordflow">if</span> (frame) <a name="l00354"></a>00354 comment = <a class="code" href="misc__support_8cpp.html#aeb3ba3ba28ea24ffe6a6d8a5fce9f4ed">ID3_GetString</a>(frame, <a class="code" href="globals_8h.html#a23cab982426a968437cd731900cfeb2cab4a3b9cafedc2cede90380c79edca044" title="Text field.">ID3FN_TEXT</a>); <a name="l00355"></a>00355 <span class="keywordflow">return</span> comment; <a name="l00356"></a>00356 } <a name="l00357"></a>00357 <a name="l00358"></a><a class="code" href="misc__support_8h.html#a3095908ba5dbb32a39f23711cb33dc35">00358</a> <a class="code" href="class_i_d3___frame.html" title="The representative class of an id3v2 frame.">ID3_Frame</a>* <a class="code" href="misc__support_8cpp.html#a18f44ce3c8d1bf4012582b10992659ce">ID3_AddComment</a>(<a class="code" href="class_i_d3___tag.html" title="The representative class of an id3 tag.">ID3_Tag</a> *tag, <span class="keyword">const</span> <span class="keywordtype">char</span> *text, <span class="keywordtype">bool</span> replace) <a name="l00359"></a>00359 { <a name="l00360"></a>00360 <span class="keywordflow">return</span> <a class="code" href="misc__support_8cpp.html#a18f44ce3c8d1bf4012582b10992659ce">ID3_AddComment</a>(tag, text, <span class="stringliteral">""</span>, replace); <a name="l00361"></a>00361 } <a name="l00362"></a>00362 <a name="l00363"></a><a class="code" href="misc__support_8h.html#a522ee813e68acd329465f6128fa4c796">00363</a> <a class="code" href="class_i_d3___frame.html" title="The representative class of an id3v2 frame.">ID3_Frame</a>* <a class="code" href="misc__support_8cpp.html#a18f44ce3c8d1bf4012582b10992659ce">ID3_AddComment</a>(<a class="code" href="class_i_d3___tag.html" title="The representative class of an id3 tag.">ID3_Tag</a> *tag, <span class="keyword">const</span> <span class="keywordtype">char</span> *text, <a name="l00364"></a>00364 <span class="keyword">const</span> <span class="keywordtype">char</span> *desc, <span class="keywordtype">bool</span> replace) <a name="l00365"></a>00365 { <a name="l00366"></a>00366 <span class="keywordflow">return</span> <a class="code" href="misc__support_8cpp.html#a18f44ce3c8d1bf4012582b10992659ce">ID3_AddComment</a>(tag, text, desc, <span class="stringliteral">"XXX"</span>, replace); <a name="l00367"></a>00367 } <a name="l00368"></a>00368 <a name="l00369"></a><a class="code" href="misc__support_8h.html#a6023ced8cf0eb6cae21300f9b3dc7b2c">00369</a> <a class="code" href="class_i_d3___frame.html" title="The representative class of an id3v2 frame.">ID3_Frame</a>* <a class="code" href="misc__support_8cpp.html#a18f44ce3c8d1bf4012582b10992659ce">ID3_AddComment</a>(<a class="code" href="class_i_d3___tag.html" title="The representative class of an id3 tag.">ID3_Tag</a> *tag, <span class="keyword">const</span> <span class="keywordtype">char</span> *text, <a name="l00370"></a>00370 <span class="keyword">const</span> <span class="keywordtype">char</span> *desc, <span class="keyword">const</span> <span class="keywordtype">char</span>* lang, <span class="keywordtype">bool</span> replace) <a name="l00371"></a>00371 { <a name="l00372"></a>00372 <a class="code" href="class_i_d3___frame.html" title="The representative class of an id3v2 frame.">ID3_Frame</a>* frame = <a class="code" href="globals_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a>; <a name="l00373"></a>00373 <span class="keywordflow">if</span> (<a class="code" href="globals_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a> != tag && <a name="l00374"></a>00374 <a class="code" href="globals_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a> != text && <a name="l00375"></a>00375 <a class="code" href="globals_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a> != desc && <a name="l00376"></a>00376 strlen(text) > 0) <a name="l00377"></a>00377 { <a name="l00378"></a>00378 <span class="keywordtype">bool</span> bAdd = <span class="keyword">true</span>; <a name="l00379"></a>00379 <span class="keywordflow">if</span> (replace) <a name="l00380"></a>00380 { <a name="l00381"></a>00381 <a class="code" href="misc__support_8cpp.html#a8a49ec747aac2931657ea786cc88d9f4">ID3_RemoveComments</a>(tag, desc); <a name="l00382"></a>00382 } <a name="l00383"></a>00383 <span class="keywordflow">else</span> <a name="l00384"></a>00384 { <a name="l00385"></a>00385 <span class="comment">// See if there is already a comment with this description</span> <a name="l00386"></a>00386 <a class="code" href="class_i_d3___tag_1_1_iterator.html">ID3_Tag::Iterator</a>* iter = tag-><a class="code" href="class_i_d3___tag.html#ad63ed5e405467892b3d4413b185c43ba">CreateIterator</a>(); <a name="l00387"></a>00387 <a class="code" href="class_i_d3___frame.html" title="The representative class of an id3v2 frame.">ID3_Frame</a>* frame = <a class="code" href="globals_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a>; <a name="l00388"></a>00388 <span class="keywordflow">while</span> ((frame = iter-><a class="code" href="class_i_d3___tag_1_1_iterator.html#ace2ed8451590035990151741432d89df">GetNext</a>()) != <a class="code" href="globals_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a>) <a name="l00389"></a>00389 { <a name="l00390"></a>00390 <span class="keywordflow">if</span> (frame-><a class="code" href="class_i_d3___frame.html#a93e8ff233deb9634f5990e4fb4c1b908" title="Returns the type of frame that the object represents.">GetID</a>() == <a class="code" href="globals_8h.html#a78f454bf66f16b1e1c9f8e37bda9ab8aa8df694633e118d601850e497b132de0f" title="Comments.">ID3FID_COMMENT</a>) <a name="l00391"></a>00391 { <a name="l00392"></a>00392 <span class="keywordtype">char</span> *tmp_desc = <a class="code" href="misc__support_8cpp.html#aeb3ba3ba28ea24ffe6a6d8a5fce9f4ed">ID3_GetString</a>(frame, <a class="code" href="globals_8h.html#a23cab982426a968437cd731900cfeb2ca6898b894ce725eb89b42dc6f4f9117e5" title="Description field.">ID3FN_DESCRIPTION</a>); <a name="l00393"></a>00393 <span class="keywordflow">if</span> (strcmp(tmp_desc, desc) == 0) <a name="l00394"></a>00394 { <a name="l00395"></a>00395 bAdd = <span class="keyword">false</span>; <a name="l00396"></a>00396 } <a name="l00397"></a>00397 <span class="keyword">delete</span> [] tmp_desc; <a name="l00398"></a>00398 <span class="keywordflow">if</span> (!bAdd) <a name="l00399"></a>00399 { <a name="l00400"></a>00400 <span class="keywordflow">break</span>; <a name="l00401"></a>00401 } <a name="l00402"></a>00402 } <a name="l00403"></a>00403 } <a name="l00404"></a>00404 <span class="keyword">delete</span> iter; <a name="l00405"></a>00405 } <a name="l00406"></a>00406 <span class="keywordflow">if</span> (bAdd) <a name="l00407"></a>00407 { <a name="l00408"></a>00408 frame = <span class="keyword">new</span> <a class="code" href="class_i_d3___frame.html" title="The representative class of an id3v2 frame.">ID3_Frame</a>(<a class="code" href="globals_8h.html#a78f454bf66f16b1e1c9f8e37bda9ab8aa8df694633e118d601850e497b132de0f" title="Comments.">ID3FID_COMMENT</a>); <a name="l00409"></a>00409 <span class="keywordflow">if</span> (<a class="code" href="globals_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a> != frame) <a name="l00410"></a>00410 { <a name="l00411"></a>00411 frame-><a class="code" href="class_i_d3___frame.html#a6491b36aee70776ed656896daa42ef80">GetField</a>(<a class="code" href="globals_8h.html#a23cab982426a968437cd731900cfeb2caae0e0a0e19501463ffb19f355fb36768" title="Language field.">ID3FN_LANGUAGE</a>)-><a class="code" href="class_i_d3___field.html#a16387cf6c54df5432a0c048d6a931f03">Set</a>(lang); <a name="l00412"></a>00412 frame-><a class="code" href="class_i_d3___frame.html#a6491b36aee70776ed656896daa42ef80">GetField</a>(<a class="code" href="globals_8h.html#a23cab982426a968437cd731900cfeb2ca6898b894ce725eb89b42dc6f4f9117e5" title="Description field.">ID3FN_DESCRIPTION</a>)-><a class="code" href="class_i_d3___field.html#a16387cf6c54df5432a0c048d6a931f03">Set</a>(desc); <a name="l00413"></a>00413 frame-><a class="code" href="class_i_d3___frame.html#a6491b36aee70776ed656896daa42ef80">GetField</a>(<a class="code" href="globals_8h.html#a23cab982426a968437cd731900cfeb2cab4a3b9cafedc2cede90380c79edca044" title="Text field.">ID3FN_TEXT</a>)-><a class="code" href="class_i_d3___field.html#a16387cf6c54df5432a0c048d6a931f03">Set</a>(text); <a name="l00414"></a>00414 tag-><a class="code" href="class_i_d3___tag.html#a8760bcb5321fc95ee0e91a2057b4eb9c" title="Attaches a frame to the tag; the tag takes responsibility for releasing the frame&#39;s memory when t...">AttachFrame</a>(frame); <a name="l00415"></a>00415 } <a name="l00416"></a>00416 } <a name="l00417"></a>00417 } <a name="l00418"></a>00418 <span class="keywordflow">return</span> frame; <a name="l00419"></a>00419 } <a name="l00420"></a>00420 <a name="l00421"></a>00421 <span class="comment">// Remove all comments with the given description (remove all comments if</span> <a name="l00422"></a>00422 <span class="comment">// desc is NULL)</span> <a name="l00423"></a><a class="code" href="misc__support_8h.html#a4c71bf00ee3b18327b4031cd9c486813">00423</a> <span class="keywordtype">size_t</span> <a class="code" href="misc__support_8cpp.html#a8a49ec747aac2931657ea786cc88d9f4">ID3_RemoveComments</a>(<a class="code" href="class_i_d3___tag.html" title="The representative class of an id3 tag.">ID3_Tag</a> *tag, <span class="keyword">const</span> <span class="keywordtype">char</span> *desc) <a name="l00424"></a>00424 { <a name="l00425"></a>00425 <span class="keywordtype">size_t</span> num_removed = 0; <a name="l00426"></a>00426 <a name="l00427"></a>00427 <span class="keywordflow">if</span> (<a class="code" href="globals_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a> == tag) <a name="l00428"></a>00428 { <a name="l00429"></a>00429 <span class="keywordflow">return</span> num_removed; <a name="l00430"></a>00430 } <a name="l00431"></a>00431 <a name="l00432"></a>00432 <a class="code" href="class_i_d3___tag_1_1_iterator.html">ID3_Tag::Iterator</a>* iter = tag-><a class="code" href="class_i_d3___tag.html#ad63ed5e405467892b3d4413b185c43ba">CreateIterator</a>(); <a name="l00433"></a>00433 <a class="code" href="class_i_d3___frame.html" title="The representative class of an id3v2 frame.">ID3_Frame</a>* frame = <a class="code" href="globals_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a>; <a name="l00434"></a>00434 <span class="keywordflow">while</span> ((frame = iter-><a class="code" href="class_i_d3___tag_1_1_iterator.html#ace2ed8451590035990151741432d89df">GetNext</a>()) != <a class="code" href="globals_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a>) <a name="l00435"></a>00435 { <a name="l00436"></a>00436 <span class="keywordflow">if</span> (frame-><a class="code" href="class_i_d3___frame.html#a93e8ff233deb9634f5990e4fb4c1b908" title="Returns the type of frame that the object represents.">GetID</a>() == <a class="code" href="globals_8h.html#a78f454bf66f16b1e1c9f8e37bda9ab8aa8df694633e118d601850e497b132de0f" title="Comments.">ID3FID_COMMENT</a>) <a name="l00437"></a>00437 { <a name="l00438"></a>00438 <span class="keywordtype">bool</span> <span class="keyword">remove</span> = <span class="keyword">false</span>; <a name="l00439"></a>00439 <span class="comment">// A null description means remove all comments</span> <a name="l00440"></a>00440 <span class="keywordflow">if</span> (<a class="code" href="globals_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a> == desc) <a name="l00441"></a>00441 { <a name="l00442"></a>00442 <span class="keyword">remove</span> = <span class="keyword">true</span>; <a name="l00443"></a>00443 } <a name="l00444"></a>00444 <span class="keywordflow">else</span> <a name="l00445"></a>00445 { <a name="l00446"></a>00446 <span class="comment">// See if the description we have matches the description of the</span> <a name="l00447"></a>00447 <span class="comment">// current comment. If so, set the "remove the comment" flag to true.</span> <a name="l00448"></a>00448 <span class="keywordtype">char</span> *tmp_desc = <a class="code" href="misc__support_8cpp.html#aeb3ba3ba28ea24ffe6a6d8a5fce9f4ed">ID3_GetString</a>(frame, <a class="code" href="globals_8h.html#a23cab982426a968437cd731900cfeb2ca6898b894ce725eb89b42dc6f4f9117e5" title="Description field.">ID3FN_DESCRIPTION</a>); <a name="l00449"></a>00449 <span class="keyword">remove</span> = (strcmp(tmp_desc, desc) == 0); <a name="l00450"></a>00450 <span class="keyword">delete</span> [] tmp_desc; <a name="l00451"></a>00451 } <a name="l00452"></a>00452 <span class="keywordflow">if</span> (<span class="keyword">remove</span>) <a name="l00453"></a>00453 { <a name="l00454"></a>00454 frame = tag-><a class="code" href="class_i_d3___tag.html#ae21522e16cb899c5cd1c42d8f7fdfad9" title="Removes a frame from the tag.">RemoveFrame</a>(frame); <a name="l00455"></a>00455 <span class="keyword">delete</span> frame; <a name="l00456"></a>00456 num_removed++; <a name="l00457"></a>00457 } <a name="l00458"></a>00458 } <a name="l00459"></a>00459 } <a name="l00460"></a>00460 <span class="keyword">delete</span> iter; <a name="l00461"></a>00461 <a name="l00462"></a>00462 <span class="keywordflow">return</span> num_removed; <a name="l00463"></a>00463 } <a name="l00464"></a>00464 <a name="l00465"></a><a class="code" href="misc__support_8h.html#a694c167a6d237ea4054458170f76a82c">00465</a> <span class="keywordtype">char</span> *<a class="code" href="misc__support_8cpp.html#a5c008f5c151c83d705ff2b6576e116d2">ID3_GetTrack</a>(<span class="keyword">const</span> <a class="code" href="class_i_d3___tag.html" title="The representative class of an id3 tag.">ID3_Tag</a> *tag) <a name="l00466"></a>00466 { <a name="l00467"></a>00467 <span class="keywordtype">char</span> *sTrack = <a class="code" href="globals_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a>; <a name="l00468"></a>00468 <span class="keywordflow">if</span> (<a class="code" href="globals_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a> == tag) <a name="l00469"></a>00469 { <a name="l00470"></a>00470 <span class="keywordflow">return</span> sTrack; <a name="l00471"></a>00471 } <a name="l00472"></a>00472 <a name="l00473"></a>00473 <a class="code" href="class_i_d3___frame.html" title="The representative class of an id3v2 frame.">ID3_Frame</a> *frame = tag-><a class="code" href="class_i_d3___tag.html#aad2a8e5a801bc09eac967d24ff3539c3" title="Finds frame with given frame id, fld id, and integer data.">Find</a>(<a class="code" href="globals_8h.html#a78f454bf66f16b1e1c9f8e37bda9ab8aace6669093c3bc849a75098d59f504759" title="Track number/Position in set.">ID3FID_TRACKNUM</a>); <a name="l00474"></a>00474 <span class="keywordflow">if</span> (frame != <a class="code" href="globals_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a>) <a name="l00475"></a>00475 { <a name="l00476"></a>00476 sTrack = <a class="code" href="misc__support_8cpp.html#aeb3ba3ba28ea24ffe6a6d8a5fce9f4ed">ID3_GetString</a>(frame, <a class="code" href="globals_8h.html#a23cab982426a968437cd731900cfeb2cab4a3b9cafedc2cede90380c79edca044" title="Text field.">ID3FN_TEXT</a>); <a name="l00477"></a>00477 } <a name="l00478"></a>00478 <span class="keywordflow">return</span> sTrack; <a name="l00479"></a>00479 } <a name="l00480"></a>00480 <a name="l00481"></a><a class="code" href="misc__support_8h.html#aa759272def49a6b055694b6f74569baa">00481</a> <span class="keywordtype">size_t</span> <a class="code" href="misc__support_8cpp.html#a02fd0d4730afb15744cf18a9be9ea147">ID3_GetTrackNum</a>(<span class="keyword">const</span> <a class="code" href="class_i_d3___tag.html" title="The representative class of an id3 tag.">ID3_Tag</a> *tag) <a name="l00482"></a>00482 { <a name="l00483"></a>00483 <span class="keywordtype">char</span> *sTrack = <a class="code" href="misc__support_8cpp.html#a5c008f5c151c83d705ff2b6576e116d2">ID3_GetTrack</a>(tag); <a name="l00484"></a>00484 <span class="keywordtype">size_t</span> nTrack = 0; <a name="l00485"></a>00485 <span class="keywordflow">if</span> (<a class="code" href="globals_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a> != sTrack) <a name="l00486"></a>00486 { <a name="l00487"></a>00487 nTrack = atoi(sTrack); <a name="l00488"></a>00488 <span class="keyword">delete</span> [] sTrack; <a name="l00489"></a>00489 } <a name="l00490"></a>00490 <span class="keywordflow">return</span> nTrack; <a name="l00491"></a>00491 } <a name="l00492"></a>00492 <a name="l00493"></a><a class="code" href="misc__support_8h.html#ad2f81d342b138aa2004bc0a344ca2dd2">00493</a> <a class="code" href="class_i_d3___frame.html" title="The representative class of an id3v2 frame.">ID3_Frame</a>* <a class="code" href="misc__support_8cpp.html#a7d60fa7f8679c90a0cec9dc8566522e6">ID3_AddTrack</a>(<a class="code" href="class_i_d3___tag.html" title="The representative class of an id3 tag.">ID3_Tag</a> *tag, <a class="code" href="globals_8h.html#a65f85814a8290f9797005d3b28e7e5fc">uchar</a> trk, <a class="code" href="globals_8h.html#a65f85814a8290f9797005d3b28e7e5fc">uchar</a> ttl, <span class="keywordtype">bool</span> replace) <a name="l00494"></a>00494 { <a name="l00495"></a>00495 <a class="code" href="class_i_d3___frame.html" title="The representative class of an id3v2 frame.">ID3_Frame</a>* frame = <a class="code" href="globals_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a>; <a name="l00496"></a>00496 <span class="keywordflow">if</span> (<a class="code" href="globals_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a> != tag && trk > 0) <a name="l00497"></a>00497 { <a name="l00498"></a>00498 <span class="keywordflow">if</span> (replace) <a name="l00499"></a>00499 { <a name="l00500"></a>00500 <a class="code" href="misc__support_8cpp.html#adb7de5e4dce14b935e672bf2da7ac798">ID3_RemoveTracks</a>(tag); <a name="l00501"></a>00501 } <a name="l00502"></a>00502 <span class="keywordflow">if</span> (replace || <a class="code" href="globals_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a> == tag-><a class="code" href="class_i_d3___tag.html#aad2a8e5a801bc09eac967d24ff3539c3" title="Finds frame with given frame id, fld id, and integer data.">Find</a>(<a class="code" href="globals_8h.html#a78f454bf66f16b1e1c9f8e37bda9ab8aace6669093c3bc849a75098d59f504759" title="Track number/Position in set.">ID3FID_TRACKNUM</a>)) <a name="l00503"></a>00503 { <a name="l00504"></a>00504 frame = <span class="keyword">new</span> <a class="code" href="class_i_d3___frame.html" title="The representative class of an id3v2 frame.">ID3_Frame</a>(<a class="code" href="globals_8h.html#a78f454bf66f16b1e1c9f8e37bda9ab8aace6669093c3bc849a75098d59f504759" title="Track number/Position in set.">ID3FID_TRACKNUM</a>); <a name="l00505"></a>00505 <span class="keywordflow">if</span> (frame) <a name="l00506"></a>00506 { <a name="l00507"></a>00507 <span class="keywordtype">char</span> *sTrack = <a class="code" href="globals_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a>; <a name="l00508"></a>00508 <span class="keywordflow">if</span> (0 == ttl) <a name="l00509"></a>00509 { <a name="l00510"></a>00510 sTrack = <span class="keyword">new</span> <span class="keywordtype">char</span>[4]; <a name="l00511"></a>00511 sprintf(sTrack, <span class="stringliteral">"%lu"</span>, (<a class="code" href="globals_8h.html#a31c81a77cfd373514f7878719897fca6">luint</a>) trk); <a name="l00512"></a>00512 } <a name="l00513"></a>00513 <span class="keywordflow">else</span> <a name="l00514"></a>00514 { <a name="l00515"></a>00515 sTrack = <span class="keyword">new</span> <span class="keywordtype">char</span>[8]; <a name="l00516"></a>00516 sprintf(sTrack, <span class="stringliteral">"%lu/%lu"</span>, (<a class="code" href="globals_8h.html#a31c81a77cfd373514f7878719897fca6">luint</a>) trk, (<a class="code" href="globals_8h.html#a31c81a77cfd373514f7878719897fca6">luint</a>) ttl); <a name="l00517"></a>00517 } <a name="l00518"></a>00518 <a name="l00519"></a>00519 frame-><a class="code" href="class_i_d3___frame.html#a6491b36aee70776ed656896daa42ef80">GetField</a>(<a class="code" href="globals_8h.html#a23cab982426a968437cd731900cfeb2cab4a3b9cafedc2cede90380c79edca044" title="Text field.">ID3FN_TEXT</a>)-><a class="code" href="class_i_d3___field.html#a16387cf6c54df5432a0c048d6a931f03">Set</a>(sTrack); <a name="l00520"></a>00520 tag-><a class="code" href="class_i_d3___tag.html#a8760bcb5321fc95ee0e91a2057b4eb9c" title="Attaches a frame to the tag; the tag takes responsibility for releasing the frame&#39;s memory when t...">AttachFrame</a>(frame); <a name="l00521"></a>00521 <a name="l00522"></a>00522 <span class="keyword">delete</span> [] sTrack; <a name="l00523"></a>00523 } <a name="l00524"></a>00524 } <a name="l00525"></a>00525 } <a name="l00526"></a>00526 <a name="l00527"></a>00527 <span class="keywordflow">return</span> frame; <a name="l00528"></a>00528 } <a name="l00529"></a>00529 <a name="l00530"></a>00530 <span class="comment">//following routine courtesy of John George</span> <a name="l00531"></a><a class="code" href="misc__support_8h.html#a8fa2b88f16356ccfd24ece3ca5915cef">00531</a> <span class="keywordtype">int</span> <a class="code" href="misc__support_8cpp.html#a3602b03159f0d34211c365491fa8a98a">ID3_GetPictureData</a>(<span class="keyword">const</span> <a class="code" href="class_i_d3___tag.html" title="The representative class of an id3 tag.">ID3_Tag</a> *tag, <span class="keyword">const</span> <span class="keywordtype">char</span> *TempPicPath) <a name="l00532"></a>00532 { <a name="l00533"></a>00533 <span class="keywordflow">if</span> (<a class="code" href="globals_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a> == tag) <a name="l00534"></a>00534 <span class="keywordflow">return</span> 0; <a name="l00535"></a>00535 <span class="keywordflow">else</span> <a name="l00536"></a>00536 { <a name="l00537"></a>00537 <a class="code" href="class_i_d3___frame.html" title="The representative class of an id3v2 frame.">ID3_Frame</a>* frame = <a class="code" href="globals_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a>; <a name="l00538"></a>00538 frame = tag-><a class="code" href="class_i_d3___tag.html#aad2a8e5a801bc09eac967d24ff3539c3" title="Finds frame with given frame id, fld id, and integer data.">Find</a>(<a class="code" href="globals_8h.html#a78f454bf66f16b1e1c9f8e37bda9ab8aacdd599f7b0f4a6081cf714a7232acf71" title="Attached picture.">ID3FID_PICTURE</a>); <a name="l00539"></a>00539 <span class="keywordflow">if</span> (frame != <a class="code" href="globals_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a>) <a name="l00540"></a>00540 { <a name="l00541"></a>00541 <a class="code" href="class_i_d3___field.html" title="The representative class of an ID3v2 field.">ID3_Field</a>* myField = frame-><a class="code" href="class_i_d3___frame.html#a6491b36aee70776ed656896daa42ef80">GetField</a>(<a class="code" href="globals_8h.html#a23cab982426a968437cd731900cfeb2cabd5e1e87686d7a1fc9ba291023e9ccc0" title="Data field.">ID3FN_DATA</a>); <a name="l00542"></a>00542 <span class="keywordflow">if</span> (myField != <a class="code" href="globals_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a>) <a name="l00543"></a>00543 { <a name="l00544"></a>00544 myField-><a class="code" href="class_i_d3___field.html#a589764a2865b094300b9cf1339d4dad5">ToFile</a>(TempPicPath); <a name="l00545"></a>00545 <span class="keywordflow">return</span> (<span class="keywordtype">int</span>)myField-><a class="code" href="class_i_d3___field.html#a4eed557e9f540d3c9347ac31f0f8e55b" title="Returns the size of a field.">Size</a>(); <a name="l00546"></a>00546 } <a name="l00547"></a>00547 <span class="keywordflow">else</span> <span class="keywordflow">return</span> 0; <a name="l00548"></a>00548 } <a name="l00549"></a>00549 <span class="keywordflow">else</span> <span class="keywordflow">return</span> 0; <a name="l00550"></a>00550 } <a name="l00551"></a>00551 } <a name="l00552"></a>00552 <a name="l00553"></a>00553 <span class="comment">//following routine courtesy of John George</span> <a name="l00554"></a><a class="code" href="misc__support_8h.html#a6ce86c8cd1631e510d700bf22b87869d">00554</a> <span class="keywordtype">char</span>* <a class="code" href="misc__support_8cpp.html#a79d1b8738f30dbdccaff8409fd24d943">ID3_GetPictureMimeType</a>(<span class="keyword">const</span> <a class="code" href="class_i_d3___tag.html" title="The representative class of an id3 tag.">ID3_Tag</a> *tag) <a name="l00555"></a>00555 { <a name="l00556"></a>00556 <span class="keywordtype">char</span>* sPicMimetype = <a class="code" href="globals_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a>; <a name="l00557"></a>00557 <span class="keywordflow">if</span> (<a class="code" href="globals_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a> == tag) <a name="l00558"></a>00558 <span class="keywordflow">return</span> sPicMimetype; <a name="l00559"></a>00559 <a name="l00560"></a>00560 <a class="code" href="class_i_d3___frame.html" title="The representative class of an id3v2 frame.">ID3_Frame</a>* frame = <a class="code" href="globals_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a>; <a name="l00561"></a>00561 frame = tag-><a class="code" href="class_i_d3___tag.html#aad2a8e5a801bc09eac967d24ff3539c3" title="Finds frame with given frame id, fld id, and integer data.">Find</a>(<a class="code" href="globals_8h.html#a78f454bf66f16b1e1c9f8e37bda9ab8aacdd599f7b0f4a6081cf714a7232acf71" title="Attached picture.">ID3FID_PICTURE</a>); <a name="l00562"></a>00562 <span class="keywordflow">if</span> (frame != <a class="code" href="globals_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a>) <a name="l00563"></a>00563 { <a name="l00564"></a>00564 sPicMimetype = <a class="code" href="misc__support_8cpp.html#aeb3ba3ba28ea24ffe6a6d8a5fce9f4ed">ID3_GetString</a>(frame, <a class="code" href="globals_8h.html#a23cab982426a968437cd731900cfeb2ca0500bcc349631be7bf2c67e1a0033169" title="Mimetype field.">ID3FN_MIMETYPE</a>); <a name="l00565"></a>00565 } <a name="l00566"></a>00566 <span class="keywordflow">return</span> sPicMimetype; <a name="l00567"></a>00567 } <a name="l00568"></a>00568 <a name="l00569"></a>00569 <span class="comment">//following routine courtesy of John George</span> <a name="l00570"></a><a class="code" href="misc__support_8h.html#ab80a689780357c29715c6fdcf005e7ba">00570</a> <span class="keywordtype">bool</span> <a class="code" href="misc__support_8cpp.html#a3f9abcf99d3941a0589801d6e4409ea0">ID3_HasPicture</a>(<span class="keyword">const</span> <a class="code" href="class_i_d3___tag.html" title="The representative class of an id3 tag.">ID3_Tag</a>* tag) <a name="l00571"></a>00571 { <a name="l00572"></a>00572 <span class="keywordflow">if</span> (<a class="code" href="globals_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a> == tag) <a name="l00573"></a>00573 <span class="keywordflow">return</span> <span class="keyword">false</span>; <a name="l00574"></a>00574 <span class="keywordflow">else</span> <a name="l00575"></a>00575 { <a name="l00576"></a>00576 <a class="code" href="class_i_d3___frame.html" title="The representative class of an id3v2 frame.">ID3_Frame</a>* frame = tag-><a class="code" href="class_i_d3___tag.html#aad2a8e5a801bc09eac967d24ff3539c3" title="Finds frame with given frame id, fld id, and integer data.">Find</a>(<a class="code" href="globals_8h.html#a78f454bf66f16b1e1c9f8e37bda9ab8aacdd599f7b0f4a6081cf714a7232acf71" title="Attached picture.">ID3FID_PICTURE</a>); <a name="l00577"></a>00577 <span class="keywordflow">if</span> (frame != <a class="code" href="globals_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a>) <a name="l00578"></a>00578 { <a name="l00579"></a>00579 <a class="code" href="class_i_d3___field.html" title="The representative class of an ID3v2 field.">ID3_Field</a>* myField = frame-><a class="code" href="class_i_d3___frame.html#a6491b36aee70776ed656896daa42ef80">GetField</a>(<a class="code" href="globals_8h.html#a23cab982426a968437cd731900cfeb2cabd5e1e87686d7a1fc9ba291023e9ccc0" title="Data field.">ID3FN_DATA</a>); <a name="l00580"></a>00580 <span class="keywordflow">if</span> (myField != <a class="code" href="globals_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a>) <a name="l00581"></a>00581 <span class="keywordflow">return</span> <span class="keyword">true</span>; <a name="l00582"></a>00582 <span class="keywordflow">else</span> <a name="l00583"></a>00583 <span class="keywordflow">return</span> <span class="keyword">false</span>; <a name="l00584"></a>00584 } <a name="l00585"></a>00585 <span class="keywordflow">else</span> <span class="keywordflow">return</span> <span class="keyword">false</span>; <a name="l00586"></a>00586 } <a name="l00587"></a>00587 } <a name="l00588"></a>00588 <a name="l00589"></a>00589 <span class="comment">//following routine courtesy of John George</span> <a name="l00590"></a><a class="code" href="misc__support_8h.html#affd60942b5735320faef05ccb4ea6d0c">00590</a> <a class="code" href="class_i_d3___frame.html" title="The representative class of an id3v2 frame.">ID3_Frame</a>* <a class="code" href="misc__support_8cpp.html#a7ce92d5ee38a75a5b95faabf3cbf0f65">ID3_AddPicture</a>(<a class="code" href="class_i_d3___tag.html" title="The representative class of an id3 tag.">ID3_Tag</a>* tag, <span class="keyword">const</span> <span class="keywordtype">char</span>* TempPicPath, <span class="keyword">const</span> <span class="keywordtype">char</span>* MimeType, <span class="keywordtype">bool</span> replace) <a name="l00591"></a>00591 { <a name="l00592"></a>00592 <a class="code" href="class_i_d3___frame.html" title="The representative class of an id3v2 frame.">ID3_Frame</a>* frame = <a class="code" href="globals_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a>; <a name="l00593"></a>00593 <span class="keywordflow">if</span> (<a class="code" href="globals_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a> != tag ) <a name="l00594"></a>00594 { <a name="l00595"></a>00595 <span class="keywordflow">if</span> (replace) <a name="l00596"></a>00596 <a class="code" href="misc__support_8cpp.html#a06a7afccb875e0869142771abe02591b">ID3_RemovePictures</a>(tag); <a name="l00597"></a>00597 <span class="keywordflow">if</span> (replace || <a class="code" href="globals_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a> == tag-><a class="code" href="class_i_d3___tag.html#aad2a8e5a801bc09eac967d24ff3539c3" title="Finds frame with given frame id, fld id, and integer data.">Find</a>(<a class="code" href="globals_8h.html#a78f454bf66f16b1e1c9f8e37bda9ab8aacdd599f7b0f4a6081cf714a7232acf71" title="Attached picture.">ID3FID_PICTURE</a>)) <a name="l00598"></a>00598 { <a name="l00599"></a>00599 frame = <span class="keyword">new</span> <a class="code" href="class_i_d3___frame.html" title="The representative class of an id3v2 frame.">ID3_Frame</a>(<a class="code" href="globals_8h.html#a78f454bf66f16b1e1c9f8e37bda9ab8aacdd599f7b0f4a6081cf714a7232acf71" title="Attached picture.">ID3FID_PICTURE</a>); <a name="l00600"></a>00600 <span class="keywordflow">if</span> (<a class="code" href="globals_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a> != frame) <a name="l00601"></a>00601 { <a name="l00602"></a>00602 frame-><a class="code" href="class_i_d3___frame.html#a6491b36aee70776ed656896daa42ef80">GetField</a>(<a class="code" href="globals_8h.html#a23cab982426a968437cd731900cfeb2cabd5e1e87686d7a1fc9ba291023e9ccc0" title="Data field.">ID3FN_DATA</a>)-><a class="code" href="class_i_d3___field.html#a61d35ba1108517376632e06db6a9e02a">FromFile</a>(TempPicPath); <a name="l00603"></a>00603 frame-><a class="code" href="class_i_d3___frame.html#a6491b36aee70776ed656896daa42ef80">GetField</a>(<a class="code" href="globals_8h.html#a23cab982426a968437cd731900cfeb2ca0500bcc349631be7bf2c67e1a0033169" title="Mimetype field.">ID3FN_MIMETYPE</a>)-><a class="code" href="class_i_d3___field.html#a16387cf6c54df5432a0c048d6a931f03">Set</a>(MimeType); <a name="l00604"></a>00604 tag-><a class="code" href="class_i_d3___tag.html#a8760bcb5321fc95ee0e91a2057b4eb9c" title="Attaches a frame to the tag; the tag takes responsibility for releasing the frame&#39;s memory when t...">AttachFrame</a>(frame); <a name="l00605"></a>00605 } <a name="l00606"></a>00606 } <a name="l00607"></a>00607 } <a name="l00608"></a>00608 <span class="keywordflow">return</span> frame; <a name="l00609"></a>00609 } <a name="l00610"></a>00610 <a name="l00611"></a>00611 <span class="comment">//following routine courtesy of John George</span> <a name="l00612"></a><a class="code" href="misc__support_8h.html#aa2962c48d6944c9241f743397f4fc5bc">00612</a> <span class="keywordtype">size_t</span> <a class="code" href="misc__support_8cpp.html#a06a7afccb875e0869142771abe02591b">ID3_RemovePictures</a>(<a class="code" href="class_i_d3___tag.html" title="The representative class of an id3 tag.">ID3_Tag</a>* tag) <a name="l00613"></a>00613 { <a name="l00614"></a>00614 <span class="keywordtype">size_t</span> num_removed = 0; <a name="l00615"></a>00615 <a class="code" href="class_i_d3___frame.html" title="The representative class of an id3v2 frame.">ID3_Frame</a>* frame = <a class="code" href="globals_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a>; <a name="l00616"></a>00616 <a name="l00617"></a>00617 <span class="keywordflow">if</span> (<a class="code" href="globals_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a> == tag) <a name="l00618"></a>00618 <span class="keywordflow">return</span> num_removed; <a name="l00619"></a>00619 <a name="l00620"></a>00620 <span class="keywordflow">while</span> ((frame = tag-><a class="code" href="class_i_d3___tag.html#aad2a8e5a801bc09eac967d24ff3539c3" title="Finds frame with given frame id, fld id, and integer data.">Find</a>(<a class="code" href="globals_8h.html#a78f454bf66f16b1e1c9f8e37bda9ab8aacdd599f7b0f4a6081cf714a7232acf71" title="Attached picture.">ID3FID_PICTURE</a>))) <a name="l00621"></a>00621 { <a name="l00622"></a>00622 frame = tag-><a class="code" href="class_i_d3___tag.html#ae21522e16cb899c5cd1c42d8f7fdfad9" title="Removes a frame from the tag.">RemoveFrame</a>(frame); <a name="l00623"></a>00623 <span class="keyword">delete</span> frame; <a name="l00624"></a>00624 num_removed++; <a name="l00625"></a>00625 } <a name="l00626"></a>00626 <span class="keywordflow">return</span> num_removed; <a name="l00627"></a>00627 } <a name="l00628"></a>00628 <a name="l00629"></a>00629 <span class="comment">//following routine courtesy of John George</span> <a name="l00630"></a><a class="code" href="misc__support_8h.html#ab02bd1f7bd3353fe024420e1dcdb53c0">00630</a> <span class="keywordtype">size_t</span> <a class="code" href="misc__support_8cpp.html#ae58b6d1d764a6e6c0ab416e72b070fc9">ID3_RemovePictureType</a>(<a class="code" href="class_i_d3___tag.html" title="The representative class of an id3 tag.">ID3_Tag</a>* tag, <a class="code" href="globals_8h.html#af36c01091a4fe9dda85801c064d4193e">ID3_PictureType</a> pictype) <a name="l00631"></a>00631 { <a name="l00632"></a>00632 <span class="keywordtype">size_t</span> bremoved = 0; <a name="l00633"></a>00633 <a class="code" href="class_i_d3___frame.html" title="The representative class of an id3v2 frame.">ID3_Frame</a>* frame = <a class="code" href="globals_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a>; <a name="l00634"></a>00634 <a name="l00635"></a>00635 <span class="keywordflow">if</span> (<a class="code" href="globals_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a> == tag) <a name="l00636"></a>00636 <span class="keywordflow">return</span> bremoved; <a name="l00637"></a>00637 <a name="l00638"></a>00638 <a class="code" href="class_i_d3___tag_1_1_iterator.html">ID3_Tag::Iterator</a>* iter = tag-><a class="code" href="class_i_d3___tag.html#ad63ed5e405467892b3d4413b185c43ba">CreateIterator</a>(); <a name="l00639"></a>00639 <a name="l00640"></a>00640 <span class="keywordflow">while</span> (<a class="code" href="globals_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a> != (frame = iter-><a class="code" href="class_i_d3___tag_1_1_iterator.html#ace2ed8451590035990151741432d89df">GetNext</a>())) <a name="l00641"></a>00641 { <a name="l00642"></a>00642 <span class="keywordflow">if</span> (frame-><a class="code" href="class_i_d3___frame.html#a93e8ff233deb9634f5990e4fb4c1b908" title="Returns the type of frame that the object represents.">GetID</a>() == <a class="code" href="globals_8h.html#a78f454bf66f16b1e1c9f8e37bda9ab8aacdd599f7b0f4a6081cf714a7232acf71" title="Attached picture.">ID3FID_PICTURE</a>) <a name="l00643"></a>00643 { <a name="l00644"></a>00644 <span class="keywordflow">if</span> (frame-><a class="code" href="class_i_d3___frame.html#a6491b36aee70776ed656896daa42ef80">GetField</a>(<a class="code" href="globals_8h.html#a23cab982426a968437cd731900cfeb2cacf3efb9534c1200db2f003f5837bb1ad" title="Picture type field.">ID3FN_PICTURETYPE</a>)-><a class="code" href="class_i_d3___field.html#a363d1034fb4e60e85f15bcf9818d33ef" title="Returns the value of the integer field.">Get</a>() == (uint32)pictype) <a name="l00645"></a>00645 <span class="keywordflow">break</span>; <a name="l00646"></a>00646 } <a name="l00647"></a>00647 } <a name="l00648"></a>00648 <span class="keyword">delete</span> iter; <a name="l00649"></a>00649 <a name="l00650"></a>00650 <span class="keywordflow">if</span> (<a class="code" href="globals_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a> != frame) <a name="l00651"></a>00651 { <a name="l00652"></a>00652 frame = tag-><a class="code" href="class_i_d3___tag.html#ae21522e16cb899c5cd1c42d8f7fdfad9" title="Removes a frame from the tag.">RemoveFrame</a>(frame); <a name="l00653"></a>00653 <span class="keyword">delete</span> frame; <a name="l00654"></a>00654 bremoved = 1; <a name="l00655"></a>00655 } <a name="l00656"></a>00656 <span class="keywordflow">return</span> bremoved; <a name="l00657"></a>00657 } <a name="l00658"></a>00658 <a name="l00659"></a>00659 <span class="comment">//following routine courtesy of John George</span> <a name="l00660"></a><a class="code" href="misc__support_8h.html#a46cb3fc2498d8e40894c55843493eac3">00660</a> <a class="code" href="class_i_d3___frame.html" title="The representative class of an id3v2 frame.">ID3_Frame</a>* <a class="code" href="misc__support_8cpp.html#a7ce92d5ee38a75a5b95faabf3cbf0f65">ID3_AddPicture</a>(<a class="code" href="class_i_d3___tag.html" title="The representative class of an id3 tag.">ID3_Tag</a> *tag, <span class="keyword">const</span> <span class="keywordtype">char</span> *TempPicPath, <span class="keyword">const</span> <span class="keywordtype">char</span> *MimeType, <a class="code" href="globals_8h.html#af36c01091a4fe9dda85801c064d4193e">ID3_PictureType</a> pictype, <span class="keyword">const</span> <span class="keywordtype">char</span>* Description, <span class="keywordtype">bool</span> replace) <a name="l00661"></a>00661 { <a name="l00662"></a>00662 <a class="code" href="class_i_d3___frame.html" title="The representative class of an id3v2 frame.">ID3_Frame</a>* frame = <a class="code" href="globals_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a>; <a name="l00663"></a>00663 <span class="keywordflow">if</span> (<a class="code" href="globals_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a> != tag ) <a name="l00664"></a>00664 { <a name="l00665"></a>00665 <span class="keywordflow">if</span> (replace) <a name="l00666"></a>00666 <a class="code" href="misc__support_8cpp.html#ae58b6d1d764a6e6c0ab416e72b070fc9">ID3_RemovePictureType</a>(tag, pictype); <a name="l00667"></a>00667 <span class="keywordflow">if</span> (replace || <a class="code" href="globals_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a> == tag-><a class="code" href="class_i_d3___tag.html#aad2a8e5a801bc09eac967d24ff3539c3" title="Finds frame with given frame id, fld id, and integer data.">Find</a>(<a class="code" href="globals_8h.html#a78f454bf66f16b1e1c9f8e37bda9ab8aacdd599f7b0f4a6081cf714a7232acf71" title="Attached picture.">ID3FID_PICTURE</a>)) <a name="l00668"></a>00668 { <a name="l00669"></a>00669 frame = <span class="keyword">new</span> <a class="code" href="class_i_d3___frame.html" title="The representative class of an id3v2 frame.">ID3_Frame</a>(<a class="code" href="globals_8h.html#a78f454bf66f16b1e1c9f8e37bda9ab8aacdd599f7b0f4a6081cf714a7232acf71" title="Attached picture.">ID3FID_PICTURE</a>); <a name="l00670"></a>00670 <span class="keywordflow">if</span> (<a class="code" href="globals_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a> != frame) <a name="l00671"></a>00671 { <a name="l00672"></a>00672 frame-><a class="code" href="class_i_d3___frame.html#a6491b36aee70776ed656896daa42ef80">GetField</a>(<a class="code" href="globals_8h.html#a23cab982426a968437cd731900cfeb2cabd5e1e87686d7a1fc9ba291023e9ccc0" title="Data field.">ID3FN_DATA</a>)-><a class="code" href="class_i_d3___field.html#a61d35ba1108517376632e06db6a9e02a">FromFile</a>(TempPicPath); <a name="l00673"></a>00673 frame-><a class="code" href="class_i_d3___frame.html#a6491b36aee70776ed656896daa42ef80">GetField</a>(<a class="code" href="globals_8h.html#a23cab982426a968437cd731900cfeb2ca0500bcc349631be7bf2c67e1a0033169" title="Mimetype field.">ID3FN_MIMETYPE</a>)-><a class="code" href="class_i_d3___field.html#a16387cf6c54df5432a0c048d6a931f03">Set</a>(MimeType); <a name="l00674"></a>00674 frame-><a class="code" href="class_i_d3___frame.html#a6491b36aee70776ed656896daa42ef80">GetField</a>(<a class="code" href="globals_8h.html#a23cab982426a968437cd731900cfeb2cacf3efb9534c1200db2f003f5837bb1ad" title="Picture type field.">ID3FN_PICTURETYPE</a>)-><a class="code" href="class_i_d3___field.html#a16387cf6c54df5432a0c048d6a931f03">Set</a>((uint32)pictype); <a name="l00675"></a>00675 frame-><a class="code" href="class_i_d3___frame.html#a6491b36aee70776ed656896daa42ef80">GetField</a>(<a class="code" href="globals_8h.html#a23cab982426a968437cd731900cfeb2ca6898b894ce725eb89b42dc6f4f9117e5" title="Description field.">ID3FN_DESCRIPTION</a>)-><a class="code" href="class_i_d3___field.html#a16387cf6c54df5432a0c048d6a931f03">Set</a>(Description); <a name="l00676"></a>00676 tag-><a class="code" href="class_i_d3___tag.html#a8760bcb5321fc95ee0e91a2057b4eb9c" title="Attaches a frame to the tag; the tag takes responsibility for releasing the frame&#39;s memory when t...">AttachFrame</a>(frame); <a name="l00677"></a>00677 } <a name="l00678"></a>00678 } <a name="l00679"></a>00679 } <a name="l00680"></a>00680 <span class="keywordflow">return</span> frame; <a name="l00681"></a>00681 } <a name="l00682"></a>00682 <a name="l00683"></a>00683 <span class="comment">//following routine courtesy of John George</span> <a name="l00684"></a><a class="code" href="misc__support_8h.html#aaa2ac13b2040e6490cf6ea819ab488b7">00684</a> <span class="keywordtype">size_t</span> <a class="code" href="misc__support_8cpp.html#a6595dc5aeb97675d72264b24cc19c5b0">ID3_GetPictureDataOfPicType</a>(<a class="code" href="class_i_d3___tag.html" title="The representative class of an id3 tag.">ID3_Tag</a>* tag, <span class="keyword">const</span> <span class="keywordtype">char</span>* TempPicPath, <a class="code" href="globals_8h.html#af36c01091a4fe9dda85801c064d4193e">ID3_PictureType</a> pictype) <a name="l00685"></a>00685 { <a name="l00686"></a>00686 <span class="keywordflow">if</span> (<a class="code" href="globals_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a> == tag) <a name="l00687"></a>00687 <span class="keywordflow">return</span> 0; <a name="l00688"></a>00688 <span class="keywordflow">else</span> <a name="l00689"></a>00689 { <a name="l00690"></a>00690 <a class="code" href="class_i_d3___frame.html" title="The representative class of an id3v2 frame.">ID3_Frame</a>* frame = <a class="code" href="globals_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a>; <a name="l00691"></a>00691 <a class="code" href="class_i_d3___tag_1_1_iterator.html">ID3_Tag::Iterator</a>* iter = tag-><a class="code" href="class_i_d3___tag.html#ad63ed5e405467892b3d4413b185c43ba">CreateIterator</a>(); <a name="l00692"></a>00692 <a name="l00693"></a>00693 <span class="keywordflow">while</span> (<a class="code" href="globals_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a> != (frame = iter-><a class="code" href="class_i_d3___tag_1_1_iterator.html#ace2ed8451590035990151741432d89df">GetNext</a>() )) <a name="l00694"></a>00694 { <a name="l00695"></a>00695 <span class="keywordflow">if</span>(frame-><a class="code" href="class_i_d3___frame.html#a93e8ff233deb9634f5990e4fb4c1b908" title="Returns the type of frame that the object represents.">GetID</a>() == <a class="code" href="globals_8h.html#a78f454bf66f16b1e1c9f8e37bda9ab8aacdd599f7b0f4a6081cf714a7232acf71" title="Attached picture.">ID3FID_PICTURE</a>) <a name="l00696"></a>00696 { <a name="l00697"></a>00697 <span class="keywordflow">if</span>(frame-><a class="code" href="class_i_d3___frame.html#a6491b36aee70776ed656896daa42ef80">GetField</a>(<a class="code" href="globals_8h.html#a23cab982426a968437cd731900cfeb2cacf3efb9534c1200db2f003f5837bb1ad" title="Picture type field.">ID3FN_PICTURETYPE</a>)-><a class="code" href="class_i_d3___field.html#a363d1034fb4e60e85f15bcf9818d33ef" title="Returns the value of the integer field.">Get</a>() == (uint32)pictype) <a name="l00698"></a>00698 <span class="keywordflow">break</span>; <a name="l00699"></a>00699 } <a name="l00700"></a>00700 } <a name="l00701"></a>00701 <span class="keyword">delete</span> iter; <a name="l00702"></a>00702 <a name="l00703"></a>00703 <span class="keywordflow">if</span> (frame != <a class="code" href="globals_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a>) <a name="l00704"></a>00704 { <a name="l00705"></a>00705 <a class="code" href="class_i_d3___field.html" title="The representative class of an ID3v2 field.">ID3_Field</a>* myField = frame-><a class="code" href="class_i_d3___frame.html#a6491b36aee70776ed656896daa42ef80">GetField</a>(<a class="code" href="globals_8h.html#a23cab982426a968437cd731900cfeb2cabd5e1e87686d7a1fc9ba291023e9ccc0" title="Data field.">ID3FN_DATA</a>); <a name="l00706"></a>00706 <span class="keywordflow">if</span> (myField != <a class="code" href="globals_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a>) <a name="l00707"></a>00707 { <a name="l00708"></a>00708 myField-><a class="code" href="class_i_d3___field.html#a589764a2865b094300b9cf1339d4dad5">ToFile</a>(TempPicPath); <a name="l00709"></a>00709 <span class="keywordflow">return</span> (<span class="keywordtype">size_t</span>)myField-><a class="code" href="class_i_d3___field.html#a4eed557e9f540d3c9347ac31f0f8e55b" title="Returns the size of a field.">Size</a>(); <a name="l00710"></a>00710 } <a name="l00711"></a>00711 <span class="keywordflow">else</span> <span class="keywordflow">return</span> 0; <a name="l00712"></a>00712 } <a name="l00713"></a>00713 <span class="keywordflow">else</span> <span class="keywordflow">return</span> 0; <a name="l00714"></a>00714 } <a name="l00715"></a>00715 } <a name="l00716"></a>00716 <a name="l00717"></a>00717 <span class="comment">//following routine courtesy of John George</span> <a name="l00718"></a><a class="code" href="misc__support_8h.html#aa982a7debb0e005f29541f7a923229b9">00718</a> <span class="keywordtype">char</span>* <a class="code" href="misc__support_8cpp.html#a0e32b7dd9155634f5f3d33c044c2a430">ID3_GetMimeTypeOfPicType</a>(<a class="code" href="class_i_d3___tag.html" title="The representative class of an id3 tag.">ID3_Tag</a>* tag, <a class="code" href="globals_8h.html#af36c01091a4fe9dda85801c064d4193e">ID3_PictureType</a> pictype) <a name="l00719"></a>00719 { <a name="l00720"></a>00720 <span class="keywordtype">char</span>* sPicMimetype = <a class="code" href="globals_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a>; <a name="l00721"></a>00721 <span class="keywordflow">if</span> (<a class="code" href="globals_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a> == tag) <a name="l00722"></a>00722 <span class="keywordflow">return</span> sPicMimetype; <a name="l00723"></a>00723 <a name="l00724"></a>00724 <a class="code" href="class_i_d3___frame.html" title="The representative class of an id3v2 frame.">ID3_Frame</a>* frame = <a class="code" href="globals_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a>; <a name="l00725"></a>00725 <a class="code" href="class_i_d3___tag_1_1_iterator.html">ID3_Tag::Iterator</a>* iter = tag-><a class="code" href="class_i_d3___tag.html#ad63ed5e405467892b3d4413b185c43ba">CreateIterator</a>(); <a name="l00726"></a>00726 <a name="l00727"></a>00727 <span class="keywordflow">while</span> (<a class="code" href="globals_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a> != (frame = iter-><a class="code" href="class_i_d3___tag_1_1_iterator.html#ace2ed8451590035990151741432d89df">GetNext</a>())) <a name="l00728"></a>00728 { <a name="l00729"></a>00729 <span class="keywordflow">if</span>(frame-><a class="code" href="class_i_d3___frame.html#a93e8ff233deb9634f5990e4fb4c1b908" title="Returns the type of frame that the object represents.">GetID</a>() == <a class="code" href="globals_8h.html#a78f454bf66f16b1e1c9f8e37bda9ab8aacdd599f7b0f4a6081cf714a7232acf71" title="Attached picture.">ID3FID_PICTURE</a>) <a name="l00730"></a>00730 { <a name="l00731"></a>00731 <span class="keywordflow">if</span>(frame-><a class="code" href="class_i_d3___frame.html#a6491b36aee70776ed656896daa42ef80">GetField</a>(<a class="code" href="globals_8h.html#a23cab982426a968437cd731900cfeb2cacf3efb9534c1200db2f003f5837bb1ad" title="Picture type field.">ID3FN_PICTURETYPE</a>)-><a class="code" href="class_i_d3___field.html#a363d1034fb4e60e85f15bcf9818d33ef" title="Returns the value of the integer field.">Get</a>() == (uint32)pictype) <a name="l00732"></a>00732 <span class="keywordflow">break</span>; <a name="l00733"></a>00733 } <a name="l00734"></a>00734 } <a name="l00735"></a>00735 <span class="keyword">delete</span> iter; <a name="l00736"></a>00736 <a name="l00737"></a>00737 <span class="keywordflow">if</span> (frame != <a class="code" href="globals_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a>) <a name="l00738"></a>00738 { <a name="l00739"></a>00739 sPicMimetype = <a class="code" href="misc__support_8cpp.html#aeb3ba3ba28ea24ffe6a6d8a5fce9f4ed">ID3_GetString</a>(frame, <a class="code" href="globals_8h.html#a23cab982426a968437cd731900cfeb2ca0500bcc349631be7bf2c67e1a0033169" title="Mimetype field.">ID3FN_MIMETYPE</a>); <a name="l00740"></a>00740 } <a name="l00741"></a>00741 <span class="keywordflow">return</span> sPicMimetype; <a name="l00742"></a>00742 } <a name="l00743"></a>00743 <a name="l00744"></a>00744 <span class="comment">//following routine courtesy of John George</span> <a name="l00745"></a><a class="code" href="misc__support_8h.html#ac063b79b8c7b63b2104ddd5b4187afbf">00745</a> <span class="keywordtype">char</span>* <a class="code" href="misc__support_8cpp.html#aa31652518581fc0f2517207ff6701ef8">ID3_GetDescriptionOfPicType</a>(<a class="code" href="class_i_d3___tag.html" title="The representative class of an id3 tag.">ID3_Tag</a>* tag, <a class="code" href="globals_8h.html#af36c01091a4fe9dda85801c064d4193e">ID3_PictureType</a> pictype) <a name="l00746"></a>00746 { <a name="l00747"></a>00747 <span class="keywordtype">char</span>* sPicDescription = <a class="code" href="globals_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a>; <a name="l00748"></a>00748 <span class="keywordflow">if</span> (<a class="code" href="globals_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a> == tag) <a name="l00749"></a>00749 <span class="keywordflow">return</span> sPicDescription; <a name="l00750"></a>00750 <a name="l00751"></a>00751 <a class="code" href="class_i_d3___frame.html" title="The representative class of an id3v2 frame.">ID3_Frame</a>* frame = <a class="code" href="globals_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a>; <a name="l00752"></a>00752 <a class="code" href="class_i_d3___tag_1_1_iterator.html">ID3_Tag::Iterator</a>* iter = tag-><a class="code" href="class_i_d3___tag.html#ad63ed5e405467892b3d4413b185c43ba">CreateIterator</a>(); <a name="l00753"></a>00753 <a name="l00754"></a>00754 <span class="keywordflow">while</span> (<a class="code" href="globals_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a> != (frame = iter-><a class="code" href="class_i_d3___tag_1_1_iterator.html#ace2ed8451590035990151741432d89df">GetNext</a>())) <a name="l00755"></a>00755 { <a name="l00756"></a>00756 <span class="keywordflow">if</span>(frame-><a class="code" href="class_i_d3___frame.html#a93e8ff233deb9634f5990e4fb4c1b908" title="Returns the type of frame that the object represents.">GetID</a>() == <a class="code" href="globals_8h.html#a78f454bf66f16b1e1c9f8e37bda9ab8aacdd599f7b0f4a6081cf714a7232acf71" title="Attached picture.">ID3FID_PICTURE</a>) <a name="l00757"></a>00757 { <a name="l00758"></a>00758 <span class="keywordflow">if</span>(frame-><a class="code" href="class_i_d3___frame.html#a6491b36aee70776ed656896daa42ef80">GetField</a>(<a class="code" href="globals_8h.html#a23cab982426a968437cd731900cfeb2cacf3efb9534c1200db2f003f5837bb1ad" title="Picture type field.">ID3FN_PICTURETYPE</a>)-><a class="code" href="class_i_d3___field.html#a363d1034fb4e60e85f15bcf9818d33ef" title="Returns the value of the integer field.">Get</a>() == (uint32)pictype) <a name="l00759"></a>00759 <span class="keywordflow">break</span>; <a name="l00760"></a>00760 } <a name="l00761"></a>00761 } <a name="l00762"></a>00762 <span class="keyword">delete</span> iter; <a name="l00763"></a>00763 <a name="l00764"></a>00764 <span class="keywordflow">if</span> (frame != <a class="code" href="globals_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a>) <a name="l00765"></a>00765 { <a name="l00766"></a>00766 sPicDescription = <a class="code" href="misc__support_8cpp.html#aeb3ba3ba28ea24ffe6a6d8a5fce9f4ed">ID3_GetString</a>(frame, <a class="code" href="globals_8h.html#a23cab982426a968437cd731900cfeb2ca6898b894ce725eb89b42dc6f4f9117e5" title="Description field.">ID3FN_DESCRIPTION</a>); <a name="l00767"></a>00767 } <a name="l00768"></a>00768 <span class="keywordflow">return</span> sPicDescription; <a name="l00769"></a>00769 } <a name="l00770"></a>00770 <a name="l00771"></a>00771 <a name="l00772"></a><a class="code" href="misc__support_8h.html#aeccd9ebbc0a21dfc9006f93d3f0ea629">00772</a> <span class="keywordtype">size_t</span> <a class="code" href="misc__support_8cpp.html#adb7de5e4dce14b935e672bf2da7ac798">ID3_RemoveTracks</a>(<a class="code" href="class_i_d3___tag.html" title="The representative class of an id3 tag.">ID3_Tag</a>* tag) <a name="l00773"></a>00773 { <a name="l00774"></a>00774 <span class="keywordtype">size_t</span> num_removed = 0; <a name="l00775"></a>00775 <a class="code" href="class_i_d3___frame.html" title="The representative class of an id3v2 frame.">ID3_Frame</a>* frame = <a class="code" href="globals_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a>; <a name="l00776"></a>00776 <a name="l00777"></a>00777 <span class="keywordflow">if</span> (<a class="code" href="globals_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a> == tag) <a name="l00778"></a>00778 { <a name="l00779"></a>00779 <span class="keywordflow">return</span> num_removed; <a name="l00780"></a>00780 } <a name="l00781"></a>00781 <a name="l00782"></a>00782 <span class="keywordflow">while</span> ((frame = tag-><a class="code" href="class_i_d3___tag.html#aad2a8e5a801bc09eac967d24ff3539c3" title="Finds frame with given frame id, fld id, and integer data.">Find</a>(<a class="code" href="globals_8h.html#a78f454bf66f16b1e1c9f8e37bda9ab8aace6669093c3bc849a75098d59f504759" title="Track number/Position in set.">ID3FID_TRACKNUM</a>))) <a name="l00783"></a>00783 { <a name="l00784"></a>00784 frame = tag-><a class="code" href="class_i_d3___tag.html#ae21522e16cb899c5cd1c42d8f7fdfad9" title="Removes a frame from the tag.">RemoveFrame</a>(frame); <a name="l00785"></a>00785 <span class="keyword">delete</span> frame; <a name="l00786"></a>00786 num_removed++; <a name="l00787"></a>00787 } <a name="l00788"></a>00788 <a name="l00789"></a>00789 <span class="keywordflow">return</span> num_removed; <a name="l00790"></a>00790 } <a name="l00791"></a>00791 <a name="l00792"></a><a class="code" href="misc__support_8h.html#ab009b6268f09da45cd90724361151a77">00792</a> <span class="keywordtype">char</span> *<a class="code" href="misc__support_8cpp.html#afea042a950dd43ad87ee061aabb82f62">ID3_GetGenre</a>(<span class="keyword">const</span> <a class="code" href="class_i_d3___tag.html" title="The representative class of an id3 tag.">ID3_Tag</a> *tag) <a name="l00793"></a>00793 { <a name="l00794"></a>00794 <span class="keywordtype">char</span> *sGenre = <a class="code" href="globals_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a>; <a name="l00795"></a>00795 <span class="keywordflow">if</span> (<a class="code" href="globals_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a> == tag) <a name="l00796"></a>00796 { <a name="l00797"></a>00797 <span class="keywordflow">return</span> sGenre; <a name="l00798"></a>00798 } <a name="l00799"></a>00799 <a name="l00800"></a>00800 <a class="code" href="class_i_d3___frame.html" title="The representative class of an id3v2 frame.">ID3_Frame</a> *frame = tag-><a class="code" href="class_i_d3___tag.html#aad2a8e5a801bc09eac967d24ff3539c3" title="Finds frame with given frame id, fld id, and integer data.">Find</a>(<a class="code" href="globals_8h.html#a78f454bf66f16b1e1c9f8e37bda9ab8aa040eba7064ed2c884233113486dbdd54" title="Content type.">ID3FID_CONTENTTYPE</a>); <a name="l00801"></a>00801 <span class="keywordflow">if</span> (frame != <a class="code" href="globals_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a>) <a name="l00802"></a>00802 { <a name="l00803"></a>00803 sGenre = <a class="code" href="misc__support_8cpp.html#aeb3ba3ba28ea24ffe6a6d8a5fce9f4ed">ID3_GetString</a>(frame, <a class="code" href="globals_8h.html#a23cab982426a968437cd731900cfeb2cab4a3b9cafedc2cede90380c79edca044" title="Text field.">ID3FN_TEXT</a>); <a name="l00804"></a>00804 } <a name="l00805"></a>00805 <a name="l00806"></a>00806 <span class="keywordflow">return</span> sGenre; <a name="l00807"></a>00807 } <a name="l00808"></a>00808 <a name="l00809"></a><a class="code" href="misc__support_8h.html#ad697688ffe2ac1278c57e7725c6efdaf">00809</a> <span class="keywordtype">size_t</span> <a class="code" href="misc__support_8cpp.html#a0407d7bac5285372213da801cfae70bc">ID3_GetGenreNum</a>(<span class="keyword">const</span> <a class="code" href="class_i_d3___tag.html" title="The representative class of an id3 tag.">ID3_Tag</a> *tag) <a name="l00810"></a>00810 { <a name="l00811"></a>00811 <span class="keywordtype">char</span> *sGenre = <a class="code" href="misc__support_8cpp.html#afea042a950dd43ad87ee061aabb82f62">ID3_GetGenre</a>(tag); <a name="l00812"></a>00812 <span class="keywordtype">size_t</span> ulGenre = 0xFF; <a name="l00813"></a>00813 <span class="keywordflow">if</span> (<a class="code" href="globals_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a> == sGenre) <a name="l00814"></a>00814 { <a name="l00815"></a>00815 <span class="keywordflow">return</span> ulGenre; <a name="l00816"></a>00816 } <a name="l00817"></a>00817 <a name="l00818"></a>00818 <span class="comment">// If the genre string begins with "(ddd)", where "ddd" is a number, then</span> <a name="l00819"></a>00819 <span class="comment">// "ddd" is the genre number---get it</span> <a name="l00820"></a>00820 <span class="keywordflow">if</span> (sGenre[0] == <span class="charliteral">'('</span>) <a name="l00821"></a>00821 { <a name="l00822"></a>00822 <span class="keywordtype">char</span> *pCur = &sGenre[1]; <a name="l00823"></a>00823 <span class="keywordflow">while</span> (isdigit(*pCur)) <a name="l00824"></a>00824 { <a name="l00825"></a>00825 pCur++; <a name="l00826"></a>00826 } <a name="l00827"></a>00827 <span class="keywordflow">if</span> (*pCur == <span class="charliteral">')'</span>) <a name="l00828"></a>00828 { <a name="l00829"></a>00829 <span class="comment">// if the genre number is greater than 255, its invalid.</span> <a name="l00830"></a>00830 ulGenre = dami::min(0xFF, atoi(&sGenre[1])); <a name="l00831"></a>00831 } <a name="l00832"></a>00832 } <a name="l00833"></a>00833 <a name="l00834"></a>00834 <span class="keyword">delete</span> [] sGenre; <a name="l00835"></a>00835 <span class="keywordflow">return</span> ulGenre; <a name="l00836"></a>00836 } <a name="l00837"></a>00837 <a name="l00838"></a>00838 <span class="comment">//following routine courtesy of John George</span> <a name="l00839"></a><a class="code" href="misc__support_8h.html#a83195d9a949dbbec32130d21ff3045b4">00839</a> <a class="code" href="class_i_d3___frame.html" title="The representative class of an id3v2 frame.">ID3_Frame</a>* <a class="code" href="misc__support_8cpp.html#ab880abad081fec2e6984af29a03cd2b2">ID3_AddGenre</a>(<a class="code" href="class_i_d3___tag.html" title="The representative class of an id3 tag.">ID3_Tag</a>* tag, <span class="keyword">const</span> <span class="keywordtype">char</span>* genre, <span class="keywordtype">bool</span> replace) <a name="l00840"></a>00840 { <a name="l00841"></a>00841 <a class="code" href="class_i_d3___frame.html" title="The representative class of an id3v2 frame.">ID3_Frame</a>* frame = <a class="code" href="globals_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a>; <a name="l00842"></a>00842 <span class="keywordflow">if</span> (<a class="code" href="globals_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a> != tag && <a class="code" href="globals_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a> != genre && strlen(genre) > 0) <a name="l00843"></a>00843 { <a name="l00844"></a>00844 <span class="keywordflow">if</span> (replace) <a name="l00845"></a>00845 { <a name="l00846"></a>00846 <a class="code" href="misc__support_8cpp.html#a87253fa57b9164773f4f1b3479b6992e">ID3_RemoveGenres</a>(tag); <a name="l00847"></a>00847 } <a name="l00848"></a>00848 <span class="keywordflow">if</span> (replace || <a class="code" href="globals_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a> == tag-><a class="code" href="class_i_d3___tag.html#aad2a8e5a801bc09eac967d24ff3539c3" title="Finds frame with given frame id, fld id, and integer data.">Find</a>(<a class="code" href="globals_8h.html#a78f454bf66f16b1e1c9f8e37bda9ab8aa040eba7064ed2c884233113486dbdd54" title="Content type.">ID3FID_CONTENTTYPE</a>)) <a name="l00849"></a>00849 { <a name="l00850"></a>00850 frame = <span class="keyword">new</span> <a class="code" href="class_i_d3___frame.html" title="The representative class of an id3v2 frame.">ID3_Frame</a>(<a class="code" href="globals_8h.html#a78f454bf66f16b1e1c9f8e37bda9ab8aa040eba7064ed2c884233113486dbdd54" title="Content type.">ID3FID_CONTENTTYPE</a>); <a name="l00851"></a>00851 <span class="keywordflow">if</span> (<a class="code" href="globals_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a> != frame) <a name="l00852"></a>00852 { <a name="l00853"></a>00853 frame-><a class="code" href="class_i_d3___frame.html#a6491b36aee70776ed656896daa42ef80">GetField</a>(<a class="code" href="globals_8h.html#a23cab982426a968437cd731900cfeb2cab4a3b9cafedc2cede90380c79edca044" title="Text field.">ID3FN_TEXT</a>)-><a class="code" href="class_i_d3___field.html#a16387cf6c54df5432a0c048d6a931f03">Set</a>(genre); <a name="l00854"></a>00854 tag-><a class="code" href="class_i_d3___tag.html#a8760bcb5321fc95ee0e91a2057b4eb9c" title="Attaches a frame to the tag; the tag takes responsibility for releasing the frame&#39;s memory when t...">AttachFrame</a>(frame); <a name="l00855"></a>00855 } <a name="l00856"></a>00856 } <a name="l00857"></a>00857 } <a name="l00858"></a>00858 <a name="l00859"></a>00859 <span class="keywordflow">return</span> frame; <a name="l00860"></a>00860 } <a name="l00861"></a>00861 <a name="l00862"></a><a class="code" href="misc__support_8h.html#af802230c47ad6d85cc705181e26a35c3">00862</a> <a class="code" href="class_i_d3___frame.html" title="The representative class of an id3v2 frame.">ID3_Frame</a>* <a class="code" href="misc__support_8cpp.html#ab880abad081fec2e6984af29a03cd2b2">ID3_AddGenre</a>(<a class="code" href="class_i_d3___tag.html" title="The representative class of an id3 tag.">ID3_Tag</a> *tag, <span class="keywordtype">size_t</span> genreNum, <span class="keywordtype">bool</span> replace) <a name="l00863"></a>00863 { <a name="l00864"></a>00864 <span class="keywordflow">if</span>(0xFF != genreNum) <a name="l00865"></a>00865 { <a name="l00866"></a>00866 <span class="keywordtype">char</span> sGenre[6]; <a name="l00867"></a>00867 sprintf(sGenre, <span class="stringliteral">"(%lu)"</span>, (<a class="code" href="globals_8h.html#a31c81a77cfd373514f7878719897fca6">luint</a>) genreNum); <a name="l00868"></a>00868 <span class="keywordflow">return</span>(<a class="code" href="misc__support_8cpp.html#ab880abad081fec2e6984af29a03cd2b2">ID3_AddGenre</a>(tag, sGenre, replace)); <a name="l00869"></a>00869 } <a name="l00870"></a>00870 <span class="keywordflow">else</span> <a name="l00871"></a>00871 { <a name="l00872"></a>00872 <span class="keywordflow">return</span>(<a class="code" href="globals_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a>); <a name="l00873"></a>00873 } <a name="l00874"></a>00874 } <a name="l00875"></a>00875 <a name="l00876"></a><a class="code" href="misc__support_8h.html#a622673fef743b70591cf6073c0c501aa">00876</a> <span class="keywordtype">size_t</span> <a class="code" href="misc__support_8cpp.html#a87253fa57b9164773f4f1b3479b6992e">ID3_RemoveGenres</a>(<a class="code" href="class_i_d3___tag.html" title="The representative class of an id3 tag.">ID3_Tag</a> *tag) <a name="l00877"></a>00877 { <a name="l00878"></a>00878 <span class="keywordtype">size_t</span> num_removed = 0; <a name="l00879"></a>00879 <a class="code" href="class_i_d3___frame.html" title="The representative class of an id3v2 frame.">ID3_Frame</a> *frame = <a class="code" href="globals_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a>; <a name="l00880"></a>00880 <a name="l00881"></a>00881 <span class="keywordflow">if</span> (<a class="code" href="globals_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a> == tag) <a name="l00882"></a>00882 { <a name="l00883"></a>00883 <span class="keywordflow">return</span> num_removed; <a name="l00884"></a>00884 } <a name="l00885"></a>00885 <a name="l00886"></a>00886 <span class="keywordflow">while</span> ((frame = tag-><a class="code" href="class_i_d3___tag.html#aad2a8e5a801bc09eac967d24ff3539c3" title="Finds frame with given frame id, fld id, and integer data.">Find</a>(<a class="code" href="globals_8h.html#a78f454bf66f16b1e1c9f8e37bda9ab8aa040eba7064ed2c884233113486dbdd54" title="Content type.">ID3FID_CONTENTTYPE</a>))) <a name="l00887"></a>00887 { <a name="l00888"></a>00888 frame = tag-><a class="code" href="class_i_d3___tag.html#ae21522e16cb899c5cd1c42d8f7fdfad9" title="Removes a frame from the tag.">RemoveFrame</a>(frame); <a name="l00889"></a>00889 <span class="keyword">delete</span> frame; <a name="l00890"></a>00890 num_removed++; <a name="l00891"></a>00891 } <a name="l00892"></a>00892 <a name="l00893"></a>00893 <span class="keywordflow">return</span> num_removed; <a name="l00894"></a>00894 } <a name="l00895"></a>00895 <a name="l00896"></a><a class="code" href="misc__support_8h.html#af87368cce24b885d28d04cf59e146139">00896</a> <span class="keywordtype">char</span> *<a class="code" href="misc__support_8cpp.html#a4846b3ffaddae90c989c4eb32fc7d4d2">ID3_GetLyrics</a>(<span class="keyword">const</span> <a class="code" href="class_i_d3___tag.html" title="The representative class of an id3 tag.">ID3_Tag</a> *tag) <a name="l00897"></a>00897 { <a name="l00898"></a>00898 <span class="keywordtype">char</span> *sLyrics = <a class="code" href="globals_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a>; <a name="l00899"></a>00899 <span class="keywordflow">if</span> (<a class="code" href="globals_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a> == tag) <a name="l00900"></a>00900 { <a name="l00901"></a>00901 <span class="keywordflow">return</span> sLyrics; <a name="l00902"></a>00902 } <a name="l00903"></a>00903 <a name="l00904"></a>00904 <a class="code" href="class_i_d3___frame.html" title="The representative class of an id3v2 frame.">ID3_Frame</a> *frame = tag-><a class="code" href="class_i_d3___tag.html#aad2a8e5a801bc09eac967d24ff3539c3" title="Finds frame with given frame id, fld id, and integer data.">Find</a>(<a class="code" href="globals_8h.html#a78f454bf66f16b1e1c9f8e37bda9ab8aada871da61c6d5e3aac17c3a0c833baea" title="Unsynchronized lyric/text transcription.">ID3FID_UNSYNCEDLYRICS</a>); <a name="l00905"></a>00905 <span class="keywordflow">if</span> (frame != <a class="code" href="globals_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a>) <a name="l00906"></a>00906 { <a name="l00907"></a>00907 sLyrics = <a class="code" href="misc__support_8cpp.html#aeb3ba3ba28ea24ffe6a6d8a5fce9f4ed">ID3_GetString</a>(frame, <a class="code" href="globals_8h.html#a23cab982426a968437cd731900cfeb2cab4a3b9cafedc2cede90380c79edca044" title="Text field.">ID3FN_TEXT</a>); <a name="l00908"></a>00908 } <a name="l00909"></a>00909 <span class="keywordflow">return</span> sLyrics; <a name="l00910"></a>00910 } <a name="l00911"></a>00911 <a name="l00912"></a><a class="code" href="misc__support_8h.html#a0715073ab33ec118c713a77390b5c338">00912</a> <a class="code" href="class_i_d3___frame.html" title="The representative class of an id3v2 frame.">ID3_Frame</a>* <a class="code" href="misc__support_8cpp.html#aae8bf3ceccf72f7b891f904cfc2a30cb">ID3_AddLyrics</a>(<a class="code" href="class_i_d3___tag.html" title="The representative class of an id3 tag.">ID3_Tag</a> *tag, <span class="keyword">const</span> <span class="keywordtype">char</span> *text, <span class="keywordtype">bool</span> replace) <a name="l00913"></a>00913 { <a name="l00914"></a>00914 <span class="keywordflow">return</span> <a class="code" href="misc__support_8cpp.html#aae8bf3ceccf72f7b891f904cfc2a30cb">ID3_AddLyrics</a>(tag, text, <span class="stringliteral">""</span>, replace); <a name="l00915"></a>00915 } <a name="l00916"></a>00916 <a name="l00917"></a><a class="code" href="misc__support_8h.html#aeca247ab60255676fd4cfe486265ffd9">00917</a> <a class="code" href="class_i_d3___frame.html" title="The representative class of an id3v2 frame.">ID3_Frame</a>* <a class="code" href="misc__support_8cpp.html#aae8bf3ceccf72f7b891f904cfc2a30cb">ID3_AddLyrics</a>(<a class="code" href="class_i_d3___tag.html" title="The representative class of an id3 tag.">ID3_Tag</a> *tag, <span class="keyword">const</span> <span class="keywordtype">char</span> *text, <span class="keyword">const</span> <span class="keywordtype">char</span>* desc, <a name="l00918"></a>00918 <span class="keywordtype">bool</span> replace) <a name="l00919"></a>00919 { <a name="l00920"></a>00920 <span class="keywordflow">return</span> <a class="code" href="misc__support_8cpp.html#aae8bf3ceccf72f7b891f904cfc2a30cb">ID3_AddLyrics</a>(tag, text, desc, <span class="stringliteral">"XXX"</span>, replace); <a name="l00921"></a>00921 } <a name="l00922"></a>00922 <a name="l00923"></a><a class="code" href="misc__support_8h.html#a23308af343c229dee94bcaebc91f8698">00923</a> <a class="code" href="class_i_d3___frame.html" title="The representative class of an id3v2 frame.">ID3_Frame</a>* <a class="code" href="misc__support_8cpp.html#aae8bf3ceccf72f7b891f904cfc2a30cb">ID3_AddLyrics</a>(<a class="code" href="class_i_d3___tag.html" title="The representative class of an id3 tag.">ID3_Tag</a> *tag, <span class="keyword">const</span> <span class="keywordtype">char</span> *text, <span class="keyword">const</span> <span class="keywordtype">char</span>* desc, <a name="l00924"></a>00924 <span class="keyword">const</span> <span class="keywordtype">char</span>* lang, <span class="keywordtype">bool</span> replace) <a name="l00925"></a>00925 { <a name="l00926"></a>00926 <a class="code" href="class_i_d3___frame.html" title="The representative class of an id3v2 frame.">ID3_Frame</a>* frame = <a class="code" href="globals_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a>; <a name="l00927"></a>00927 <span class="keywordflow">if</span> (<a class="code" href="globals_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a> != tag && strlen(text) > 0) <a name="l00928"></a>00928 { <a name="l00929"></a>00929 <span class="keywordflow">if</span> (replace) <a name="l00930"></a>00930 { <a name="l00931"></a>00931 <a class="code" href="misc__support_8cpp.html#acff7809fcb85bcb9d303c271ba417322">ID3_RemoveLyrics</a>(tag); <a name="l00932"></a>00932 } <a name="l00933"></a>00933 <span class="keywordflow">if</span> (replace || tag-><a class="code" href="class_i_d3___tag.html#aad2a8e5a801bc09eac967d24ff3539c3" title="Finds frame with given frame id, fld id, and integer data.">Find</a>(<a class="code" href="globals_8h.html#a78f454bf66f16b1e1c9f8e37bda9ab8aada871da61c6d5e3aac17c3a0c833baea" title="Unsynchronized lyric/text transcription.">ID3FID_UNSYNCEDLYRICS</a>) == <a class="code" href="globals_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a>) <a name="l00934"></a>00934 { <a name="l00935"></a>00935 frame = <span class="keyword">new</span> <a class="code" href="class_i_d3___frame.html" title="The representative class of an id3v2 frame.">ID3_Frame</a>(<a class="code" href="globals_8h.html#a78f454bf66f16b1e1c9f8e37bda9ab8aada871da61c6d5e3aac17c3a0c833baea" title="Unsynchronized lyric/text transcription.">ID3FID_UNSYNCEDLYRICS</a>); <a name="l00936"></a>00936 <span class="keywordflow">if</span> (<a class="code" href="globals_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a> != frame) <a name="l00937"></a>00937 { <a name="l00938"></a>00938 frame-><a class="code" href="class_i_d3___frame.html#a6491b36aee70776ed656896daa42ef80">GetField</a>(<a class="code" href="globals_8h.html#a23cab982426a968437cd731900cfeb2caae0e0a0e19501463ffb19f355fb36768" title="Language field.">ID3FN_LANGUAGE</a>)-><a class="code" href="class_i_d3___field.html#a16387cf6c54df5432a0c048d6a931f03">Set</a>(lang); <a name="l00939"></a>00939 frame-><a class="code" href="class_i_d3___frame.html#a6491b36aee70776ed656896daa42ef80">GetField</a>(<a class="code" href="globals_8h.html#a23cab982426a968437cd731900cfeb2ca6898b894ce725eb89b42dc6f4f9117e5" title="Description field.">ID3FN_DESCRIPTION</a>)-><a class="code" href="class_i_d3___field.html#a16387cf6c54df5432a0c048d6a931f03">Set</a>(desc); <a name="l00940"></a>00940 frame-><a class="code" href="class_i_d3___frame.html#a6491b36aee70776ed656896daa42ef80">GetField</a>(<a class="code" href="globals_8h.html#a23cab982426a968437cd731900cfeb2cab4a3b9cafedc2cede90380c79edca044" title="Text field.">ID3FN_TEXT</a>)-><a class="code" href="class_i_d3___field.html#a16387cf6c54df5432a0c048d6a931f03">Set</a>(text); <a name="l00941"></a>00941 tag-><a class="code" href="class_i_d3___tag.html#a8760bcb5321fc95ee0e91a2057b4eb9c" title="Attaches a frame to the tag; the tag takes responsibility for releasing the frame&#39;s memory when t...">AttachFrame</a>(frame); <a name="l00942"></a>00942 } <a name="l00943"></a>00943 } <a name="l00944"></a>00944 } <a name="l00945"></a>00945 <a name="l00946"></a>00946 <span class="keywordflow">return</span> frame; <a name="l00947"></a>00947 } <a name="l00948"></a>00948 <a name="l00949"></a><a class="code" href="misc__support_8h.html#a2f9f9d9d609cab9d21a4d2dd19cbc5a9">00949</a> <span class="keywordtype">size_t</span> <a class="code" href="misc__support_8cpp.html#acff7809fcb85bcb9d303c271ba417322">ID3_RemoveLyrics</a>(<a class="code" href="class_i_d3___tag.html" title="The representative class of an id3 tag.">ID3_Tag</a> *tag) <a name="l00950"></a>00950 { <a name="l00951"></a>00951 <span class="keywordtype">size_t</span> num_removed = 0; <a name="l00952"></a>00952 <a class="code" href="class_i_d3___frame.html" title="The representative class of an id3v2 frame.">ID3_Frame</a> *frame = <a class="code" href="globals_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a>; <a name="l00953"></a>00953 <a name="l00954"></a>00954 <span class="keywordflow">if</span> (<a class="code" href="globals_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a> == tag) <a name="l00955"></a>00955 { <a name="l00956"></a>00956 <span class="keywordflow">return</span> num_removed; <a name="l00957"></a>00957 } <a name="l00958"></a>00958 <a name="l00959"></a>00959 <span class="keywordflow">while</span> ((frame = tag-><a class="code" href="class_i_d3___tag.html#aad2a8e5a801bc09eac967d24ff3539c3" title="Finds frame with given frame id, fld id, and integer data.">Find</a>(<a class="code" href="globals_8h.html#a78f454bf66f16b1e1c9f8e37bda9ab8aada871da61c6d5e3aac17c3a0c833baea" title="Unsynchronized lyric/text transcription.">ID3FID_UNSYNCEDLYRICS</a>))) <a name="l00960"></a>00960 { <a name="l00961"></a>00961 frame = tag-><a class="code" href="class_i_d3___tag.html#ae21522e16cb899c5cd1c42d8f7fdfad9" title="Removes a frame from the tag.">RemoveFrame</a>(frame); <a name="l00962"></a>00962 <span class="keyword">delete</span> frame; <a name="l00963"></a>00963 num_removed++; <a name="l00964"></a>00964 } <a name="l00965"></a>00965 <a name="l00966"></a>00966 <span class="keywordflow">return</span> num_removed; <a name="l00967"></a>00967 } <a name="l00968"></a>00968 <a name="l00969"></a><a class="code" href="misc__support_8h.html#a86fecd74b24128df7a2e352d2ad90013">00969</a> <span class="keywordtype">char</span> *<a class="code" href="misc__support_8cpp.html#a952e9f7c23ec2408dbf32e1948a32aed">ID3_GetLyricist</a>(<span class="keyword">const</span> <a class="code" href="class_i_d3___tag.html" title="The representative class of an id3 tag.">ID3_Tag</a> *tag) <a name="l00970"></a>00970 { <a name="l00971"></a>00971 <span class="keywordtype">char</span> *sLyricist = <a class="code" href="globals_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a>; <a name="l00972"></a>00972 <span class="keywordflow">if</span> (<a class="code" href="globals_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a> == tag) <a name="l00973"></a>00973 { <a name="l00974"></a>00974 <span class="keywordflow">return</span> sLyricist; <a name="l00975"></a>00975 } <a name="l00976"></a>00976 <a name="l00977"></a>00977 <a class="code" href="class_i_d3___frame.html" title="The representative class of an id3v2 frame.">ID3_Frame</a> *frame = tag-><a class="code" href="class_i_d3___tag.html#aad2a8e5a801bc09eac967d24ff3539c3" title="Finds frame with given frame id, fld id, and integer data.">Find</a>(<a class="code" href="globals_8h.html#a78f454bf66f16b1e1c9f8e37bda9ab8aa52d474b6fc3b700d83c65938c391c87d" title="Lyricist/Text writer.">ID3FID_LYRICIST</a>); <a name="l00978"></a>00978 <span class="keywordflow">if</span> (frame != <a class="code" href="globals_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a>) <a name="l00979"></a>00979 { <a name="l00980"></a>00980 sLyricist = <a class="code" href="misc__support_8cpp.html#aeb3ba3ba28ea24ffe6a6d8a5fce9f4ed">ID3_GetString</a>(frame, <a class="code" href="globals_8h.html#a23cab982426a968437cd731900cfeb2cab4a3b9cafedc2cede90380c79edca044" title="Text field.">ID3FN_TEXT</a>); <a name="l00981"></a>00981 } <a name="l00982"></a>00982 <span class="keywordflow">return</span> sLyricist; <a name="l00983"></a>00983 } <a name="l00984"></a>00984 <a name="l00985"></a><a class="code" href="misc__support_8h.html#a9dbcb8e174afa402df2a8f3da04b5c4f">00985</a> <a class="code" href="class_i_d3___frame.html" title="The representative class of an id3v2 frame.">ID3_Frame</a>* <a class="code" href="misc__support_8cpp.html#a7801069243d2848c60678fe790cdd72e">ID3_AddLyricist</a>(<a class="code" href="class_i_d3___tag.html" title="The representative class of an id3 tag.">ID3_Tag</a> *tag, <span class="keyword">const</span> <span class="keywordtype">char</span> *text, <span class="keywordtype">bool</span> replace) <a name="l00986"></a>00986 { <a name="l00987"></a>00987 <a class="code" href="class_i_d3___frame.html" title="The representative class of an id3v2 frame.">ID3_Frame</a>* frame = <a class="code" href="globals_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a>; <a name="l00988"></a>00988 <span class="keywordflow">if</span> (<a class="code" href="globals_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a> != tag && <a class="code" href="globals_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a> != text && strlen(text) > 0) <a name="l00989"></a>00989 { <a name="l00990"></a>00990 <span class="keywordflow">if</span> (replace) <a name="l00991"></a>00991 { <a name="l00992"></a>00992 <a class="code" href="misc__support_8cpp.html#ac8ba157a258d0a426f8236262036a6af">ID3_RemoveLyricist</a>(tag); <a name="l00993"></a>00993 } <a name="l00994"></a>00994 <span class="keywordflow">if</span> (replace || (tag-><a class="code" href="class_i_d3___tag.html#aad2a8e5a801bc09eac967d24ff3539c3" title="Finds frame with given frame id, fld id, and integer data.">Find</a>(<a class="code" href="globals_8h.html#a78f454bf66f16b1e1c9f8e37bda9ab8aa52d474b6fc3b700d83c65938c391c87d" title="Lyricist/Text writer.">ID3FID_LYRICIST</a>) == <a class="code" href="globals_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a>)) <a name="l00995"></a>00995 { <a name="l00996"></a>00996 frame = <span class="keyword">new</span> <a class="code" href="class_i_d3___frame.html" title="The representative class of an id3v2 frame.">ID3_Frame</a>(<a class="code" href="globals_8h.html#a78f454bf66f16b1e1c9f8e37bda9ab8aa52d474b6fc3b700d83c65938c391c87d" title="Lyricist/Text writer.">ID3FID_LYRICIST</a>); <a name="l00997"></a>00997 <span class="keywordflow">if</span> (frame) <a name="l00998"></a>00998 { <a name="l00999"></a>00999 frame-><a class="code" href="class_i_d3___frame.html#a6491b36aee70776ed656896daa42ef80">GetField</a>(<a class="code" href="globals_8h.html#a23cab982426a968437cd731900cfeb2cab4a3b9cafedc2cede90380c79edca044" title="Text field.">ID3FN_TEXT</a>)-><a class="code" href="class_i_d3___field.html#a16387cf6c54df5432a0c048d6a931f03">Set</a>(text); <a name="l01000"></a>01000 tag-><a class="code" href="class_i_d3___tag.html#a8760bcb5321fc95ee0e91a2057b4eb9c" title="Attaches a frame to the tag; the tag takes responsibility for releasing the frame&#39;s memory when t...">AttachFrame</a>(frame); <a name="l01001"></a>01001 } <a name="l01002"></a>01002 } <a name="l01003"></a>01003 } <a name="l01004"></a>01004 <a name="l01005"></a>01005 <span class="keywordflow">return</span> frame; <a name="l01006"></a>01006 } <a name="l01007"></a>01007 <a name="l01008"></a><a class="code" href="misc__support_8h.html#a59d212d96be5c6feda49e1e291ebc344">01008</a> <span class="keywordtype">size_t</span> <a class="code" href="misc__support_8cpp.html#ac8ba157a258d0a426f8236262036a6af">ID3_RemoveLyricist</a>(<a class="code" href="class_i_d3___tag.html" title="The representative class of an id3 tag.">ID3_Tag</a> *tag) <a name="l01009"></a>01009 { <a name="l01010"></a>01010 <span class="keywordtype">size_t</span> num_removed = 0; <a name="l01011"></a>01011 <a class="code" href="class_i_d3___frame.html" title="The representative class of an id3v2 frame.">ID3_Frame</a> *frame = <a class="code" href="globals_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a>; <a name="l01012"></a>01012 <a name="l01013"></a>01013 <span class="keywordflow">if</span> (<a class="code" href="globals_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a> == tag) <a name="l01014"></a>01014 { <a name="l01015"></a>01015 <span class="keywordflow">return</span> num_removed; <a name="l01016"></a>01016 } <a name="l01017"></a>01017 <a name="l01018"></a>01018 <span class="keywordflow">while</span> ((frame = tag-><a class="code" href="class_i_d3___tag.html#aad2a8e5a801bc09eac967d24ff3539c3" title="Finds frame with given frame id, fld id, and integer data.">Find</a>(<a class="code" href="globals_8h.html#a78f454bf66f16b1e1c9f8e37bda9ab8aa52d474b6fc3b700d83c65938c391c87d" title="Lyricist/Text writer.">ID3FID_LYRICIST</a>))) <a name="l01019"></a>01019 { <a name="l01020"></a>01020 frame = tag-><a class="code" href="class_i_d3___tag.html#ae21522e16cb899c5cd1c42d8f7fdfad9" title="Removes a frame from the tag.">RemoveFrame</a>(frame); <a name="l01021"></a>01021 <span class="keyword">delete</span> frame; <a name="l01022"></a>01022 num_removed++; <a name="l01023"></a>01023 } <a name="l01024"></a>01024 <a name="l01025"></a>01025 <span class="keywordflow">return</span> num_removed; <a name="l01026"></a>01026 } <a name="l01027"></a>01027 <a name="l01028"></a><a class="code" href="misc__support_8h.html#ac9c432b331b667dfc8b504749196e5d6">01028</a> <a class="code" href="class_i_d3___frame.html" title="The representative class of an id3v2 frame.">ID3_Frame</a>* <a class="code" href="misc__support_8cpp.html#ad3f2687a6a0c0e95f31df4d777af8fea">ID3_AddSyncLyrics</a>(<a class="code" href="class_i_d3___tag.html" title="The representative class of an id3 tag.">ID3_Tag</a> *tag, <span class="keyword">const</span> <a class="code" href="globals_8h.html#a65f85814a8290f9797005d3b28e7e5fc">uchar</a> *data, <span class="keywordtype">size_t</span> datasize, <a name="l01029"></a>01029 <a class="code" href="globals_8h.html#afcee1ca6fff19ac9b4ecc94d65fde23a">ID3_TimeStampFormat</a> format, <span class="keywordtype">bool</span> replace) <a name="l01030"></a>01030 { <a name="l01031"></a>01031 <span class="keywordflow">return</span> <a class="code" href="misc__support_8cpp.html#ad3f2687a6a0c0e95f31df4d777af8fea">ID3_AddSyncLyrics</a>(tag, data, datasize, format, <span class="stringliteral">""</span>, replace); <a name="l01032"></a>01032 } <a name="l01033"></a>01033 <a name="l01034"></a><a class="code" href="misc__support_8h.html#a58dc5a6765242910d39d106eb84be327">01034</a> <a class="code" href="class_i_d3___frame.html" title="The representative class of an id3v2 frame.">ID3_Frame</a>* <a class="code" href="misc__support_8cpp.html#ad3f2687a6a0c0e95f31df4d777af8fea">ID3_AddSyncLyrics</a>(<a class="code" href="class_i_d3___tag.html" title="The representative class of an id3 tag.">ID3_Tag</a> *tag, <span class="keyword">const</span> <a class="code" href="globals_8h.html#a65f85814a8290f9797005d3b28e7e5fc">uchar</a> *data, <span class="keywordtype">size_t</span> datasize, <a name="l01035"></a>01035 <a class="code" href="globals_8h.html#afcee1ca6fff19ac9b4ecc94d65fde23a">ID3_TimeStampFormat</a> format, <span class="keyword">const</span> <span class="keywordtype">char</span> *desc, <a name="l01036"></a>01036 <span class="keywordtype">bool</span> replace) <a name="l01037"></a>01037 { <a name="l01038"></a>01038 <span class="keywordflow">return</span> <a class="code" href="misc__support_8cpp.html#ad3f2687a6a0c0e95f31df4d777af8fea">ID3_AddSyncLyrics</a>(tag, data, datasize, format, desc, <span class="stringliteral">"XXX"</span>, replace); <a name="l01039"></a>01039 } <a name="l01040"></a>01040 <a name="l01041"></a><a class="code" href="misc__support_8h.html#ad56f898e280cc33b435cb689d583bbe0">01041</a> <a class="code" href="class_i_d3___frame.html" title="The representative class of an id3v2 frame.">ID3_Frame</a>* <a class="code" href="misc__support_8cpp.html#ad3f2687a6a0c0e95f31df4d777af8fea">ID3_AddSyncLyrics</a>(<a class="code" href="class_i_d3___tag.html" title="The representative class of an id3 tag.">ID3_Tag</a> *tag, <span class="keyword">const</span> <a class="code" href="globals_8h.html#a65f85814a8290f9797005d3b28e7e5fc">uchar</a> *data, <span class="keywordtype">size_t</span> datasize, <a name="l01042"></a>01042 <a class="code" href="globals_8h.html#afcee1ca6fff19ac9b4ecc94d65fde23a">ID3_TimeStampFormat</a> format, <span class="keyword">const</span> <span class="keywordtype">char</span> *desc, <a name="l01043"></a>01043 <span class="keyword">const</span> <span class="keywordtype">char</span> *lang, <span class="keywordtype">bool</span> replace) <a name="l01044"></a>01044 { <a name="l01045"></a>01045 <span class="keywordflow">return</span> <a class="code" href="misc__support_8cpp.html#ad3f2687a6a0c0e95f31df4d777af8fea">ID3_AddSyncLyrics</a>(tag, data, datasize, format, desc, lang, <a name="l01046"></a>01046 <a class="code" href="globals_8h.html#a2e8ca74158e0cc09c012cbd3511bab59a48eda6a842d7ee1fe4b95e737f9ace63">ID3CT_LYRICS</a>, replace); <a name="l01047"></a>01047 } <a name="l01048"></a>01048 <a name="l01049"></a><a class="code" href="misc__support_8h.html#a70b4246b9b801a13d0a4f9599d75838b">01049</a> <a class="code" href="class_i_d3___frame.html" title="The representative class of an id3v2 frame.">ID3_Frame</a>* <a class="code" href="misc__support_8cpp.html#ad3f2687a6a0c0e95f31df4d777af8fea">ID3_AddSyncLyrics</a>(<a class="code" href="class_i_d3___tag.html" title="The representative class of an id3 tag.">ID3_Tag</a> *tag, <span class="keyword">const</span> <a class="code" href="globals_8h.html#a65f85814a8290f9797005d3b28e7e5fc">uchar</a> *data, <span class="keywordtype">size_t</span> datasize, <a name="l01050"></a>01050 <a class="code" href="globals_8h.html#afcee1ca6fff19ac9b4ecc94d65fde23a">ID3_TimeStampFormat</a> format, <span class="keyword">const</span> <span class="keywordtype">char</span> *desc, <a name="l01051"></a>01051 <span class="keyword">const</span> <span class="keywordtype">char</span> *lang, <a class="code" href="globals_8h.html#a2e8ca74158e0cc09c012cbd3511bab59">ID3_ContentType</a> type, <a name="l01052"></a>01052 <span class="keywordtype">bool</span> replace) <a name="l01053"></a>01053 { <a name="l01054"></a>01054 <a class="code" href="class_i_d3___frame.html" title="The representative class of an id3v2 frame.">ID3_Frame</a>* frame = <a class="code" href="globals_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a>; <a name="l01055"></a>01055 <span class="comment">// language and descriptor should be mandatory</span> <a name="l01056"></a>01056 <span class="keywordflow">if</span> ((<a class="code" href="globals_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a> == lang) || (<a class="code" href="globals_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a> == desc)) <a name="l01057"></a>01057 { <a name="l01058"></a>01058 <span class="keywordflow">return</span> <a class="code" href="globals_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a>; <a name="l01059"></a>01059 } <a name="l01060"></a>01060 <a name="l01061"></a>01061 <span class="comment">// check if a SYLT frame of this language or descriptor already exists</span> <a name="l01062"></a>01062 <a class="code" href="class_i_d3___frame.html" title="The representative class of an id3v2 frame.">ID3_Frame</a>* frmExist = tag-><a class="code" href="class_i_d3___tag.html#aad2a8e5a801bc09eac967d24ff3539c3" title="Finds frame with given frame id, fld id, and integer data.">Find</a>(<a class="code" href="globals_8h.html#a78f454bf66f16b1e1c9f8e37bda9ab8aaf89624f1fb5e492d63991ad023376a9a" title="Synchronized lyric/text.">ID3FID_SYNCEDLYRICS</a>, <a class="code" href="globals_8h.html#a23cab982426a968437cd731900cfeb2caae0e0a0e19501463ffb19f355fb36768" title="Language field.">ID3FN_LANGUAGE</a>, lang); <a name="l01063"></a>01063 <span class="keywordflow">if</span> (!frmExist) <a name="l01064"></a>01064 { <a name="l01065"></a>01065 frmExist = tag-><a class="code" href="class_i_d3___tag.html#aad2a8e5a801bc09eac967d24ff3539c3" title="Finds frame with given frame id, fld id, and integer data.">Find</a>(<a class="code" href="globals_8h.html#a78f454bf66f16b1e1c9f8e37bda9ab8aaf89624f1fb5e492d63991ad023376a9a" title="Synchronized lyric/text.">ID3FID_SYNCEDLYRICS</a>, <a class="code" href="globals_8h.html#a23cab982426a968437cd731900cfeb2ca6898b894ce725eb89b42dc6f4f9117e5" title="Description field.">ID3FN_DESCRIPTION</a>, desc); <a name="l01066"></a>01066 } <a name="l01067"></a>01067 <a name="l01068"></a>01068 <span class="keywordflow">if</span> (<a class="code" href="globals_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a> != tag && <a class="code" href="globals_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a> != data) <a name="l01069"></a>01069 { <a name="l01070"></a>01070 <span class="keywordflow">if</span> (replace && frmExist) <a name="l01071"></a>01071 { <a name="l01072"></a>01072 frmExist = tag-><a class="code" href="class_i_d3___tag.html#ae21522e16cb899c5cd1c42d8f7fdfad9" title="Removes a frame from the tag.">RemoveFrame</a> (frmExist); <a name="l01073"></a>01073 <span class="keyword">delete</span> frmExist; <a name="l01074"></a>01074 frmExist = <a class="code" href="globals_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a>; <a name="l01075"></a>01075 } <a name="l01076"></a>01076 <a name="l01077"></a>01077 <span class="comment">// if the frame still exist, cannot continue</span> <a name="l01078"></a>01078 <span class="keywordflow">if</span> (frmExist) <a name="l01079"></a>01079 { <a name="l01080"></a>01080 <span class="keywordflow">return</span> <a class="code" href="globals_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a>; <a name="l01081"></a>01081 } <a name="l01082"></a>01082 <a name="l01083"></a>01083 <a class="code" href="class_i_d3___frame.html" title="The representative class of an id3v2 frame.">ID3_Frame</a>* frame = <span class="keyword">new</span> <a class="code" href="class_i_d3___frame.html" title="The representative class of an id3v2 frame.">ID3_Frame</a>(<a class="code" href="globals_8h.html#a78f454bf66f16b1e1c9f8e37bda9ab8aaf89624f1fb5e492d63991ad023376a9a" title="Synchronized lyric/text.">ID3FID_SYNCEDLYRICS</a>); <a name="l01084"></a>01084 <a name="l01085"></a>01085 frame-><a class="code" href="class_i_d3___frame.html#a6491b36aee70776ed656896daa42ef80">GetField</a>(<a class="code" href="globals_8h.html#a23cab982426a968437cd731900cfeb2caae0e0a0e19501463ffb19f355fb36768" title="Language field.">ID3FN_LANGUAGE</a>)-><a class="code" href="class_i_d3___field.html#a16387cf6c54df5432a0c048d6a931f03">Set</a>(lang); <a name="l01086"></a>01086 frame-><a class="code" href="class_i_d3___frame.html#a6491b36aee70776ed656896daa42ef80">GetField</a>(<a class="code" href="globals_8h.html#a23cab982426a968437cd731900cfeb2ca6898b894ce725eb89b42dc6f4f9117e5" title="Description field.">ID3FN_DESCRIPTION</a>)-><a class="code" href="class_i_d3___field.html#a16387cf6c54df5432a0c048d6a931f03">Set</a>(desc); <a name="l01087"></a>01087 frame-><a class="code" href="class_i_d3___frame.html#a6491b36aee70776ed656896daa42ef80">GetField</a>(<a class="code" href="globals_8h.html#a23cab982426a968437cd731900cfeb2ca70b32751cd1a724e650b0cc99eea7a7b" title="SYLT Timestamp Format.">ID3FN_TIMESTAMPFORMAT</a>)-><a class="code" href="class_i_d3___field.html#a16387cf6c54df5432a0c048d6a931f03">Set</a>(format); <a name="l01088"></a>01088 frame-><a class="code" href="class_i_d3___frame.html#a6491b36aee70776ed656896daa42ef80">GetField</a>(<a class="code" href="globals_8h.html#a23cab982426a968437cd731900cfeb2caedc856db9faf0e05a668f5315ccfcdad" title="SYLT content type.">ID3FN_CONTENTTYPE</a>)-><a class="code" href="class_i_d3___field.html#a16387cf6c54df5432a0c048d6a931f03">Set</a>(type); <a name="l01089"></a>01089 frame-><a class="code" href="class_i_d3___frame.html#a6491b36aee70776ed656896daa42ef80">GetField</a>(<a class="code" href="globals_8h.html#a23cab982426a968437cd731900cfeb2cabd5e1e87686d7a1fc9ba291023e9ccc0" title="Data field.">ID3FN_DATA</a>)-><a class="code" href="class_i_d3___field.html#a16387cf6c54df5432a0c048d6a931f03">Set</a>(data, datasize); <a name="l01090"></a>01090 tag-><a class="code" href="class_i_d3___tag.html#a8760bcb5321fc95ee0e91a2057b4eb9c" title="Attaches a frame to the tag; the tag takes responsibility for releasing the frame&#39;s memory when t...">AttachFrame</a>(frame); <a name="l01091"></a>01091 } <a name="l01092"></a>01092 <a name="l01093"></a>01093 <span class="keywordflow">return</span> frame; <a name="l01094"></a>01094 } <a name="l01095"></a>01095 <a name="l01096"></a><a class="code" href="misc__support_8cpp.html#a77f12b3a555090342138a28e244612b7">01096</a> <a class="code" href="class_i_d3___frame.html" title="The representative class of an id3v2 frame.">ID3_Frame</a> *<a class="code" href="misc__support_8cpp.html#a77f12b3a555090342138a28e244612b7">ID3_GetSyncLyricsInfo</a>(<span class="keyword">const</span> <a class="code" href="class_i_d3___tag.html" title="The representative class of an id3 tag.">ID3_Tag</a> *tag, <span class="keyword">const</span> <span class="keywordtype">char</span> *desc, <a name="l01097"></a>01097 <span class="keyword">const</span> <span class="keywordtype">char</span> *lang, <a name="l01098"></a>01098 <a class="code" href="globals_8h.html#afcee1ca6fff19ac9b4ecc94d65fde23a">ID3_TimeStampFormat</a>& format, <a name="l01099"></a>01099 <a class="code" href="globals_8h.html#a2e8ca74158e0cc09c012cbd3511bab59">ID3_ContentType</a>& type, <span class="keywordtype">size_t</span>& size) <a name="l01100"></a>01100 { <a name="l01101"></a>01101 <span class="comment">// check if a SYLT frame of this language or descriptor exists</span> <a name="l01102"></a>01102 <a class="code" href="class_i_d3___frame.html" title="The representative class of an id3v2 frame.">ID3_Frame</a>* frmExist = <a class="code" href="globals_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a>; <a name="l01103"></a>01103 <span class="keywordflow">if</span> (<a class="code" href="globals_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a> != lang) <a name="l01104"></a>01104 { <a name="l01105"></a>01105 <span class="comment">// search through language</span> <a name="l01106"></a>01106 frmExist = tag-><a class="code" href="class_i_d3___tag.html#aad2a8e5a801bc09eac967d24ff3539c3" title="Finds frame with given frame id, fld id, and integer data.">Find</a>(<a class="code" href="globals_8h.html#a78f454bf66f16b1e1c9f8e37bda9ab8aaf89624f1fb5e492d63991ad023376a9a" title="Synchronized lyric/text.">ID3FID_SYNCEDLYRICS</a>, <a class="code" href="globals_8h.html#a23cab982426a968437cd731900cfeb2caae0e0a0e19501463ffb19f355fb36768" title="Language field.">ID3FN_LANGUAGE</a>, lang); <a name="l01107"></a>01107 } <a name="l01108"></a>01108 <span class="keywordflow">else</span> <span class="keywordflow">if</span> (<a class="code" href="globals_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a> != desc) <a name="l01109"></a>01109 { <a name="l01110"></a>01110 <span class="comment">// search through descriptor</span> <a name="l01111"></a>01111 frmExist = tag-><a class="code" href="class_i_d3___tag.html#aad2a8e5a801bc09eac967d24ff3539c3" title="Finds frame with given frame id, fld id, and integer data.">Find</a>(<a class="code" href="globals_8h.html#a78f454bf66f16b1e1c9f8e37bda9ab8aaf89624f1fb5e492d63991ad023376a9a" title="Synchronized lyric/text.">ID3FID_SYNCEDLYRICS</a>, <a class="code" href="globals_8h.html#a23cab982426a968437cd731900cfeb2ca6898b894ce725eb89b42dc6f4f9117e5" title="Description field.">ID3FN_DESCRIPTION</a>, desc); <a name="l01112"></a>01112 } <a name="l01113"></a>01113 <span class="keywordflow">else</span> <a name="l01114"></a>01114 { <a name="l01115"></a>01115 <span class="comment">// both language and description not specified, search the first SYLT frame</span> <a name="l01116"></a>01116 frmExist = tag-><a class="code" href="class_i_d3___tag.html#aad2a8e5a801bc09eac967d24ff3539c3" title="Finds frame with given frame id, fld id, and integer data.">Find</a>(<a class="code" href="globals_8h.html#a78f454bf66f16b1e1c9f8e37bda9ab8aaf89624f1fb5e492d63991ad023376a9a" title="Synchronized lyric/text.">ID3FID_SYNCEDLYRICS</a>); <a name="l01117"></a>01117 } <a name="l01118"></a>01118 <a name="l01119"></a>01119 <span class="keywordflow">if</span> (!frmExist) <a name="l01120"></a>01120 { <a name="l01121"></a>01121 <span class="keywordflow">return</span> <a class="code" href="globals_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a>; <a name="l01122"></a>01122 } <a name="l01123"></a>01123 <a name="l01124"></a>01124 <span class="comment">// get the lyrics time stamp format</span> <a name="l01125"></a>01125 format = <span class="keyword">static_cast<</span><a class="code" href="globals_8h.html#afcee1ca6fff19ac9b4ecc94d65fde23a">ID3_TimeStampFormat</a><span class="keyword">></span>(frmExist-><a class="code" href="class_i_d3___frame.html#a6491b36aee70776ed656896daa42ef80">GetField</a>(<a class="code" href="globals_8h.html#a23cab982426a968437cd731900cfeb2ca70b32751cd1a724e650b0cc99eea7a7b" title="SYLT Timestamp Format.">ID3FN_TIMESTAMPFORMAT</a>)-><a class="code" href="class_i_d3___field.html#a363d1034fb4e60e85f15bcf9818d33ef" title="Returns the value of the integer field.">Get</a> ()); <a name="l01126"></a>01126 <a name="l01127"></a>01127 <span class="comment">// get the lyrics content type</span> <a name="l01128"></a>01128 type = <span class="keyword">static_cast<</span><a class="code" href="globals_8h.html#a2e8ca74158e0cc09c012cbd3511bab59">ID3_ContentType</a><span class="keyword">></span>(frmExist-><a class="code" href="class_i_d3___frame.html#a6491b36aee70776ed656896daa42ef80">GetField</a>(<a class="code" href="globals_8h.html#a23cab982426a968437cd731900cfeb2caedc856db9faf0e05a668f5315ccfcdad" title="SYLT content type.">ID3FN_CONTENTTYPE</a>)-><a class="code" href="class_i_d3___field.html#a363d1034fb4e60e85f15bcf9818d33ef" title="Returns the value of the integer field.">Get</a> ()); <a name="l01129"></a>01129 <a name="l01130"></a>01130 <span class="comment">// get the lyrics size</span> <a name="l01131"></a>01131 size = frmExist-><a class="code" href="class_i_d3___frame.html#a6491b36aee70776ed656896daa42ef80">GetField</a> (<a class="code" href="globals_8h.html#a23cab982426a968437cd731900cfeb2cabd5e1e87686d7a1fc9ba291023e9ccc0" title="Data field.">ID3FN_DATA</a>)-><a class="code" href="class_i_d3___field.html#a4eed557e9f540d3c9347ac31f0f8e55b" title="Returns the size of a field.">Size</a> (); <a name="l01132"></a>01132 <a name="l01133"></a>01133 <span class="comment">// return the frame pointer for further uses</span> <a name="l01134"></a>01134 <span class="keywordflow">return</span> frmExist; <a name="l01135"></a>01135 } <a name="l01136"></a>01136 <a name="l01137"></a><a class="code" href="misc__support_8h.html#afa1fe3272ff1d83cecee5b039dad3aee">01137</a> <a class="code" href="class_i_d3___frame.html" title="The representative class of an id3v2 frame.">ID3_Frame</a> *<a class="code" href="misc__support_8cpp.html#ae8c5073ff5cd3c35af3312de0f3b8e0f">ID3_GetSyncLyrics</a>(<span class="keyword">const</span> <a class="code" href="class_i_d3___tag.html" title="The representative class of an id3 tag.">ID3_Tag</a>* tag, <span class="keyword">const</span> <span class="keywordtype">char</span>* lang, <a name="l01138"></a>01138 <span class="keyword">const</span> <span class="keywordtype">char</span>* desc, <span class="keyword">const</span> <a class="code" href="globals_8h.html#a65f85814a8290f9797005d3b28e7e5fc">uchar</a>* &pData, <span class="keywordtype">size_t</span>& size) <a name="l01139"></a>01139 { <a name="l01140"></a>01140 <span class="comment">// check if a SYLT frame of this language or descriptor exists</span> <a name="l01141"></a>01141 <a class="code" href="class_i_d3___frame.html" title="The representative class of an id3v2 frame.">ID3_Frame</a>* frmExist = <a class="code" href="globals_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a>; <a name="l01142"></a>01142 <span class="keywordflow">if</span> (<a class="code" href="globals_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a> != lang) <a name="l01143"></a>01143 { <a name="l01144"></a>01144 <span class="comment">// search through language</span> <a name="l01145"></a>01145 frmExist = tag-><a class="code" href="class_i_d3___tag.html#aad2a8e5a801bc09eac967d24ff3539c3" title="Finds frame with given frame id, fld id, and integer data.">Find</a>(<a class="code" href="globals_8h.html#a78f454bf66f16b1e1c9f8e37bda9ab8aaf89624f1fb5e492d63991ad023376a9a" title="Synchronized lyric/text.">ID3FID_SYNCEDLYRICS</a>, <a class="code" href="globals_8h.html#a23cab982426a968437cd731900cfeb2caae0e0a0e19501463ffb19f355fb36768" title="Language field.">ID3FN_LANGUAGE</a>, lang); <a name="l01146"></a>01146 } <a name="l01147"></a>01147 <span class="keywordflow">else</span> <span class="keywordflow">if</span> (<a class="code" href="globals_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a> != desc) <a name="l01148"></a>01148 { <a name="l01149"></a>01149 <span class="comment">// search through descriptor</span> <a name="l01150"></a>01150 frmExist = tag-><a class="code" href="class_i_d3___tag.html#aad2a8e5a801bc09eac967d24ff3539c3" title="Finds frame with given frame id, fld id, and integer data.">Find</a>(<a class="code" href="globals_8h.html#a78f454bf66f16b1e1c9f8e37bda9ab8aaf89624f1fb5e492d63991ad023376a9a" title="Synchronized lyric/text.">ID3FID_SYNCEDLYRICS</a>, <a class="code" href="globals_8h.html#a23cab982426a968437cd731900cfeb2ca6898b894ce725eb89b42dc6f4f9117e5" title="Description field.">ID3FN_DESCRIPTION</a>, desc); <a name="l01151"></a>01151 } <a name="l01152"></a>01152 <span class="keywordflow">else</span> <a name="l01153"></a>01153 { <a name="l01154"></a>01154 <span class="comment">// both language and description not specified, search the first SYLT frame</span> <a name="l01155"></a>01155 frmExist = tag-><a class="code" href="class_i_d3___tag.html#aad2a8e5a801bc09eac967d24ff3539c3" title="Finds frame with given frame id, fld id, and integer data.">Find</a>(<a class="code" href="globals_8h.html#a78f454bf66f16b1e1c9f8e37bda9ab8aaf89624f1fb5e492d63991ad023376a9a" title="Synchronized lyric/text.">ID3FID_SYNCEDLYRICS</a>); <a name="l01156"></a>01156 } <a name="l01157"></a>01157 <a name="l01158"></a>01158 <span class="keywordflow">if</span> (<a class="code" href="globals_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a> == frmExist) <a name="l01159"></a>01159 { <a name="l01160"></a>01160 <span class="keywordflow">return</span> <a class="code" href="globals_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a>; <a name="l01161"></a>01161 } <a name="l01162"></a>01162 <a name="l01163"></a>01163 <span class="comment">// get the lyrics size</span> <a name="l01164"></a>01164 size = dami::min(size, frmExist-><a class="code" href="class_i_d3___frame.html#a6491b36aee70776ed656896daa42ef80">GetField</a>(<a class="code" href="globals_8h.html#a23cab982426a968437cd731900cfeb2cabd5e1e87686d7a1fc9ba291023e9ccc0" title="Data field.">ID3FN_DATA</a>)-><a class="code" href="class_i_d3___field.html#a4eed557e9f540d3c9347ac31f0f8e55b" title="Returns the size of a field.">Size</a>()); <a name="l01165"></a>01165 <a name="l01166"></a>01166 <span class="comment">// get the lyrics data</span> <a name="l01167"></a>01167 pData = frmExist-><a class="code" href="class_i_d3___frame.html#a6491b36aee70776ed656896daa42ef80">GetField</a> (<a class="code" href="globals_8h.html#a23cab982426a968437cd731900cfeb2cabd5e1e87686d7a1fc9ba291023e9ccc0" title="Data field.">ID3FN_DATA</a>)-><a class="code" href="class_i_d3___field.html#ac2ad64c889eae4aa614a85d0aa38b2ab">GetRawBinary</a>(); <a name="l01168"></a>01168 <a name="l01169"></a>01169 <span class="comment">// return the frame pointer for further uses</span> <a name="l01170"></a>01170 <span class="keywordflow">return</span> frmExist; <a name="l01171"></a>01171 } <a name="l01172"></a>01172 </pre></div></div> </div> <hr size="1"><address style="text-align: right;"><small> Generated for id3lib by <a href="http://www.doxygen.org/ index.html"><img src="doxygen.png" alt="doxygen" align="middle" border="0"></a> 1.7.3</small></address></body></html>