<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<html><head><meta http-equiv="Content-Type" content="text/html;charset=iso-8859-1">
<title>ID3_Tag class Reference</title>
<link href="id3lib.css" rel="stylesheet" type="text/css">
</head><body bgcolor="#ffffff">
<!-- Generated by Doxygen 1.2.12 -->
<center>
<a class="qindex" href="index.html">Main Page</a> <a class="qindex" href="namespaces.html">Namespace List</a> <a class="qindex" href="hierarchy.html">Class Hierarchy</a> <a class="qindex" href="annotated.html">Compound List</a> <a class="qindex" href="files.html">File List</a> <a class="qindex" href="namespacemembers.html">Namespace Members</a> <a class="qindex" href="functions.html">Compound Members</a> <a class="qindex" href="globals.html">File Members</a> </center>
<hr><h1>ID3_Tag Class Reference</h1>The representative class of an id3 tag.
<a href="#_details">More...</a>
<p>
<code>#include <<a class="el" href="tag_8h-source.html">id3/tag.h</a>></code>
<p>
<a href="class_i_d3___tag-members.html">List of all members.</a><table border=0 cellpadding=0 cellspacing=0>
<tr><td colspan=2><br><h2>Public Methods</h2></td></tr>
<tr><td nowrap align=right valign=top> </td><td valign=bottom><a class="el" href="class_i_d3___tag.html#a0">ID3_Tag</a> (const char *name=NULL)</td></tr>
<tr><td> </td><td><font size=-1><em>Default constructor; it can accept an optional filename as a parameter.</em> <a href="#a0">More...</a><em></em></font><br><br></td></tr>
<tr><td nowrap align=right valign=top> </td><td valign=bottom><a class="el" href="class_i_d3___tag.html#a1">ID3_Tag</a> (const ID3_Tag &tag)</td></tr>
<tr><td> </td><td><font size=-1><em>Standard copy constructor.</em> <a href="#a1">More...</a><em></em></font><br><br></td></tr>
<tr><td nowrap align=right valign=top>virtual </td><td valign=bottom><a class="el" href="class_i_d3___tag.html#a2">~ID3_Tag</a> ()</td></tr>
<tr><td nowrap align=right valign=top>void </td><td valign=bottom><a class="el" href="class_i_d3___tag.html#a3">Clear</a> ()</td></tr>
<tr><td> </td><td><font size=-1><em>Clears the object and disassociates it from any files.</em> <a href="#a3">More...</a><em></em></font><br><br></td></tr>
<tr><td nowrap align=right valign=top>bool </td><td valign=bottom><a class="el" href="class_i_d3___tag.html#a4">HasChanged</a> () const</td></tr>
<tr><td> </td><td><font size=-1><em>Indicates whether the tag has been altered since the last parse, render, or update.</em> <a href="#a4">More...</a><em></em></font><br><br></td></tr>
<tr><td nowrap align=right valign=top>size_t </td><td valign=bottom><a class="el" href="class_i_d3___tag.html#a5">Size</a> () const</td></tr>
<tr><td> </td><td><font size=-1><em>Returns an over estimate of the number of bytes required to store a binary version of a tag.</em> <a href="#a5">More...</a><em></em></font><br><br></td></tr>
<tr><td nowrap align=right valign=top>bool </td><td valign=bottom><a class="el" href="class_i_d3___tag.html#a6">SetUnsync</a> (bool)</td></tr>
<tr><td> </td><td><font size=-1><em>Turns unsynchronization on or off, dependant on the value of the boolean parameter.</em> <a href="#a6">More...</a><em></em></font><br><br></td></tr>
<tr><td nowrap align=right valign=top>bool </td><td valign=bottom><a class="el" href="class_i_d3___tag.html#a7">SetExtendedHeader</a> (bool)</td></tr>
<tr><td> </td><td><font size=-1><em>Turns extended header rendering on or off, dependant on the value of the boolean parameter.</em> <a href="#a7">More...</a><em></em></font><br><br></td></tr>
<tr><td nowrap align=right valign=top>bool </td><td valign=bottom><a class="el" href="class_i_d3___tag.html#a8">SetExperimental</a> (bool)</td></tr>
<tr><td nowrap align=right valign=top>bool </td><td valign=bottom><a class="el" href="class_i_d3___tag.html#a9">GetUnsync</a> () const</td></tr>
<tr><td nowrap align=right valign=top>bool </td><td valign=bottom><a class="el" href="class_i_d3___tag.html#a10">GetExtendedHeader</a> () const</td></tr>
<tr><td nowrap align=right valign=top>bool </td><td valign=bottom><a class="el" href="class_i_d3___tag.html#a11">GetExperimental</a> () const</td></tr>
<tr><td nowrap align=right valign=top>bool </td><td valign=bottom><a class="el" href="class_i_d3___tag.html#a12">SetPadding</a> (bool)</td></tr>
<tr><td> </td><td><font size=-1><em>Turns padding on or off, dependant on the value of the boolean parameter.</em> <a href="#a12">More...</a><em></em></font><br><br></td></tr>
<tr><td nowrap align=right valign=top>void </td><td valign=bottom><a class="el" href="class_i_d3___tag.html#a13">AddFrame</a> (const <a class="el" href="class_i_d3___frame.html">ID3_Frame</a> &)</td></tr>
<tr><td nowrap align=right valign=top>void </td><td valign=bottom><a class="el" href="class_i_d3___tag.html#a14">AddFrame</a> (const <a class="el" href="class_i_d3___frame.html">ID3_Frame</a> *)</td></tr>
<tr><td> </td><td><font size=-1><em>Attaches a frame to the tag; the tag doesn't take responsibility for releasing the frame's memory when tag goes out of scope.</em> <a href="#a14">More...</a><em></em></font><br><br></td></tr>
<tr><td nowrap align=right valign=top>void </td><td valign=bottom><a class="el" href="class_i_d3___tag.html#a15">AttachFrame</a> (<a class="el" href="class_i_d3___frame.html">ID3_Frame</a> *)</td></tr>
<tr><td> </td><td><font size=-1><em>Attaches a frame to the tag; the tag takes responsibility for releasing the frame's memory when tag goes out of scope.</em> <a href="#a15">More...</a><em></em></font><br><br></td></tr>
<tr><td nowrap align=right valign=top><a class="el" href="class_i_d3___frame.html">ID3_Frame</a> * </td><td valign=bottom><a class="el" href="class_i_d3___tag.html#a16">RemoveFrame</a> (const <a class="el" href="class_i_d3___frame.html">ID3_Frame</a> *)</td></tr>
<tr><td> </td><td><font size=-1><em>Removes a frame from the tag.</em> <a href="#a16">More...</a><em></em></font><br><br></td></tr>
<tr><td nowrap align=right valign=top>size_t </td><td valign=bottom><a class="el" href="class_i_d3___tag.html#a17">Parse</a> (const <a class="el" href="globals_8h.html#a33">uchar</a> *, size_t)</td></tr>
<tr><td nowrap align=right valign=top>bool </td><td valign=bottom><a class="el" href="class_i_d3___tag.html#a18">Parse</a> (<a class="el" href="class_i_d3___reader.html">ID3_Reader</a> &reader)</td></tr>
<tr><td nowrap align=right valign=top>size_t </td><td valign=bottom><a class="el" href="class_i_d3___tag.html#a19">Render</a> (<a class="el" href="globals_8h.html#a33">uchar</a> *, <a class="el" href="globals_8h.html#a217">ID3_TagType</a>=ID3TT_ID3V2) const</td></tr>
<tr><td> </td><td><font size=-1><em>Renders a binary image of the tag into the supplied buffer.</em> <a href="#a19">More...</a><em></em></font><br><br></td></tr>
<tr><td nowrap align=right valign=top>size_t </td><td valign=bottom><a class="el" href="class_i_d3___tag.html#a20">Render</a> (<a class="el" href="class_i_d3___writer.html">ID3_Writer</a> &, <a class="el" href="globals_8h.html#a217">ID3_TagType</a>=ID3TT_ID3V2) const</td></tr>
<tr><td nowrap align=right valign=top>size_t </td><td valign=bottom><a class="el" href="class_i_d3___tag.html#a21">Link</a> (const char *fileInfo, <a class="el" href="globals_8h.html#a40">flags_t</a>=(<a class="el" href="globals_8h.html#a40">flags_t</a>) ID3TT_ALL)</td></tr>
<tr><td> </td><td><font size=-1><em>Attaches a file to the tag, parses the file, and adds any tag information found in the file to the tag.</em> <a href="#a21">More...</a><em></em></font><br><br></td></tr>
<tr><td nowrap align=right valign=top><a class="el" href="globals_8h.html#a40">flags_t</a> </td><td valign=bottom><a class="el" href="class_i_d3___tag.html#a22">Update</a> (<a class="el" href="globals_8h.html#a40">flags_t</a>=(<a class="el" href="globals_8h.html#a40">flags_t</a>) ID3TT_ALL)</td></tr>
<tr><td nowrap align=right valign=top><a class="el" href="globals_8h.html#a40">flags_t</a> </td><td valign=bottom><a class="el" href="class_i_d3___tag.html#a23">Strip</a> (<a class="el" href="globals_8h.html#a40">flags_t</a>=(<a class="el" href="globals_8h.html#a40">flags_t</a>) ID3TT_ALL)</td></tr>
<tr><td> </td><td><font size=-1><em>Strips the tag(s) from the attached file.</em> <a href="#a23">More...</a><em></em></font><br><br></td></tr>
<tr><td nowrap align=right valign=top>size_t </td><td valign=bottom><a class="el" href="class_i_d3___tag.html#a24">GetPrependedBytes</a> () const</td></tr>
<tr><td nowrap align=right valign=top>size_t </td><td valign=bottom><a class="el" href="class_i_d3___tag.html#a25">GetAppendedBytes</a> () const</td></tr>
<tr><td nowrap align=right valign=top>size_t </td><td valign=bottom><a class="el" href="class_i_d3___tag.html#a26">GetFileSize</a> () const</td></tr>
<tr><td nowrap align=right valign=top>const char * </td><td valign=bottom><a class="el" href="class_i_d3___tag.html#a27">GetFileName</a> () const</td></tr>
<tr><td nowrap align=right valign=top><a class="el" href="class_i_d3___frame.html">ID3_Frame</a> * </td><td valign=bottom><a class="el" href="class_i_d3___tag.html#a28">Find</a> (<a class="el" href="globals_8h.html#a219">ID3_FrameID</a>) const</td></tr>
<tr><td nowrap align=right valign=top><a class="el" href="class_i_d3___frame.html">ID3_Frame</a> * </td><td valign=bottom><a class="el" href="class_i_d3___tag.html#a29">Find</a> (<a class="el" href="globals_8h.html#a219">ID3_FrameID</a>, <a class="el" href="globals_8h.html#a218">ID3_FieldID</a>, <a class="el" href="sized__types_8h.html#a4">uint32</a>) const</td></tr>
<tr><td> </td><td><font size=-1><em>Finds frame with given frame id, fld id, and integer data.</em> <a href="#a29">More...</a><em></em></font><br><br></td></tr>
<tr><td nowrap align=right valign=top><a class="el" href="class_i_d3___frame.html">ID3_Frame</a> * </td><td valign=bottom><a class="el" href="class_i_d3___tag.html#a30">Find</a> (<a class="el" href="globals_8h.html#a219">ID3_FrameID</a>, <a class="el" href="globals_8h.html#a218">ID3_FieldID</a>, const char *) const</td></tr>
<tr><td> </td><td><font size=-1><em>Finds frame with given frame id, fld id, and ascii data.</em> <a href="#a30">More...</a><em></em></font><br><br></td></tr>
<tr><td nowrap align=right valign=top><a class="el" href="class_i_d3___frame.html">ID3_Frame</a> * </td><td valign=bottom><a class="el" href="class_i_d3___tag.html#a31">Find</a> (<a class="el" href="globals_8h.html#a219">ID3_FrameID</a>, <a class="el" href="globals_8h.html#a218">ID3_FieldID</a>, const <a class="el" href="globals_8h.html#a39">unicode_t</a> *) const</td></tr>
<tr><td> </td><td><font size=-1><em>Finds frame with given frame id, fld id, and unicode data.</em> <a href="#a31">More...</a><em></em></font><br><br></td></tr>
<tr><td nowrap align=right valign=top>size_t </td><td valign=bottom><a class="el" href="class_i_d3___tag.html#a32">NumFrames</a> () const</td></tr>
<tr><td> </td><td><font size=-1><em>Returns the number of frames present in the tag object.</em> <a href="#a32">More...</a><em></em></font><br><br></td></tr>
<tr><td nowrap align=right valign=top><a class="el" href="class_i_d3___tag_1_1_iterator.html">Iterator</a> * </td><td valign=bottom><a class="el" href="class_i_d3___tag.html#a33">CreateIterator</a> ()</td></tr>
<tr><td nowrap align=right valign=top><a class="el" href="class_i_d3___tag_1_1_const_iterator.html">ConstIterator</a> * </td><td valign=bottom><a class="el" href="class_i_d3___tag.html#a34">CreateIterator</a> () const</td></tr>
<tr><td nowrap align=right valign=top>ID3_Tag & </td><td valign=bottom><a class="el" href="class_i_d3___tag.html#a35">operator=</a> (const ID3_Tag &)</td></tr>
<tr><td nowrap align=right valign=top>bool </td><td valign=bottom><a class="el" href="class_i_d3___tag.html#a36">HasTagType</a> (<a class="el" href="sized__types_8h.html#a2">uint16</a> tt) const</td></tr>
<tr><td nowrap align=right valign=top><a class="el" href="globals_8h.html#a216">ID3_V2Spec</a> </td><td valign=bottom><a class="el" href="class_i_d3___tag.html#a37">GetSpec</a> () const</td></tr>
<tr><td nowrap align=right valign=top>bool </td><td valign=bottom><a class="el" href="class_i_d3___tag.html#a38">SetSpec</a> (<a class="el" href="globals_8h.html#a216">ID3_V2Spec</a>)</td></tr>
<tr><td nowrap align=right valign=top>void </td><td valign=bottom><a class="el" href="class_i_d3___tag.html#a39">AddNewFrame</a> (<a class="el" href="class_i_d3___frame.html">ID3_Frame</a> *f)</td></tr>
<tr><td> </td><td><font size=-1><em>Deprecated.</em> <a href="#a39">More...</a><em></em></font><br><br></td></tr>
<tr><td nowrap align=right valign=top>size_t </td><td valign=bottom><a class="el" href="class_i_d3___tag.html#a40">Link</a> (const char *fileInfo, bool parseID3v1, bool parseLyrics3)</td></tr>
<tr><td nowrap align=right valign=top>void </td><td valign=bottom><a class="el" href="class_i_d3___tag.html#a41">SetCompression</a> (bool)</td></tr>
<tr><td nowrap align=right valign=top>void </td><td valign=bottom><a class="el" href="class_i_d3___tag.html#a42">AddFrames</a> (const <a class="el" href="class_i_d3___frame.html">ID3_Frame</a> *, size_t)</td></tr>
<tr><td> </td><td><font size=-1><em>Copies an array of frames to the tag.</em> <a href="#a42">More...</a><em></em></font><br><br></td></tr>
<tr><td nowrap align=right valign=top>bool </td><td valign=bottom><a class="el" href="class_i_d3___tag.html#a43">HasLyrics</a> () const</td></tr>
<tr><td nowrap align=right valign=top>bool </td><td valign=bottom><a class="el" href="class_i_d3___tag.html#a44">HasV2Tag</a> () const</td></tr>
<tr><td nowrap align=right valign=top>bool </td><td valign=bottom><a class="el" href="class_i_d3___tag.html#a45">HasV1Tag</a> () const</td></tr>
<tr><td nowrap align=right valign=top>size_t </td><td valign=bottom><a class="el" href="class_i_d3___tag.html#a46">Parse</a> (const <a class="el" href="globals_8h.html#a33">uchar</a> header[ID3_TAGHEADERSIZE], const <a class="el" href="globals_8h.html#a33">uchar</a> *buffer)</td></tr>
<tr><td> </td><td><font size=-1><em>Turns a binary tag into a series of <a class="el" href="class_i_d3___frame.html">ID3_Frame</a> objects attached to the tag.</em> <a href="#a46">More...</a><em></em></font><br><br></td></tr>
<tr><td nowrap align=right valign=top>ID3_Tag & </td><td valign=bottom><a class="el" href="class_i_d3___tag.html#a47">operator<<</a> (const <a class="el" href="class_i_d3___frame.html">ID3_Frame</a> &)</td></tr>
<tr><td nowrap align=right valign=top>ID3_Tag & </td><td valign=bottom><a class="el" href="class_i_d3___tag.html#a48">operator<<</a> (const <a class="el" href="class_i_d3___frame.html">ID3_Frame</a> *)</td></tr>
<tr><td nowrap align=right valign=top> </td><td valign=bottom><a class="el" href="class_i_d3___tag.html#a49">ID3_Tag</a> (const char *name=NULL)</td></tr>
<tr><td nowrap align=right valign=top> </td><td valign=bottom><a class="el" href="class_i_d3___tag.html#a50">ID3_Tag</a> (const ID3_Tag &tag)</td></tr>
<tr><td nowrap align=right valign=top>virtual </td><td valign=bottom><a class="el" href="class_i_d3___tag.html#a51">~ID3_Tag</a> ()</td></tr>
<tr><td nowrap align=right valign=top>void </td><td valign=bottom><a class="el" href="class_i_d3___tag.html#a52">Clear</a> ()</td></tr>
<tr><td nowrap align=right valign=top>bool </td><td valign=bottom><a class="el" href="class_i_d3___tag.html#a53">HasChanged</a> () const</td></tr>
<tr><td nowrap align=right valign=top>size_t </td><td valign=bottom><a class="el" href="class_i_d3___tag.html#a54">Size</a> () const</td></tr>
<tr><td nowrap align=right valign=top>bool </td><td valign=bottom><a class="el" href="class_i_d3___tag.html#a55">SetUnsync</a> (bool)</td></tr>
<tr><td nowrap align=right valign=top>bool </td><td valign=bottom><a class="el" href="class_i_d3___tag.html#a56">SetExtendedHeader</a> (bool)</td></tr>
<tr><td nowrap align=right valign=top>bool </td><td valign=bottom><a class="el" href="class_i_d3___tag.html#a57">SetExperimental</a> (bool)</td></tr>
<tr><td nowrap align=right valign=top>bool </td><td valign=bottom><a class="el" href="class_i_d3___tag.html#a58">GetUnsync</a> () const</td></tr>
<tr><td nowrap align=right valign=top>bool </td><td valign=bottom><a class="el" href="class_i_d3___tag.html#a59">GetExtendedHeader</a> () const</td></tr>
<tr><td nowrap align=right valign=top>bool </td><td valign=bottom><a class="el" href="class_i_d3___tag.html#a60">GetExperimental</a> () const</td></tr>
<tr><td nowrap align=right valign=top>bool </td><td valign=bottom><a class="el" href="class_i_d3___tag.html#a61">SetPadding</a> (bool)</td></tr>
<tr><td nowrap align=right valign=top>void </td><td valign=bottom><a class="el" href="class_i_d3___tag.html#a62">AddFrame</a> (const <a class="el" href="class_i_d3___frame.html">ID3_Frame</a> &)</td></tr>
<tr><td nowrap align=right valign=top>void </td><td valign=bottom><a class="el" href="class_i_d3___tag.html#a63">AddFrame</a> (const <a class="el" href="class_i_d3___frame.html">ID3_Frame</a> *)</td></tr>
<tr><td nowrap align=right valign=top>void </td><td valign=bottom><a class="el" href="class_i_d3___tag.html#a64">AttachFrame</a> (<a class="el" href="class_i_d3___frame.html">ID3_Frame</a> *)</td></tr>
<tr><td nowrap align=right valign=top><a class="el" href="class_i_d3___frame.html">ID3_Frame</a> * </td><td valign=bottom><a class="el" href="class_i_d3___tag.html#a65">RemoveFrame</a> (const <a class="el" href="class_i_d3___frame.html">ID3_Frame</a> *)</td></tr>
<tr><td nowrap align=right valign=top>size_t </td><td valign=bottom><a class="el" href="class_i_d3___tag.html#a66">Parse</a> (const <a class="el" href="globals_8h.html#a33">uchar</a> *, size_t)</td></tr>
<tr><td nowrap align=right valign=top>bool </td><td valign=bottom><a class="el" href="class_i_d3___tag.html#a67">Parse</a> (<a class="el" href="class_i_d3___reader.html">ID3_Reader</a> &reader)</td></tr>
<tr><td nowrap align=right valign=top>size_t </td><td valign=bottom><a class="el" href="class_i_d3___tag.html#a68">Render</a> (<a class="el" href="globals_8h.html#a33">uchar</a> *, <a class="el" href="globals_8h.html#a217">ID3_TagType</a>=ID3TT_ID3V2) const</td></tr>
<tr><td nowrap align=right valign=top>size_t </td><td valign=bottom><a class="el" href="class_i_d3___tag.html#a69">Render</a> (<a class="el" href="class_i_d3___writer.html">ID3_Writer</a> &, <a class="el" href="globals_8h.html#a217">ID3_TagType</a>=ID3TT_ID3V2) const</td></tr>
<tr><td nowrap align=right valign=top>size_t </td><td valign=bottom><a class="el" href="class_i_d3___tag.html#a70">Link</a> (const char *fileInfo, <a class="el" href="globals_8h.html#a40">flags_t</a>=(<a class="el" href="globals_8h.html#a40">flags_t</a>) ID3TT_ALL)</td></tr>
<tr><td nowrap align=right valign=top><a class="el" href="globals_8h.html#a40">flags_t</a> </td><td valign=bottom><a class="el" href="class_i_d3___tag.html#a71">Update</a> (<a class="el" href="globals_8h.html#a40">flags_t</a>=(<a class="el" href="globals_8h.html#a40">flags_t</a>) ID3TT_ALL)</td></tr>
<tr><td nowrap align=right valign=top><a class="el" href="globals_8h.html#a40">flags_t</a> </td><td valign=bottom><a class="el" href="class_i_d3___tag.html#a72">Strip</a> (<a class="el" href="globals_8h.html#a40">flags_t</a>=(<a class="el" href="globals_8h.html#a40">flags_t</a>) ID3TT_ALL)</td></tr>
<tr><td nowrap align=right valign=top>size_t </td><td valign=bottom><a class="el" href="class_i_d3___tag.html#a73">GetPrependedBytes</a> () const</td></tr>
<tr><td nowrap align=right valign=top>size_t </td><td valign=bottom><a class="el" href="class_i_d3___tag.html#a74">GetAppendedBytes</a> () const</td></tr>
<tr><td nowrap align=right valign=top>size_t </td><td valign=bottom><a class="el" href="class_i_d3___tag.html#a75">GetFileSize</a> () const</td></tr>
<tr><td nowrap align=right valign=top>const char * </td><td valign=bottom><a class="el" href="class_i_d3___tag.html#a76">GetFileName</a> () const</td></tr>
<tr><td nowrap align=right valign=top><a class="el" href="class_i_d3___frame.html">ID3_Frame</a> * </td><td valign=bottom><a class="el" href="class_i_d3___tag.html#a77">Find</a> (<a class="el" href="globals_8h.html#a219">ID3_FrameID</a>) const</td></tr>
<tr><td nowrap align=right valign=top><a class="el" href="class_i_d3___frame.html">ID3_Frame</a> * </td><td valign=bottom><a class="el" href="class_i_d3___tag.html#a78">Find</a> (<a class="el" href="globals_8h.html#a219">ID3_FrameID</a>, <a class="el" href="globals_8h.html#a218">ID3_FieldID</a>, <a class="el" href="sized__types_8h.html#a4">uint32</a>) const</td></tr>
<tr><td nowrap align=right valign=top><a class="el" href="class_i_d3___frame.html">ID3_Frame</a> * </td><td valign=bottom><a class="el" href="class_i_d3___tag.html#a79">Find</a> (<a class="el" href="globals_8h.html#a219">ID3_FrameID</a>, <a class="el" href="globals_8h.html#a218">ID3_FieldID</a>, const char *) const</td></tr>
<tr><td nowrap align=right valign=top><a class="el" href="class_i_d3___frame.html">ID3_Frame</a> * </td><td valign=bottom><a class="el" href="class_i_d3___tag.html#a80">Find</a> (<a class="el" href="globals_8h.html#a219">ID3_FrameID</a>, <a class="el" href="globals_8h.html#a218">ID3_FieldID</a>, const <a class="el" href="globals_8h.html#a39">unicode_t</a> *) const</td></tr>
<tr><td nowrap align=right valign=top>size_t </td><td valign=bottom><a class="el" href="class_i_d3___tag.html#a81">NumFrames</a> () const</td></tr>
<tr><td nowrap align=right valign=top><a class="el" href="class_i_d3___tag_1_1_iterator.html">Iterator</a> * </td><td valign=bottom><a class="el" href="class_i_d3___tag.html#a82">CreateIterator</a> ()</td></tr>
<tr><td nowrap align=right valign=top><a class="el" href="class_i_d3___tag_1_1_const_iterator.html">ConstIterator</a> * </td><td valign=bottom><a class="el" href="class_i_d3___tag.html#a83">CreateIterator</a> () const</td></tr>
<tr><td nowrap align=right valign=top>ID3_Tag & </td><td valign=bottom><a class="el" href="class_i_d3___tag.html#a84">operator=</a> (const ID3_Tag &)</td></tr>
<tr><td nowrap align=right valign=top>bool </td><td valign=bottom><a class="el" href="class_i_d3___tag.html#a85">HasTagType</a> (<a class="el" href="sized__types_8h.html#a2">uint16</a> tt) const</td></tr>
<tr><td nowrap align=right valign=top><a class="el" href="globals_8h.html#a216">ID3_V2Spec</a> </td><td valign=bottom><a class="el" href="class_i_d3___tag.html#a86">GetSpec</a> () const</td></tr>
<tr><td nowrap align=right valign=top>bool </td><td valign=bottom><a class="el" href="class_i_d3___tag.html#a87">SetSpec</a> (<a class="el" href="globals_8h.html#a216">ID3_V2Spec</a>)</td></tr>
<tr><td nowrap align=right valign=top>void </td><td valign=bottom><a class="el" href="class_i_d3___tag.html#a88">AddNewFrame</a> (<a class="el" href="class_i_d3___frame.html">ID3_Frame</a> *f)</td></tr>
<tr><td nowrap align=right valign=top>size_t </td><td valign=bottom><a class="el" href="class_i_d3___tag.html#a89">Link</a> (const char *fileInfo, bool parseID3v1, bool parseLyrics3)</td></tr>
<tr><td nowrap align=right valign=top>void </td><td valign=bottom><a class="el" href="class_i_d3___tag.html#a90">SetCompression</a> (bool)</td></tr>
<tr><td nowrap align=right valign=top>void </td><td valign=bottom><a class="el" href="class_i_d3___tag.html#a91">AddFrames</a> (const <a class="el" href="class_i_d3___frame.html">ID3_Frame</a> *, size_t)</td></tr>
<tr><td nowrap align=right valign=top>bool </td><td valign=bottom><a class="el" href="class_i_d3___tag.html#a92">HasLyrics</a> () const</td></tr>
<tr><td nowrap align=right valign=top>bool </td><td valign=bottom><a class="el" href="class_i_d3___tag.html#a93">HasV2Tag</a> () const</td></tr>
<tr><td nowrap align=right valign=top>bool </td><td valign=bottom><a class="el" href="class_i_d3___tag.html#a94">HasV1Tag</a> () const</td></tr>
<tr><td nowrap align=right valign=top>size_t </td><td valign=bottom><a class="el" href="class_i_d3___tag.html#a95">Parse</a> (const <a class="el" href="globals_8h.html#a33">uchar</a> header[ID3_TAGHEADERSIZE], const <a class="el" href="globals_8h.html#a33">uchar</a> *buffer)</td></tr>
<tr><td nowrap align=right valign=top>ID3_Tag & </td><td valign=bottom><a class="el" href="class_i_d3___tag.html#a96">operator<<</a> (const <a class="el" href="class_i_d3___frame.html">ID3_Frame</a> &)</td></tr>
<tr><td nowrap align=right valign=top>ID3_Tag & </td><td valign=bottom><a class="el" href="class_i_d3___tag.html#a97">operator<<</a> (const <a class="el" href="class_i_d3___frame.html">ID3_Frame</a> *)</td></tr>
<tr><td colspan=2><br><h2>Static Public Methods</h2></td></tr>
<tr><td nowrap align=right valign=top>size_t </td><td valign=bottom><a class="el" href="class_i_d3___tag.html#d0">IsV2Tag</a> (const <a class="el" href="globals_8h.html#a33">uchar</a> *)</td></tr>
<tr><td nowrap align=right valign=top>size_t </td><td valign=bottom><a class="el" href="class_i_d3___tag.html#d1">IsV2Tag</a> (<a class="el" href="class_i_d3___reader.html">ID3_Reader</a> &)</td></tr>
<tr><td nowrap align=right valign=top>size_t </td><td valign=bottom><a class="el" href="class_i_d3___tag.html#d2">IsV2Tag</a> (const <a class="el" href="globals_8h.html#a33">uchar</a> *)</td></tr>
<tr><td nowrap align=right valign=top>size_t </td><td valign=bottom><a class="el" href="class_i_d3___tag.html#d3">IsV2Tag</a> (<a class="el" href="class_i_d3___reader.html">ID3_Reader</a> &)</td></tr>
</table>
<hr><a name="_details"></a><h2>Detailed Description</h2>
The representative class of an id3 tag.
<p>
The ID3_Tag is, at its simplest, a container for ID3v2 frames. At its most complicated, it's a kitchen-sink, monolithic "catch-all" class for handling almost every task associated with creating, parsing, rendering, and manipulating digital audio data using id3lib.
<p>
This simple <code>#include</code> does it all. In order to read an existing tag, do the following:
<p>
<div class="fragment"><pre> <a class="code" href="class_i_d3___tag.html">ID3_Tag</a> myTag;
myTag.<a class="code" href="class_i_d3___tag.html#a21">Link</a>(<font class="stringliteral">"something.mp3"</font>);
</pre></div>
<p>
That is all there is to it. Now all you have to do is use the <a class="el" href="class_i_d3___tag.html#a28">Find</a>() method to locate the frames you are interested in is the following:
<p>
<div class="fragment"><pre> <a class="code" href="class_i_d3___frame.html">ID3_Frame</a>* myFrame = myTag.<a class="code" href="class_i_d3___tag.html#a28">Find</a>(<a class="code" href="globals_8h.html#a219a131">ID3FID_TITLE</a>);
<font class="keywordflow">if</font> (<a class="code" href="globals_8h.html#a24">NULL</a> != myFrame)
{
<font class="keyword">const</font> <font class="keywordtype">char</font>* title = myFrame-><a class="code" href="class_i_d3___frame.html#a6">GetField</a>(ID3FN_TEXT)->GetText();
cout << <font class="stringliteral">"Title: "</font> << title << endl;
}
</pre></div>
<p>
This code snippet locates the ID3FID_TITLE frame and displays the text field.
<p>
When using the <a class="el" href="class_i_d3___tag.html#a21">ID3_Tag::Link</a>() method, you automatically gain access to any ID3v1/1.1, ID3v2, Lyrics3 v2.0, and MusicMatch tags present in the file. The class will automaticaly parse and convert any of these foreign tag formats into ID3v2 tags. Also, id3lib will correctly parse any correctly formatted 'CDM' frames from the unreleased ID3v2 2.01 draft specification.
<p>
<dl compact><dt><b>
Author: </b><dd>
Dirk Mahoney </dl><dl compact><dt><b>
Version: </b><dd>
</dl><dl compact><dt><b>
Id: </b><dd>
tag.cpp,v 1.42 2001/12/16 09:25:32 shadrack Exp </dl> <dl compact><dt><b>
See also: </b><dd>
<a class="el" href="class_i_d3___frame.html">ID3_Frame</a> , <a class="el" href="class_i_d3___field.html">ID3_Field</a> , <a class="el" href="globals_8h.html#a223">ID3_Err</a> </dl>
<p>
<p>
Definition at line <a class="el" href="tag_8h-source.html#l00039">39</a> of file <a class="el" href="tag_8h-source.html">tag.h</a>.<hr><h2>Constructor & Destructor Documentation</h2>
<a name="a0" doxytag="ID3_Tag::ID3_Tag"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> ID3_Tag::ID3_Tag </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top">const char * </td>
<td class="mdname1" valign="top" nowrap> <em>name</em> = NULL </td>
<td class="md" valign="top">) </td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
Default constructor; it can accept an optional filename as a parameter.
<p>
If this file exists, it will be opened and all id3lib-supported tags will be parsed and converted to ID3v2 if necessary. After the conversion, the file will remain unchanged, and will continue to do so until you use the <a class="el" href="class_i_d3___tag.html#a22">Update</a>() method on the tag (if you choose to <a class="el" href="class_i_d3___tag.html#a22">Update</a>() at all).<dl compact><dt><b>
Parameters: </b><dd>
<table border=0 cellspacing=2 cellpadding=0>
<tr><td valign=top><em>name</em> </td><td>
The filename of the mp3 file to link to </td></tr>
</table>
</dl>
<p>
Definition at line <a class="el" href="tag_8cpp-source.html#l00295">295</a> of file <a class="el" href="tag_8cpp-source.html">tag.cpp</a>. </td>
</tr>
</table>
<a name="a1" doxytag="ID3_Tag::ID3_Tag"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> ID3_Tag::ID3_Tag </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top">const ID3_Tag & </td>
<td class="mdname1" valign="top" nowrap> <em>tag</em> </td>
<td class="md" valign="top">) </td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
Standard copy constructor.
<p>
<dl compact><dt><b>
Parameters: </b><dd>
<table border=0 cellspacing=2 cellpadding=0>
<tr><td valign=top><em>tag</em> </td><td>
What is copied into this tag </td></tr>
</table>
</dl>
<p>
Definition at line <a class="el" href="tag_8cpp-source.html#l00304">304</a> of file <a class="el" href="tag_8cpp-source.html">tag.cpp</a>. </td>
</tr>
</table>
<a name="a2" doxytag="ID3_Tag::~ID3_Tag"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> ID3_Tag::~ID3_Tag </td>
<td class="md" valign="top">( </td>
<td class="mdname1" valign="top" nowrap> </td>
<td class="md" valign="top">) </td>
<td class="md" nowrap><code> [virtual]</code></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
<p>
Definition at line <a class="el" href="tag_8cpp-source.html#l00309">309</a> of file <a class="el" href="tag_8cpp-source.html">tag.cpp</a>. </td>
</tr>
</table>
<a name="a49" doxytag="ID3_Tag::ID3_Tag"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> ID3_Tag::ID3_Tag </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top">const char * </td>
<td class="mdname1" valign="top" nowrap> <em>name</em> = NULL </td>
<td class="md" valign="top">) </td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
</td>
</tr>
</table>
<a name="a50" doxytag="ID3_Tag::ID3_Tag"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> ID3_Tag::ID3_Tag </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top">const ID3_Tag & </td>
<td class="mdname1" valign="top" nowrap> <em>tag</em> </td>
<td class="md" valign="top">) </td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
</td>
</tr>
</table>
<a name="a51" doxytag="ID3_Tag::~ID3_Tag"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> virtual ID3_Tag::~ID3_Tag </td>
<td class="md" valign="top">( </td>
<td class="mdname1" valign="top" nowrap> </td>
<td class="md" valign="top">) </td>
<td class="md" nowrap><code> [virtual]</code></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
</td>
</tr>
</table>
<hr><h2>Member Function Documentation</h2>
<a name="a63" doxytag="ID3_Tag::AddFrame"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> void ID3_Tag::AddFrame </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top">const <a class="el" href="class_i_d3___frame.html">ID3_Frame</a> * </td>
<td class="mdname1" valign="top" nowrap> </td>
<td class="md" valign="top">) </td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
</td>
</tr>
</table>
<a name="a62" doxytag="ID3_Tag::AddFrame"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> void ID3_Tag::AddFrame </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top">const <a class="el" href="class_i_d3___frame.html">ID3_Frame</a> & </td>
<td class="mdname1" valign="top" nowrap> </td>
<td class="md" valign="top">) </td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
</td>
</tr>
</table>
<a name="a14" doxytag="ID3_Tag::AddFrame"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> void ID3_Tag::AddFrame </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top">const <a class="el" href="class_i_d3___frame.html">ID3_Frame</a> * </td>
<td class="mdname1" valign="top" nowrap> <em>frame</em> </td>
<td class="md" valign="top">) </td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
Attaches a frame to the tag; the tag doesn't take responsibility for releasing the frame's memory when tag goes out of scope.
<p>
Optionally, operator<< can also be used to attach a frame to a tag. To use, simply supply its parameter a pointer to the <a class="el" href="class_i_d3___frame.html">ID3_Frame</a> object you wish to attach.
<p>
<div class="fragment"><pre> <a class="code" href="class_i_d3___frame.html">ID3_Frame</a> myFrame;
myTag.AddFrame(&myFrame);
</pre></div>
<p>
As stated, this method attaches the frames to the tag---the tag does not create its own copy of the frame. Frames created by an application must exist until the frame is removed or the tag is finished with it.<dl compact><dt><b>
Parameters: </b><dd>
<table border=0 cellspacing=2 cellpadding=0>
<tr><td valign=top><em>pFrame</em> </td><td>
A pointer to the frame that is being added to the tag. </td></tr>
</table>
</dl><dl compact><dt><b>
See also: </b><dd>
<a class="el" href="class_i_d3___frame.html">ID3_Frame</a> </dl>
<p>
Definition at line <a class="el" href="tag_8cpp-source.html#l00508">508</a> of file <a class="el" href="tag_8cpp-source.html">tag.cpp</a>.
<p>
References <a class="el" href="tag__impl_8cpp-source.html#l00155">ID3_TagImpl::AddFrame</a>(). </td>
</tr>
</table>
<a name="a13" doxytag="ID3_Tag::AddFrame"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> void ID3_Tag::AddFrame </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top">const <a class="el" href="class_i_d3___frame.html">ID3_Frame</a> & </td>
<td class="mdname1" valign="top" nowrap> <em>frame</em> </td>
<td class="md" valign="top">) </td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
<p>
Definition at line <a class="el" href="tag_8cpp-source.html#l00484">484</a> of file <a class="el" href="tag_8cpp-source.html">tag.cpp</a>.
<p>
References <a class="el" href="tag__impl_8cpp-source.html#l00155">ID3_TagImpl::AddFrame</a>().
<p>
Referenced by <a class="el" href="tag_8cpp-source.html#l00968">AddFrames</a>(), and <a class="el" href="tag_8cpp-source.html#l01018">operator<<</a>(). </td>
</tr>
</table>
<a name="a91" doxytag="ID3_Tag::AddFrames"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> void ID3_Tag::AddFrames </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top">const <a class="el" href="class_i_d3___frame.html">ID3_Frame</a> * </td>
<td class="mdname" nowrap> , </td>
</tr>
<tr>
<td></td>
<td></td>
<td class="md" nowrap>size_t </td>
<td class="mdname" nowrap> </td>
</tr>
<tr>
<td></td>
<td class="md">) </td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
</td>
</tr>
</table>
<a name="a42" doxytag="ID3_Tag::AddFrames"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> void ID3_Tag::AddFrames </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top">const <a class="el" href="class_i_d3___frame.html">ID3_Frame</a> * </td>
<td class="mdname" nowrap> <em>frames</em>, </td>
</tr>
<tr>
<td></td>
<td></td>
<td class="md" nowrap>size_t </td>
<td class="mdname" nowrap> <em>numFrames</em></td>
</tr>
<tr>
<td></td>
<td class="md">) </td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
Copies an array of frames to the tag.
<p>
This method copies each frame in an array to the tag. As in AddFrame, the tag adds a copy of the frame, and it assumes responsiblity for freeing the frames' memory when the tag goes out of scope.
<p>
<div class="fragment"><pre> <a class="code" href="class_i_d3___frame.html">ID3_Frame</a> myFrames[10];
myTag.AddFrames(myFrames, 10);
</pre></div>
<p>
<dl compact><dt><b>
See also: </b><dd>
<a class="el" href="class_i_d3___frame.html">ID3_Frame</a> , ID3_Frame::AddFrame </dl><dl compact><dt><b>
Parameters: </b><dd>
<table border=0 cellspacing=2 cellpadding=0>
<tr><td valign=top><em>pNewFrames</em> </td><td>
A pointer to an array of frames to be added to the tag. </td></tr>
<tr><td valign=top><em>nFrames</em> </td><td>
The number of frames in the array pNewFrames. </td></tr>
</table>
</dl>
<p>
Definition at line <a class="el" href="tag_8cpp-source.html#l00968">968</a> of file <a class="el" href="tag_8cpp-source.html">tag.cpp</a>.
<p>
References <a class="el" href="tag_8cpp-source.html#l00484">AddFrame</a>(). </td>
</tr>
</table>
<a name="a88" doxytag="ID3_Tag::AddNewFrame"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> void ID3_Tag::AddNewFrame </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="class_i_d3___frame.html">ID3_Frame</a> * </td>
<td class="mdname1" valign="top" nowrap> <em>f</em> </td>
<td class="md" valign="top">) </td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
</td>
</tr>
</table>
<a name="a39" doxytag="ID3_Tag::AddNewFrame"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> void ID3_Tag::AddNewFrame </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="class_i_d3___frame.html">ID3_Frame</a> * </td>
<td class="mdname1" valign="top" nowrap> <em>f</em> </td>
<td class="md" valign="top">) </td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
Deprecated.
<p>
<p>
Definition at line <a class="el" href="tag_8cpp-source.html#l00947">947</a> of file <a class="el" href="tag_8cpp-source.html">tag.cpp</a>.
<p>
References <a class="el" href="tag__impl_8cpp-source.html#l00169">ID3_TagImpl::AttachFrame</a>(). </td>
</tr>
</table>
<a name="a64" doxytag="ID3_Tag::AttachFrame"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> void ID3_Tag::AttachFrame </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="class_i_d3___frame.html">ID3_Frame</a> * </td>
<td class="mdname1" valign="top" nowrap> </td>
<td class="md" valign="top">) </td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
</td>
</tr>
</table>
<a name="a15" doxytag="ID3_Tag::AttachFrame"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> void ID3_Tag::AttachFrame </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="class_i_d3___frame.html">ID3_Frame</a> * </td>
<td class="mdname1" valign="top" nowrap> <em>frame</em> </td>
<td class="md" valign="top">) </td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
Attaches a frame to the tag; the tag takes responsibility for releasing the frame's memory when tag goes out of scope.
<p>
This method accepts responsibility for the attached frame's memory, and will delete the frame and its contents when the tag goes out of scope or is deleted. Therefore, be sure the frame isn't "Attached" to other tags.
<p>
<div class="fragment"><pre> <a class="code" href="class_i_d3___frame.html">ID3_Frame</a> *frame = <font class="keyword">new</font> <a class="code" href="class_i_d3___frame.html">ID3_Frame</a>;
myTag.AttachFrame(frame);
</pre></div><dl compact><dt><b>
Parameters: </b><dd>
<table border=0 cellspacing=2 cellpadding=0>
<tr><td valign=top><em>frame</em> </td><td>
A pointer to the frame that is being added to the tag. </td></tr>
</table>
</dl>
<p>
Definition at line <a class="el" href="tag_8cpp-source.html#l00527">527</a> of file <a class="el" href="tag_8cpp-source.html">tag.cpp</a>.
<p>
References <a class="el" href="tag__impl_8cpp-source.html#l00169">ID3_TagImpl::AttachFrame</a>().
<p>
Referenced by <a class="el" href="misc__support_8cpp-source.html#l00178">ID3_AddAlbum</a>(), <a class="el" href="misc__support_8cpp-source.html#l00097">ID3_AddArtist</a>(), <a class="el" href="misc__support_8cpp-source.html#l00379">ID3_AddComment</a>(), <a class="el" href="misc__support_8cpp-source.html#l00606">ID3_AddGenre</a>(), <a class="el" href="misc__support_8cpp-source.html#l00741">ID3_AddLyricist</a>(), <a class="el" href="misc__support_8cpp-source.html#l00679">ID3_AddLyrics</a>(), <a class="el" href="misc__support_8cpp-source.html#l00805">ID3_AddSyncLyrics</a>(), <a class="el" href="misc__support_8cpp-source.html#l00237">ID3_AddTitle</a>(), <a class="el" href="misc__support_8cpp-source.html#l00503">ID3_AddTrack</a>(), and <a class="el" href="misc__support_8cpp-source.html#l00296">ID3_AddYear</a>(). </td>
</tr>
</table>
<a name="a52" doxytag="ID3_Tag::Clear"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> void ID3_Tag::Clear </td>
<td class="md" valign="top">( </td>
<td class="mdname1" valign="top" nowrap> </td>
<td class="md" valign="top">) </td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
</td>
</tr>
</table>
<a name="a3" doxytag="ID3_Tag::Clear"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> void ID3_Tag::Clear </td>
<td class="md" valign="top">( </td>
<td class="mdname1" valign="top" nowrap> </td>
<td class="md" valign="top">) </td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
Clears the object and disassociates it from any files.
<p>
Frees any resources for which the object is responsible, including all frames and files. After a call to <a class="el" href="class_i_d3___tag.html#a3">Clear</a>(), the object can be used again for any new or existing tag.
<p>
Definition at line <a class="el" href="tag_8cpp-source.html#l00320">320</a> of file <a class="el" href="tag_8cpp-source.html">tag.cpp</a>.
<p>
References <a class="el" href="tag__impl_8cpp-source.html#l00132">ID3_TagImpl::Clear</a>(). </td>
</tr>
</table>
<a name="a83" doxytag="ID3_Tag::CreateIterator"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> <a class="el" href="class_i_d3___tag_1_1_const_iterator.html">ConstIterator</a>* ID3_Tag::CreateIterator </td>
<td class="md" valign="top">( </td>
<td class="mdname1" valign="top" nowrap> </td>
<td class="md" valign="top">) </td>
<td class="md" nowrap> const</td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
</td>
</tr>
</table>
<a name="a82" doxytag="ID3_Tag::CreateIterator"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> <a class="el" href="class_i_d3___tag_1_1_iterator.html">Iterator</a>* ID3_Tag::CreateIterator </td>
<td class="md" valign="top">( </td>
<td class="mdname1" valign="top" nowrap> </td>
<td class="md" valign="top">) </td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
</td>
</tr>
</table>
<a name="a34" doxytag="ID3_Tag::CreateIterator"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> <a class="el" href="class_i_d3___tag_1_1_const_iterator.html">ID3_Tag::ConstIterator</a> * ID3_Tag::CreateIterator </td>
<td class="md" valign="top">( </td>
<td class="mdname1" valign="top" nowrap> </td>
<td class="md" valign="top">) </td>
<td class="md" nowrap> const</td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
<p>
Definition at line <a class="el" href="tag_8cpp-source.html#l01101">1101</a> of file <a class="el" href="tag_8cpp-source.html">tag.cpp</a>. </td>
</tr>
</table>
<a name="a33" doxytag="ID3_Tag::CreateIterator"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> <a class="el" href="class_i_d3___tag_1_1_iterator.html">ID3_Tag::Iterator</a> * ID3_Tag::CreateIterator </td>
<td class="md" valign="top">( </td>
<td class="mdname1" valign="top" nowrap> </td>
<td class="md" valign="top">) </td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
<p>
Definition at line <a class="el" href="tag_8cpp-source.html#l01095">1095</a> of file <a class="el" href="tag_8cpp-source.html">tag.cpp</a>.
<p>
Referenced by <a class="el" href="misc__support_8cpp-source.html#l00379">ID3_AddComment</a>(), <a class="el" href="misc__support_8cpp-source.html#l00433">ID3_RemoveComments</a>(), and <a class="el" href="tag__impl_8cpp-source.html#l00288">ID3_TagImpl::operator=</a>(). </td>
</tr>
</table>
<a name="a80" doxytag="ID3_Tag::Find"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> <a class="el" href="class_i_d3___frame.html">ID3_Frame</a>* ID3_Tag::Find </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="globals_8h.html#a219">ID3_FrameID</a> </td>
<td class="mdname" nowrap> , </td>
</tr>
<tr>
<td></td>
<td></td>
<td class="md" nowrap><a class="el" href="globals_8h.html#a218">ID3_FieldID</a> </td>
<td class="mdname" nowrap> , </td>
</tr>
<tr>
<td></td>
<td></td>
<td class="md" nowrap>const <a class="el" href="globals_8h.html#a39">unicode_t</a> * </td>
<td class="mdname" nowrap> </td>
</tr>
<tr>
<td></td>
<td class="md">) </td>
<td class="md" colspan="2"> const</td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
</td>
</tr>
</table>
<a name="a79" doxytag="ID3_Tag::Find"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> <a class="el" href="class_i_d3___frame.html">ID3_Frame</a>* ID3_Tag::Find </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="globals_8h.html#a219">ID3_FrameID</a> </td>
<td class="mdname" nowrap> , </td>
</tr>
<tr>
<td></td>
<td></td>
<td class="md" nowrap><a class="el" href="globals_8h.html#a218">ID3_FieldID</a> </td>
<td class="mdname" nowrap> , </td>
</tr>
<tr>
<td></td>
<td></td>
<td class="md" nowrap>const char * </td>
<td class="mdname" nowrap> </td>
</tr>
<tr>
<td></td>
<td class="md">) </td>
<td class="md" colspan="2"> const</td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
</td>
</tr>
</table>
<a name="a78" doxytag="ID3_Tag::Find"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> <a class="el" href="class_i_d3___frame.html">ID3_Frame</a>* ID3_Tag::Find </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="globals_8h.html#a219">ID3_FrameID</a> </td>
<td class="mdname" nowrap> , </td>
</tr>
<tr>
<td></td>
<td></td>
<td class="md" nowrap><a class="el" href="globals_8h.html#a218">ID3_FieldID</a> </td>
<td class="mdname" nowrap> , </td>
</tr>
<tr>
<td></td>
<td></td>
<td class="md" nowrap><a class="el" href="sized__types_8h.html#a4">uint32</a> </td>
<td class="mdname" nowrap> </td>
</tr>
<tr>
<td></td>
<td class="md">) </td>
<td class="md" colspan="2"> const</td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
</td>
</tr>
</table>
<a name="a77" doxytag="ID3_Tag::Find"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> <a class="el" href="class_i_d3___frame.html">ID3_Frame</a>* ID3_Tag::Find </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="globals_8h.html#a219">ID3_FrameID</a> </td>
<td class="mdname1" valign="top" nowrap> </td>
<td class="md" valign="top">) </td>
<td class="md" nowrap> const</td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
</td>
</tr>
</table>
<a name="a31" doxytag="ID3_Tag::Find"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> <a class="el" href="class_i_d3___frame.html">ID3_Frame</a> * ID3_Tag::Find </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="globals_8h.html#a219">ID3_FrameID</a> </td>
<td class="mdname" nowrap> <em>id</em>, </td>
</tr>
<tr>
<td></td>
<td></td>
<td class="md" nowrap><a class="el" href="globals_8h.html#a218">ID3_FieldID</a> </td>
<td class="mdname" nowrap> <em>fld</em>, </td>
</tr>
<tr>
<td></td>
<td></td>
<td class="md" nowrap>const <a class="el" href="globals_8h.html#a39">unicode_t</a> * </td>
<td class="mdname" nowrap> <em>data</em></td>
</tr>
<tr>
<td></td>
<td class="md">) </td>
<td class="md" colspan="2"> const</td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
Finds frame with given frame id, fld id, and unicode data.
<p>
<p>
Definition at line <a class="el" href="tag_8cpp-source.html#l00835">835</a> of file <a class="el" href="tag_8cpp-source.html">tag.cpp</a>.
<p>
References <a class="el" href="tag__find_8cpp-source.html#l00071">ID3_TagImpl::Find</a>(), <a class="el" href="globals_8h-source.html#l00175">ID3_FieldID</a>, <a class="el" href="globals_8h-source.html#l00207">ID3_FrameID</a>, and <a class="el" href="globals_8h-source.html#l00094">unicode_t</a>. </td>
</tr>
</table>
<a name="a30" doxytag="ID3_Tag::Find"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> <a class="el" href="class_i_d3___frame.html">ID3_Frame</a> * ID3_Tag::Find </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="globals_8h.html#a219">ID3_FrameID</a> </td>
<td class="mdname" nowrap> <em>id</em>, </td>
</tr>
<tr>
<td></td>
<td></td>
<td class="md" nowrap><a class="el" href="globals_8h.html#a218">ID3_FieldID</a> </td>
<td class="mdname" nowrap> <em>fld</em>, </td>
</tr>
<tr>
<td></td>
<td></td>
<td class="md" nowrap>const char * </td>
<td class="mdname" nowrap> <em>data</em></td>
</tr>
<tr>
<td></td>
<td class="md">) </td>
<td class="md" colspan="2"> const</td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
Finds frame with given frame id, fld id, and ascii data.
<p>
<p>
Definition at line <a class="el" href="tag_8cpp-source.html#l00828">828</a> of file <a class="el" href="tag_8cpp-source.html">tag.cpp</a>.
<p>
References <a class="el" href="tag__find_8cpp-source.html#l00071">ID3_TagImpl::Find</a>(), <a class="el" href="globals_8h-source.html#l00175">ID3_FieldID</a>, and <a class="el" href="globals_8h-source.html#l00207">ID3_FrameID</a>. </td>
</tr>
</table>
<a name="a29" doxytag="ID3_Tag::Find"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> <a class="el" href="class_i_d3___frame.html">ID3_Frame</a> * ID3_Tag::Find </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="globals_8h.html#a219">ID3_FrameID</a> </td>
<td class="mdname" nowrap> <em>id</em>, </td>
</tr>
<tr>
<td></td>
<td></td>
<td class="md" nowrap><a class="el" href="globals_8h.html#a218">ID3_FieldID</a> </td>
<td class="mdname" nowrap> <em>fld</em>, </td>
</tr>
<tr>
<td></td>
<td></td>
<td class="md" nowrap><a class="el" href="sized__types_8h.html#a4">uint32</a> </td>
<td class="mdname" nowrap> <em>data</em></td>
</tr>
<tr>
<td></td>
<td class="md">) </td>
<td class="md" colspan="2"> const</td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
Finds frame with given frame id, fld id, and integer data.
<p>
<p>
Definition at line <a class="el" href="tag_8cpp-source.html#l00822">822</a> of file <a class="el" href="tag_8cpp-source.html">tag.cpp</a>.
<p>
References <a class="el" href="tag__find_8cpp-source.html#l00071">ID3_TagImpl::Find</a>(), <a class="el" href="globals_8h-source.html#l00175">ID3_FieldID</a>, <a class="el" href="globals_8h-source.html#l00207">ID3_FrameID</a>, and <a class="el" href="sized__types_8h-source.html#l00069">uint32</a>. </td>
</tr>
</table>
<a name="a28" doxytag="ID3_Tag::Find"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> <a class="el" href="class_i_d3___frame.html">ID3_Frame</a> * ID3_Tag::Find </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="globals_8h.html#a219">ID3_FrameID</a> </td>
<td class="mdname1" valign="top" nowrap> <em>id</em> </td>
<td class="md" valign="top">) </td>
<td class="md" nowrap> const</td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
<p>
Definition at line <a class="el" href="tag_8cpp-source.html#l00816">816</a> of file <a class="el" href="tag_8cpp-source.html">tag.cpp</a>.
<p>
References <a class="el" href="tag__find_8cpp-source.html#l00071">ID3_TagImpl::Find</a>(), and <a class="el" href="globals_8h-source.html#l00207">ID3_FrameID</a>.
<p>
Referenced by <a class="el" href="misc__support_8cpp-source.html#l00178">ID3_AddAlbum</a>(), <a class="el" href="misc__support_8cpp-source.html#l00097">ID3_AddArtist</a>(), <a class="el" href="misc__support_8cpp-source.html#l00606">ID3_AddGenre</a>(), <a class="el" href="misc__support_8cpp-source.html#l00741">ID3_AddLyricist</a>(), <a class="el" href="misc__support_8cpp-source.html#l00679">ID3_AddLyrics</a>(), <a class="el" href="misc__support_8cpp-source.html#l00805">ID3_AddSyncLyrics</a>(), <a class="el" href="misc__support_8cpp-source.html#l00237">ID3_AddTitle</a>(), <a class="el" href="misc__support_8cpp-source.html#l00503">ID3_AddTrack</a>(), <a class="el" href="misc__support_8cpp-source.html#l00296">ID3_AddYear</a>(), <a class="el" href="misc__support_8cpp-source.html#l00162">ID3_GetAlbum</a>(), <a class="el" href="misc__support_8cpp-source.html#l00078">ID3_GetArtist</a>(), <a class="el" href="misc__support_8cpp-source.html#l00339">ID3_GetComment</a>(), <a class="el" href="misc__support_8cpp-source.html#l00560">ID3_GetGenre</a>(), <a class="el" href="misc__support_8cpp-source.html#l00725">ID3_GetLyricist</a>(), <a class="el" href="misc__support_8cpp-source.html#l00652">ID3_GetLyrics</a>(), <a class="el" href="misc__support_8cpp-source.html#l00893">ID3_GetSyncLyrics</a>(), <a class="el" href="misc__support_8cpp-source.html#l00852">ID3_GetSyncLyricsInfo</a>(), <a class="el" href="misc__support_8cpp-source.html#l00221">ID3_GetTitle</a>(), <a class="el" href="misc__support_8cpp-source.html#l00475">ID3_GetTrack</a>(), <a class="el" href="misc__support_8cpp-source.html#l00280">ID3_GetYear</a>(), <a class="el" href="misc__support_8cpp-source.html#l00201">ID3_RemoveAlbums</a>(), <a class="el" href="misc__support_8cpp-source.html#l00124">ID3_RemoveArtists</a>(), <a class="el" href="misc__support_8cpp-source.html#l00632">ID3_RemoveGenres</a>(), <a class="el" href="misc__support_8cpp-source.html#l00764">ID3_RemoveLyricist</a>(), <a class="el" href="misc__support_8cpp-source.html#l00705">ID3_RemoveLyrics</a>(), <a class="el" href="misc__support_8cpp-source.html#l00260">ID3_RemoveTitles</a>(), <a class="el" href="misc__support_8cpp-source.html#l00540">ID3_RemoveTracks</a>(), and <a class="el" href="misc__support_8cpp-source.html#l00319">ID3_RemoveYears</a>(). </td>
</tr>
</table>
<a name="a74" doxytag="ID3_Tag::GetAppendedBytes"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> size_t ID3_Tag::GetAppendedBytes </td>
<td class="md" valign="top">( </td>
<td class="mdname1" valign="top" nowrap> </td>
<td class="md" valign="top">) </td>
<td class="md" nowrap> const</td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
</td>
</tr>
</table>
<a name="a25" doxytag="ID3_Tag::GetAppendedBytes"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> size_t ID3_Tag::GetAppendedBytes </td>
<td class="md" valign="top">( </td>
<td class="mdname1" valign="top" nowrap> </td>
<td class="md" valign="top">) </td>
<td class="md" nowrap> const</td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
<p>
Definition at line <a class="el" href="tag_8cpp-source.html#l00737">737</a> of file <a class="el" href="tag_8cpp-source.html">tag.cpp</a>.
<p>
References <a class="el" href="tag__impl_8h-source.html#l00110">ID3_TagImpl::GetAppendedBytes</a>(). </td>
</tr>
</table>
<a name="a60" doxytag="ID3_Tag::GetExperimental"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> bool ID3_Tag::GetExperimental </td>
<td class="md" valign="top">( </td>
<td class="mdname1" valign="top" nowrap> </td>
<td class="md" valign="top">) </td>
<td class="md" nowrap> const</td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
</td>
</tr>
</table>
<a name="a11" doxytag="ID3_Tag::GetExperimental"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> bool ID3_Tag::GetExperimental </td>
<td class="md" valign="top">( </td>
<td class="mdname1" valign="top" nowrap> </td>
<td class="md" valign="top">) </td>
<td class="md" nowrap> const</td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
<p>
Definition at line <a class="el" href="tag_8cpp-source.html#l00479">479</a> of file <a class="el" href="tag_8cpp-source.html">tag.cpp</a>.
<p>
References <a class="el" href="tag__impl_8cpp-source.html#l00269">ID3_TagImpl::GetExperimental</a>().
<p>
Referenced by <a class="el" href="tag__impl_8cpp-source.html#l00288">ID3_TagImpl::operator=</a>(). </td>
</tr>
</table>
<a name="a59" doxytag="ID3_Tag::GetExtendedHeader"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> bool ID3_Tag::GetExtendedHeader </td>
<td class="md" valign="top">( </td>
<td class="mdname1" valign="top" nowrap> </td>
<td class="md" valign="top">) </td>
<td class="md" nowrap> const</td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
</td>
</tr>
</table>
<a name="a10" doxytag="ID3_Tag::GetExtendedHeader"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> bool ID3_Tag::GetExtendedHeader </td>
<td class="md" valign="top">( </td>
<td class="mdname1" valign="top" nowrap> </td>
<td class="md" valign="top">) </td>
<td class="md" nowrap> const</td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
<p>
Definition at line <a class="el" href="tag_8cpp-source.html#l00474">474</a> of file <a class="el" href="tag_8cpp-source.html">tag.cpp</a>.
<p>
References <a class="el" href="tag__impl_8cpp-source.html#l00264">ID3_TagImpl::GetExtended</a>().
<p>
Referenced by <a class="el" href="tag__impl_8cpp-source.html#l00288">ID3_TagImpl::operator=</a>(). </td>
</tr>
</table>
<a name="a76" doxytag="ID3_Tag::GetFileName"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> const char* ID3_Tag::GetFileName </td>
<td class="md" valign="top">( </td>
<td class="mdname1" valign="top" nowrap> </td>
<td class="md" valign="top">) </td>
<td class="md" nowrap> const</td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
</td>
</tr>
</table>
<a name="a27" doxytag="ID3_Tag::GetFileName"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> const char * ID3_Tag::GetFileName </td>
<td class="md" valign="top">( </td>
<td class="mdname1" valign="top" nowrap> </td>
<td class="md" valign="top">) </td>
<td class="md" nowrap> const</td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
<p>
Definition at line <a class="el" href="tag_8cpp-source.html#l00747">747</a> of file <a class="el" href="tag_8cpp-source.html">tag.cpp</a>.
<p>
References <a class="el" href="tag__impl_8h-source.html#l00112">ID3_TagImpl::GetFileName</a>(). </td>
</tr>
</table>
<a name="a75" doxytag="ID3_Tag::GetFileSize"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> size_t ID3_Tag::GetFileSize </td>
<td class="md" valign="top">( </td>
<td class="mdname1" valign="top" nowrap> </td>
<td class="md" valign="top">) </td>
<td class="md" nowrap> const</td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
</td>
</tr>
</table>
<a name="a26" doxytag="ID3_Tag::GetFileSize"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> size_t ID3_Tag::GetFileSize </td>
<td class="md" valign="top">( </td>
<td class="mdname1" valign="top" nowrap> </td>
<td class="md" valign="top">) </td>
<td class="md" nowrap> const</td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
<p>
Definition at line <a class="el" href="tag_8cpp-source.html#l00742">742</a> of file <a class="el" href="tag_8cpp-source.html">tag.cpp</a>.
<p>
References <a class="el" href="tag__impl_8h-source.html#l00111">ID3_TagImpl::GetFileSize</a>(). </td>
</tr>
</table>
<a name="a73" doxytag="ID3_Tag::GetPrependedBytes"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> size_t ID3_Tag::GetPrependedBytes </td>
<td class="md" valign="top">( </td>
<td class="mdname1" valign="top" nowrap> </td>
<td class="md" valign="top">) </td>
<td class="md" nowrap> const</td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
</td>
</tr>
</table>
<a name="a24" doxytag="ID3_Tag::GetPrependedBytes"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> size_t ID3_Tag::GetPrependedBytes </td>
<td class="md" valign="top">( </td>
<td class="mdname1" valign="top" nowrap> </td>
<td class="md" valign="top">) </td>
<td class="md" nowrap> const</td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
<p>
Definition at line <a class="el" href="tag_8cpp-source.html#l00732">732</a> of file <a class="el" href="tag_8cpp-source.html">tag.cpp</a>.
<p>
References <a class="el" href="tag__impl_8h-source.html#l00109">ID3_TagImpl::GetPrependedBytes</a>(). </td>
</tr>
</table>
<a name="a86" doxytag="ID3_Tag::GetSpec"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> <a class="el" href="globals_8h.html#a216">ID3_V2Spec</a> ID3_Tag::GetSpec </td>
<td class="md" valign="top">( </td>
<td class="mdname1" valign="top" nowrap> </td>
<td class="md" valign="top">) </td>
<td class="md" nowrap> const</td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
</td>
</tr>
</table>
<a name="a37" doxytag="ID3_Tag::GetSpec"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> <a class="el" href="globals_8h.html#a216">ID3_V2Spec</a> ID3_Tag::GetSpec </td>
<td class="md" valign="top">( </td>
<td class="mdname1" valign="top" nowrap> </td>
<td class="md" valign="top">) </td>
<td class="md" nowrap> const</td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
<p>
Definition at line <a class="el" href="tag_8cpp-source.html#l00921">921</a> of file <a class="el" href="tag_8cpp-source.html">tag.cpp</a>.
<p>
References <a class="el" href="tag__impl_8cpp-source.html#l00233">ID3_TagImpl::GetSpec</a>(), and <a class="el" href="globals_8h-source.html#l00139">ID3_V2Spec</a>. </td>
</tr>
</table>
<a name="a58" doxytag="ID3_Tag::GetUnsync"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> bool ID3_Tag::GetUnsync </td>
<td class="md" valign="top">( </td>
<td class="mdname1" valign="top" nowrap> </td>
<td class="md" valign="top">) </td>
<td class="md" nowrap> const</td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
</td>
</tr>
</table>
<a name="a9" doxytag="ID3_Tag::GetUnsync"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> bool ID3_Tag::GetUnsync </td>
<td class="md" valign="top">( </td>
<td class="mdname1" valign="top" nowrap> </td>
<td class="md" valign="top">) </td>
<td class="md" nowrap> const</td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
<p>
Definition at line <a class="el" href="tag_8cpp-source.html#l00469">469</a> of file <a class="el" href="tag_8cpp-source.html">tag.cpp</a>.
<p>
References <a class="el" href="tag__impl_8cpp-source.html#l00259">ID3_TagImpl::GetUnsync</a>().
<p>
Referenced by <a class="el" href="tag__impl_8cpp-source.html#l00288">ID3_TagImpl::operator=</a>(). </td>
</tr>
</table>
<a name="a53" doxytag="ID3_Tag::HasChanged"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> bool ID3_Tag::HasChanged </td>
<td class="md" valign="top">( </td>
<td class="mdname1" valign="top" nowrap> </td>
<td class="md" valign="top">) </td>
<td class="md" nowrap> const</td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
</td>
</tr>
</table>
<a name="a4" doxytag="ID3_Tag::HasChanged"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> bool ID3_Tag::HasChanged </td>
<td class="md" valign="top">( </td>
<td class="mdname1" valign="top" nowrap> </td>
<td class="md" valign="top">) </td>
<td class="md" nowrap> const</td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
Indicates whether the tag has been altered since the last parse, render, or update.
<p>
If you have a tag linked to a file, you do not need this method since the <a class="el" href="class_i_d3___tag.html#a22">Update</a>() method will check for changes before writing the tag.
<p>
This method is primarily intended as a status indicator for applications and for applications that use the <a class="el" href="class_i_d3___tag.html#a17">Parse</a>() and <a class="el" href="class_i_d3___tag.html#a19">Render</a>() methods.
<p>
Setting a field, changed the ID of an attached frame, setting or grouping or encryption IDs, and clearing a frame or field all constitute a change to the tag, as do calls to the <a class="el" href="class_i_d3___tag.html#a6">SetUnsync</a>(), <a class="el" href="class_i_d3___tag.html#a7">SetExtendedHeader</a>(), and <a class="el" href="class_i_d3___tag.html#a12">SetPadding</a>() methods.
<p>
<div class="fragment"><pre> <font class="keywordflow">if</font> (myTag.HasChanged())
{
<font class="comment">// render and output the tag</font>
}
</pre></div>
<p>
<dl compact><dt><b>
Returns: </b><dd>
Whether or not the tag has been altered. </dl>
<p>
Definition at line <a class="el" href="tag_8cpp-source.html#l00349">349</a> of file <a class="el" href="tag_8cpp-source.html">tag.cpp</a>.
<p>
References <a class="el" href="tag__impl_8cpp-source.html#l00203">ID3_TagImpl::HasChanged</a>(). </td>
</tr>
</table>
<a name="a92" doxytag="ID3_Tag::HasLyrics"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> bool ID3_Tag::HasLyrics </td>
<td class="md" valign="top">( </td>
<td class="mdname1" valign="top" nowrap> </td>
<td class="md" valign="top">) </td>
<td class="md" nowrap> const</td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
</td>
</tr>
</table>
<a name="a43" doxytag="ID3_Tag::HasLyrics"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> bool ID3_Tag::HasLyrics </td>
<td class="md" valign="top">( </td>
<td class="mdname1" valign="top" nowrap> </td>
<td class="md" valign="top">) </td>
<td class="md" nowrap> const</td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
<p>
Definition at line <a class="el" href="tag_8cpp-source.html#l00986">986</a> of file <a class="el" href="tag_8cpp-source.html">tag.cpp</a>.
<p>
References <a class="el" href="tag_8cpp-source.html#l00916">HasTagType</a>(), and <a class="el" href="namespace_3global_scope_4.html#a217a65">ID3TT_LYRICS</a>. </td>
</tr>
</table>
<a name="a85" doxytag="ID3_Tag::HasTagType"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> bool ID3_Tag::HasTagType </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="sized__types_8h.html#a2">uint16</a> </td>
<td class="mdname1" valign="top" nowrap> <em>tt</em> </td>
<td class="md" valign="top">) </td>
<td class="md" nowrap> const</td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
</td>
</tr>
</table>
<a name="a36" doxytag="ID3_Tag::HasTagType"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> bool ID3_Tag::HasTagType </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="sized__types_8h.html#a2">uint16</a> </td>
<td class="mdname1" valign="top" nowrap> <em>tt</em> </td>
<td class="md" valign="top">) </td>
<td class="md" nowrap> const</td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
<p>
Definition at line <a class="el" href="tag_8cpp-source.html#l00916">916</a> of file <a class="el" href="tag_8cpp-source.html">tag.cpp</a>.
<p>
References <a class="el" href="tag__impl_8h-source.html#l00122">ID3_TagImpl::HasTagType</a>(), and <a class="el" href="sized__types_8h-source.html#l00054">uint16</a>.
<p>
Referenced by <a class="el" href="tag_8cpp-source.html#l00986">HasLyrics</a>(). </td>
</tr>
</table>
<a name="a94" doxytag="ID3_Tag::HasV1Tag"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> bool ID3_Tag::HasV1Tag </td>
<td class="md" valign="top">( </td>
<td class="mdname1" valign="top" nowrap> </td>
<td class="md" valign="top">) </td>
<td class="md" nowrap> const</td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
</td>
</tr>
</table>
<a name="a45" doxytag="ID3_Tag::HasV1Tag"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> bool ID3_Tag::HasV1Tag </td>
<td class="md" valign="top">( </td>
<td class="mdname1" valign="top" nowrap> </td>
<td class="md" valign="top">) </td>
<td class="md" nowrap> const</td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
<p>
Definition at line <a class="el" href="tag_8cpp-source.html#l00994">994</a> of file <a class="el" href="tag_8cpp-source.html">tag.cpp</a>.
<p>
References <a class="el" href="namespace_3global_scope_4.html#a217a60">ID3TT_ID3V1</a>. </td>
</tr>
</table>
<a name="a93" doxytag="ID3_Tag::HasV2Tag"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> bool ID3_Tag::HasV2Tag </td>
<td class="md" valign="top">( </td>
<td class="mdname1" valign="top" nowrap> </td>
<td class="md" valign="top">) </td>
<td class="md" nowrap> const</td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
</td>
</tr>
</table>
<a name="a44" doxytag="ID3_Tag::HasV2Tag"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> bool ID3_Tag::HasV2Tag </td>
<td class="md" valign="top">( </td>
<td class="mdname1" valign="top" nowrap> </td>
<td class="md" valign="top">) </td>
<td class="md" nowrap> const</td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
<p>
Definition at line <a class="el" href="tag_8cpp-source.html#l00990">990</a> of file <a class="el" href="tag_8cpp-source.html">tag.cpp</a>.
<p>
References <a class="el" href="namespace_3global_scope_4.html#a217a61">ID3TT_ID3V2</a>. </td>
</tr>
</table>
<a name="d3" doxytag="ID3_Tag::IsV2Tag"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> size_t ID3_Tag::IsV2Tag </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="class_i_d3___reader.html">ID3_Reader</a> & </td>
<td class="mdname1" valign="top" nowrap> </td>
<td class="md" valign="top">) </td>
<td class="md" nowrap><code> [static]</code></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
</td>
</tr>
</table>
<a name="d2" doxytag="ID3_Tag::IsV2Tag"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> size_t ID3_Tag::IsV2Tag </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top">const <a class="el" href="globals_8h.html#a33">uchar</a> * </td>
<td class="mdname1" valign="top" nowrap> </td>
<td class="md" valign="top">) </td>
<td class="md" nowrap><code> [static]</code></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
</td>
</tr>
</table>
<a name="d1" doxytag="ID3_Tag::IsV2Tag"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> size_t ID3_Tag::IsV2Tag </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="class_i_d3___reader.html">ID3_Reader</a> & </td>
<td class="mdname1" valign="top" nowrap> <em>reader</em> </td>
<td class="md" valign="top">) </td>
<td class="md" nowrap><code> [static]</code></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
<p>
Definition at line <a class="el" href="tag_8cpp-source.html#l00941">941</a> of file <a class="el" href="tag_8cpp-source.html">tag.cpp</a>.
<p>
References <a class="el" href="tag__impl_8cpp-source.html#l00046">ID3_TagImpl::IsV2Tag</a>(). </td>
</tr>
</table>
<a name="d0" doxytag="ID3_Tag::IsV2Tag"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> size_t ID3_Tag::IsV2Tag </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top">const <a class="el" href="globals_8h.html#a33">uchar</a> * </td>
<td class="mdname1" valign="top" nowrap> </td>
<td class="md" valign="top">) </td>
<td class="md" nowrap><code> [static]</code></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
<p>
Referenced by <a class="el" href="tag_8cpp-source.html#l01034">ID3_IsTagHeader</a>(), <a class="el" href="tag_8cpp-source.html#l00610">Parse</a>(), and <a class="el" href="header__tag_8cpp-source.html#l00090">ID3_TagHeader::Parse</a>(). </td>
</tr>
</table>
<a name="a89" doxytag="ID3_Tag::Link"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> size_t ID3_Tag::Link </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top">const char * </td>
<td class="mdname" nowrap> <em>fileInfo</em>, </td>
</tr>
<tr>
<td></td>
<td></td>
<td class="md" nowrap>bool </td>
<td class="mdname" nowrap> <em>parseID3v1</em>, </td>
</tr>
<tr>
<td></td>
<td></td>
<td class="md" nowrap>bool </td>
<td class="mdname" nowrap> <em>parseLyrics3</em></td>
</tr>
<tr>
<td></td>
<td class="md">) </td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
</td>
</tr>
</table>
<a name="a70" doxytag="ID3_Tag::Link"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> size_t ID3_Tag::Link </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top">const char * </td>
<td class="mdname" nowrap> <em>fileInfo</em>, </td>
</tr>
<tr>
<td></td>
<td></td>
<td class="md" nowrap><a class="el" href="globals_8h.html#a40">flags_t</a> </td>
<td class="mdname" nowrap> = (<a class="el" href="globals_8h.html#a40">flags_t</a>) ID3TT_ALL</td>
</tr>
<tr>
<td></td>
<td class="md">) </td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
</td>
</tr>
</table>
<a name="a40" doxytag="ID3_Tag::Link"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> size_t ID3_Tag::Link </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top">const char * </td>
<td class="mdname" nowrap> <em>fileInfo</em>, </td>
</tr>
<tr>
<td></td>
<td></td>
<td class="md" nowrap>bool </td>
<td class="mdname" nowrap> <em>parseID3v1</em>, </td>
</tr>
<tr>
<td></td>
<td></td>
<td class="md" nowrap>bool </td>
<td class="mdname" nowrap> <em>parseLyrics3</em></td>
</tr>
<tr>
<td></td>
<td class="md">) </td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
<p>
Definition at line <a class="el" href="tag_8cpp-source.html#l00976">976</a> of file <a class="el" href="tag_8cpp-source.html">tag.cpp</a>.
<p>
References <a class="el" href="tag__file_8cpp-source.html#l00136">ID3_TagImpl::Link</a>(). </td>
</tr>
</table>
<a name="a21" doxytag="ID3_Tag::Link"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> size_t ID3_Tag::Link </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top">const char * </td>
<td class="mdname" nowrap> <em>fileInfo</em>, </td>
</tr>
<tr>
<td></td>
<td></td>
<td class="md" nowrap><a class="el" href="globals_8h.html#a40">flags_t</a> </td>
<td class="mdname" nowrap> <em>flags</em> = (<a class="el" href="globals_8h.html#a40">flags_t</a>) ID3TT_ALL</td>
</tr>
<tr>
<td></td>
<td class="md">) </td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
Attaches a file to the tag, parses the file, and adds any tag information found in the file to the tag.
<p>
Use this method if you created your ID3_Tag object without supplying a parameter to the constructor (maybe you created an array of ID3_Tag pointers). This is the preferred method of interacting with files, since id3lib can automatically do things like parse foreign tag formats and handle padding when linked to a file. When a tag is linked to a file, you do not need to use the <a class="el" href="class_i_d3___tag.html#a5">Size</a>(), Render(const uchar*, size_t), or <a class="el" href="class_i_d3___tag.html#a18">Parse</a>(ID3_Reader&) methods or the <a class="el" href="class_i_d3___tag.html#d1">IsV2Tag</a>(ID3_Reader&) static function-- id3lib will take care of those details for you. The single parameter is a pointer to a file name.
<p>
Link returns the size of the the ID3v2 tag (if any) that begins the file.
<p>
<div class="fragment"><pre> <a class="code" href="class_i_d3___tag.html">ID3_Tag</a> myTag;
myTag.<a class="code" href="class_i_d3___tag.html#a21">Link</a>(<font class="stringliteral">"mysong.mp3"</font>);
<font class="comment">// do whatever we want with the tag</font>
<font class="comment">// ...</font>
<font class="comment">// setup all our rendering parameters</font>
myTag-><a class="code" href="class_i_d3___tag.html#a6">SetUnsync</a>(<font class="keyword">false</font>);
myTag-><a class="code" href="class_i_d3___tag.html#a7">SetExtendedHeader</a>(<font class="keyword">true</font>);
myTag-><a class="code" href="class_i_d3___tag.html#a41">SetCompression</a>(<font class="keyword">true</font>);
myTag-><a class="code" href="class_i_d3___tag.html#a12">SetPadding</a>(<font class="keyword">true</font>);
<font class="comment">// write any changes to the file</font>
myTag-><a class="code" href="class_i_d3___tag.html#a22">Update</a>()
</pre></div>
<p>
<dl compact><dt><b>
See also: </b><dd>
<a class="el" href="class_i_d3___tag.html#d0">IsV2Tag</a> </dl><dl compact><dt><b>
Parameters: </b><dd>
<table border=0 cellspacing=2 cellpadding=0>
<tr><td valign=top><em>fileInfo</em> </td><td>
The filename of the file to link to. </td></tr>
</table>
</dl>
<p>
Definition at line <a class="el" href="tag_8cpp-source.html#l00711">711</a> of file <a class="el" href="tag_8cpp-source.html">tag.cpp</a>.
<p>
References <a class="el" href="globals_8h-source.html#l00095">flags_t</a>, and <a class="el" href="tag__file_8cpp-source.html#l00136">ID3_TagImpl::Link</a>(). </td>
</tr>
</table>
<a name="a81" doxytag="ID3_Tag::NumFrames"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> size_t ID3_Tag::NumFrames </td>
<td class="md" valign="top">( </td>
<td class="mdname1" valign="top" nowrap> </td>
<td class="md" valign="top">) </td>
<td class="md" nowrap> const</td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
</td>
</tr>
</table>
<a name="a32" doxytag="ID3_Tag::NumFrames"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> size_t ID3_Tag::NumFrames </td>
<td class="md" valign="top">( </td>
<td class="mdname1" valign="top" nowrap> </td>
<td class="md" valign="top">) </td>
<td class="md" nowrap> const</td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
Returns the number of frames present in the tag object.
<p>
This includes only those frames that id3lib recognises. This is used as the upper bound on calls to the GetFrame() and operator[]() methods.
<p>
<dl compact><dt><b>
Returns: </b><dd>
The number of frames present in the tag object. </dl>
<p>
Definition at line <a class="el" href="tag_8cpp-source.html#l00848">848</a> of file <a class="el" href="tag_8cpp-source.html">tag.cpp</a>.
<p>
References <a class="el" href="tag__impl_8h-source.html#l00119">ID3_TagImpl::NumFrames</a>(). </td>
</tr>
</table>
<a name="a97" doxytag="ID3_Tag::operator<<"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> ID3_Tag& ID3_Tag::operator<< </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top">const <a class="el" href="class_i_d3___frame.html">ID3_Frame</a> * </td>
<td class="mdname1" valign="top" nowrap> </td>
<td class="md" valign="top">) </td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
</td>
</tr>
</table>
<a name="a96" doxytag="ID3_Tag::operator<<"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> ID3_Tag& ID3_Tag::operator<< </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top">const <a class="el" href="class_i_d3___frame.html">ID3_Frame</a> & </td>
<td class="mdname1" valign="top" nowrap> </td>
<td class="md" valign="top">) </td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
</td>
</tr>
</table>
<a name="a48" doxytag="ID3_Tag::operator<<"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> ID3_Tag & ID3_Tag::operator<< </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top">const <a class="el" href="class_i_d3___frame.html">ID3_Frame</a> * </td>
<td class="mdname1" valign="top" nowrap> <em>frame</em> </td>
<td class="md" valign="top">) </td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
<p>
Definition at line <a class="el" href="tag_8cpp-source.html#l01025">1025</a> of file <a class="el" href="tag_8cpp-source.html">tag.cpp</a>.
<p>
References <a class="el" href="tag_8cpp-source.html#l00484">AddFrame</a>(). </td>
</tr>
</table>
<a name="a47" doxytag="ID3_Tag::operator<<"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> ID3_Tag & ID3_Tag::operator<< </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top">const <a class="el" href="class_i_d3___frame.html">ID3_Frame</a> & </td>
<td class="mdname1" valign="top" nowrap> <em>frame</em> </td>
<td class="md" valign="top">) </td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
<p>
Definition at line <a class="el" href="tag_8cpp-source.html#l01018">1018</a> of file <a class="el" href="tag_8cpp-source.html">tag.cpp</a>.
<p>
References <a class="el" href="tag_8cpp-source.html#l00484">AddFrame</a>(). </td>
</tr>
</table>
<a name="a84" doxytag="ID3_Tag::operator="></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> ID3_Tag& ID3_Tag::operator= </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top">const ID3_Tag & </td>
<td class="mdname1" valign="top" nowrap> </td>
<td class="md" valign="top">) </td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
</td>
</tr>
</table>
<a name="a35" doxytag="ID3_Tag::operator="></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> ID3_Tag & ID3_Tag::operator= </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top">const ID3_Tag & </td>
<td class="mdname1" valign="top" nowrap> <em>rTag</em> </td>
<td class="md" valign="top">) </td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
<p>
Definition at line <a class="el" href="tag_8cpp-source.html#l00907">907</a> of file <a class="el" href="tag_8cpp-source.html">tag.cpp</a>. </td>
</tr>
</table>
<a name="a95" doxytag="ID3_Tag::Parse"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> size_t ID3_Tag::Parse </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top">const <a class="el" href="globals_8h.html#a33">uchar</a> </td>
<td class="mdname" nowrap> <em>header</em>[ID3_TAGHEADERSIZE], </td>
</tr>
<tr>
<td></td>
<td></td>
<td class="md" nowrap>const <a class="el" href="globals_8h.html#a33">uchar</a> * </td>
<td class="mdname" nowrap> <em>buffer</em></td>
</tr>
<tr>
<td></td>
<td class="md">) </td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
</td>
</tr>
</table>
<a name="a67" doxytag="ID3_Tag::Parse"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> bool ID3_Tag::Parse </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="class_i_d3___reader.html">ID3_Reader</a> & </td>
<td class="mdname1" valign="top" nowrap> <em>reader</em> </td>
<td class="md" valign="top">) </td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
</td>
</tr>
</table>
<a name="a66" doxytag="ID3_Tag::Parse"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> size_t ID3_Tag::Parse </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top">const <a class="el" href="globals_8h.html#a33">uchar</a> * </td>
<td class="mdname" nowrap> , </td>
</tr>
<tr>
<td></td>
<td></td>
<td class="md" nowrap>size_t </td>
<td class="mdname" nowrap> </td>
</tr>
<tr>
<td></td>
<td class="md">) </td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
</td>
</tr>
</table>
<a name="a46" doxytag="ID3_Tag::Parse"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> size_t ID3_Tag::Parse </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top">const <a class="el" href="globals_8h.html#a33">uchar</a> </td>
<td class="mdname" nowrap> <em>header</em>[ID3_TAGHEADERSIZE], </td>
</tr>
<tr>
<td></td>
<td></td>
<td class="md" nowrap>const <a class="el" href="globals_8h.html#a33">uchar</a> * </td>
<td class="mdname" nowrap> <em>buffer</em></td>
</tr>
<tr>
<td></td>
<td class="md">) </td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
Turns a binary tag into a series of <a class="el" href="class_i_d3___frame.html">ID3_Frame</a> objects attached to the tag.
<p>
<div class="fragment"><pre> <a class="code" href="class_i_d3___tag.html">ID3_Tag</a> myTag;
<a class="code" href="globals_8h.html#a33">uchar</a> header[<a class="code" href="globals_8h.html#a5">ID3_TAGHEADERSIZE</a>];
<a class="code" href="globals_8h.html#a33">uchar</a> *buffer;
<a class="code" href="globals_8h.html#a37">luint</a> tagSize;
<font class="comment">// get ID3_TAGHEADERSIZE from a socket or somewhere</font>
<font class="comment">// ...</font>
<font class="keywordflow">if</font> ((tagSize = <a class="code" href="tag_8cpp.html#a0">ID3_IsTagHeader</a>(ourSourceBuffer)) > -1)
{
<font class="comment">// read a further 'tagSize' bytes in</font>
<font class="comment">// from our data source</font>
<font class="comment">// ...</font>
<font class="keywordflow">if</font> (buffer = <font class="keyword">new</font> <a class="code" href="globals_8h.html#a33">uchar</a>[tagSize])
{
<font class="comment">// now we will call ID3_Tag::Parse()</font>
<font class="comment">// with these values (explained later)</font>
myTag.<a class="code" href="class_i_d3___tag.html#a17">Parse</a>(header, buffer);
<font class="comment">// do something with the objects,</font>
<font class="comment">// like look for titles, artists, etc.</font>
<font class="comment">// ...</font>
<font class="comment">// free the buffer</font>
<font class="keyword">delete</font> [] buffer;
}
}
</pre></div>
<p>
<dl compact><dt><b>
See also: </b><dd>
<a class="el" href="class_i_d3___frame.html">ID3_Frame</a> </dl><dl compact><dt><b>
Parameters: </b><dd>
<table border=0 cellspacing=2 cellpadding=0>
<tr><td valign=top><em>header</em> </td><td>
The byte header read in from the data source. </td></tr>
<tr><td valign=top><em>buffer</em> </td><td>
The remainder of the tag (not including the data source) read in from the data source. </td></tr>
</table>
</dl>
<p>
Definition at line <a class="el" href="tag_8cpp-source.html#l00610">610</a> of file <a class="el" href="tag_8cpp-source.html">tag.cpp</a>.
<p>
References <a class="el" href="globals_8h-source.html#l00077">ID3_TAGHEADERSIZE</a>, <a class="el" href="class_i_d3___tag.html#d0">IsV2Tag</a>(), <a class="el" href="tag_8cpp-source.html#l00563">Parse</a>(), <a class="el" href="class_i_d3___tag_header.html#s10s8">ID3_TagHeader::SIZE</a>, and <a class="el" href="globals_8h-source.html#l00087">uchar</a>. </td>
</tr>
</table>
<a name="a18" doxytag="ID3_Tag::Parse"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> bool ID3_Tag::Parse </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="class_i_d3___reader.html">ID3_Reader</a> & </td>
<td class="mdname1" valign="top" nowrap> <em>reader</em> </td>
<td class="md" valign="top">) </td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
<p>
Definition at line <a class="el" href="tag_8cpp-source.html#l00558">558</a> of file <a class="el" href="tag_8cpp-source.html">tag.cpp</a>. </td>
</tr>
</table>
<a name="a17" doxytag="ID3_Tag::Parse"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> size_t ID3_Tag::Parse </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top">const <a class="el" href="globals_8h.html#a33">uchar</a> * </td>
<td class="mdname" nowrap> <em>buffer</em>, </td>
</tr>
<tr>
<td></td>
<td></td>
<td class="md" nowrap>size_t </td>
<td class="mdname" nowrap> <em>bytes</em></td>
</tr>
<tr>
<td></td>
<td class="md">) </td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
<p>
Definition at line <a class="el" href="tag_8cpp-source.html#l00563">563</a> of file <a class="el" href="tag_8cpp-source.html">tag.cpp</a>.
<p>
References <a class="el" href="readers_8h-source.html#l00135">ID3_MemoryReader::getCur</a>(), <a class="el" href="readers_8h-source.html#l00145">ID3_MemoryReader::getEnd</a>(), <a class="el" href="reader_8h-source.html#l00038">ID3_Reader::pos_type</a>, and <a class="el" href="globals_8h-source.html#l00087">uchar</a>.
<p>
Referenced by <a class="el" href="tag_8cpp-source.html#l00610">Parse</a>(). </td>
</tr>
</table>
<a name="a65" doxytag="ID3_Tag::RemoveFrame"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> <a class="el" href="class_i_d3___frame.html">ID3_Frame</a>* ID3_Tag::RemoveFrame </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top">const <a class="el" href="class_i_d3___frame.html">ID3_Frame</a> * </td>
<td class="mdname1" valign="top" nowrap> </td>
<td class="md" valign="top">) </td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
</td>
</tr>
</table>
<a name="a16" doxytag="ID3_Tag::RemoveFrame"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> <a class="el" href="class_i_d3___frame.html">ID3_Frame</a> * ID3_Tag::RemoveFrame </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top">const <a class="el" href="class_i_d3___frame.html">ID3_Frame</a> * </td>
<td class="mdname1" valign="top" nowrap> <em>frame</em> </td>
<td class="md" valign="top">) </td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
Removes a frame from the tag.
<p>
If you already own the frame object in question, then you should already have a pointer to the frame you want to delete. If not, or if you wish to delete a pre-existing frame (from a tag you have parsed, for example), the use one of the Find methods to obtain a frame pointer to pass to this method.
<p>
<div class="fragment"><pre> <a class="code" href="class_i_d3___frame.html">ID3_Frame</a> *someFrame;
<font class="keywordflow">if</font> (someFrame = myTag.Find(<a class="code" href="globals_8h.html#a219a131">ID3FID_TITLE</a>))
{
myTag.RemoveFrame(someFrame);
}
</pre></div>
<p>
<dl compact><dt><b>
See also: </b><dd>
<a class="el" href="class_i_d3___tag.html#a28">ID3_Tag::Find</a> </dl><dl compact><dt><b>
Parameters: </b><dd>
<table border=0 cellspacing=2 cellpadding=0>
<tr><td valign=top><em>pOldFrame</em> </td><td>
A pointer to the frame that is to be removed from the tag </td></tr>
</table>
</dl>
<p>
Definition at line <a class="el" href="tag_8cpp-source.html#l00553">553</a> of file <a class="el" href="tag_8cpp-source.html">tag.cpp</a>.
<p>
References <a class="el" href="tag__impl_8cpp-source.html#l00186">ID3_TagImpl::RemoveFrame</a>().
<p>
Referenced by <a class="el" href="misc__support_8cpp-source.html#l00805">ID3_AddSyncLyrics</a>(), <a class="el" href="misc__support_8cpp-source.html#l00201">ID3_RemoveAlbums</a>(), <a class="el" href="misc__support_8cpp-source.html#l00124">ID3_RemoveArtists</a>(), <a class="el" href="misc__support_8cpp-source.html#l00433">ID3_RemoveComments</a>(), <a class="el" href="misc__support_8cpp-source.html#l00632">ID3_RemoveGenres</a>(), <a class="el" href="misc__support_8cpp-source.html#l00764">ID3_RemoveLyricist</a>(), <a class="el" href="misc__support_8cpp-source.html#l00705">ID3_RemoveLyrics</a>(), <a class="el" href="misc__support_8cpp-source.html#l00260">ID3_RemoveTitles</a>(), <a class="el" href="misc__support_8cpp-source.html#l00540">ID3_RemoveTracks</a>(), and <a class="el" href="misc__support_8cpp-source.html#l00319">ID3_RemoveYears</a>(). </td>
</tr>
</table>
<a name="a69" doxytag="ID3_Tag::Render"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> size_t ID3_Tag::Render </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="class_i_d3___writer.html">ID3_Writer</a> & </td>
<td class="mdname" nowrap> , </td>
</tr>
<tr>
<td></td>
<td></td>
<td class="md" nowrap><a class="el" href="globals_8h.html#a217">ID3_TagType</a> </td>
<td class="mdname" nowrap> = ID3TT_ID3V2</td>
</tr>
<tr>
<td></td>
<td class="md">) </td>
<td class="md" colspan="2"> const</td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
</td>
</tr>
</table>
<a name="a68" doxytag="ID3_Tag::Render"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> size_t ID3_Tag::Render </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="globals_8h.html#a33">uchar</a> * </td>
<td class="mdname" nowrap> , </td>
</tr>
<tr>
<td></td>
<td></td>
<td class="md" nowrap><a class="el" href="globals_8h.html#a217">ID3_TagType</a> </td>
<td class="mdname" nowrap> = ID3TT_ID3V2</td>
</tr>
<tr>
<td></td>
<td class="md">) </td>
<td class="md" colspan="2"> const</td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
</td>
</tr>
</table>
<a name="a20" doxytag="ID3_Tag::Render"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> size_t ID3_Tag::Render </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="class_i_d3___writer.html">ID3_Writer</a> & </td>
<td class="mdname" nowrap> <em>writer</em>, </td>
</tr>
<tr>
<td></td>
<td></td>
<td class="md" nowrap><a class="el" href="globals_8h.html#a217">ID3_TagType</a> </td>
<td class="mdname" nowrap> <em>tt</em> = ID3TT_ID3V2</td>
</tr>
<tr>
<td></td>
<td class="md">) </td>
<td class="md" colspan="2"> const</td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
<p>
Definition at line <a class="el" href="tag_8cpp-source.html#l00660">660</a> of file <a class="el" href="tag_8cpp-source.html">tag.cpp</a>.
<p>
References <a class="el" href="class_i_d3___writer.html#a4">ID3_Writer::getCur</a>(), <a class="el" href="globals_8h-source.html#l00152">ID3_TagType</a>, <a class="el" href="namespace_3global_scope_4.html#a217a60">ID3TT_ID3V1</a>, <a class="el" href="namespace_3global_scope_4.html#a217a61">ID3TT_ID3V2</a>, and <a class="el" href="writer_8h-source.html#l00038">ID3_Writer::pos_type</a>. </td>
</tr>
</table>
<a name="a19" doxytag="ID3_Tag::Render"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> size_t ID3_Tag::Render </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="globals_8h.html#a33">uchar</a> * </td>
<td class="mdname" nowrap> <em>buffer</em>, </td>
</tr>
<tr>
<td></td>
<td></td>
<td class="md" nowrap><a class="el" href="globals_8h.html#a217">ID3_TagType</a> </td>
<td class="mdname" nowrap> <em>tt</em> = ID3TT_ID3V2</td>
</tr>
<tr>
<td></td>
<td class="md">) </td>
<td class="md" colspan="2"> const</td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
Renders a binary image of the tag into the supplied buffer.
<p>
See <a class="el" href="class_i_d3___tag.html#a5">Size</a>() for an example. This method returns the actual number of the bytes of the buffer used to store the tag. This will be no more than the size of the buffer itself, because <a class="el" href="class_i_d3___tag.html#a5">Size</a>() over estimates the required buffer size when padding is enabled.
<p>
Before calling this method, it is advisable to call <a class="el" href="class_i_d3___tag.html#a4">HasChanged</a>() first as this will let you know whether you should bother rendering the tag.
<p>
<dl compact><dt><b>
See also: </b><dd>
<a class="el" href="tag_8h.html#a0">ID3_IsTagHeader</a> , <a class="el" href="class_i_d3___tag.html#a4">ID3_Tag::HasChanged</a> </dl><dl compact><dt><b>
Returns: </b><dd>
The actual number of the bytes of the buffer used to store the tag </dl><dl compact><dt><b>
Parameters: </b><dd>
<table border=0 cellspacing=2 cellpadding=0>
<tr><td valign=top><em>buffer</em> </td><td>
The buffer that will contain the rendered tag. </td></tr>
</table>
</dl>
<p>
Definition at line <a class="el" href="tag_8cpp-source.html#l00654">654</a> of file <a class="el" href="tag_8cpp-source.html">tag.cpp</a>.
<p>
References <a class="el" href="globals_8h-source.html#l00152">ID3_TagType</a>, and <a class="el" href="globals_8h-source.html#l00087">uchar</a>. </td>
</tr>
</table>
<a name="a90" doxytag="ID3_Tag::SetCompression"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> void ID3_Tag::SetCompression </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top">bool </td>
<td class="mdname1" valign="top" nowrap> </td>
<td class="md" valign="top">) </td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
</td>
</tr>
</table>
<a name="a41" doxytag="ID3_Tag::SetCompression"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> void ID3_Tag::SetCompression </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top">bool </td>
<td class="mdname1" valign="top" nowrap> <em>b</em> </td>
<td class="md" valign="top">) </td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
<p>
Definition at line <a class="el" href="tag_8cpp-source.html#l00981">981</a> of file <a class="el" href="tag_8cpp-source.html">tag.cpp</a>. </td>
</tr>
</table>
<a name="a57" doxytag="ID3_Tag::SetExperimental"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> bool ID3_Tag::SetExperimental </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top">bool </td>
<td class="mdname1" valign="top" nowrap> </td>
<td class="md" valign="top">) </td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
</td>
</tr>
</table>
<a name="a8" doxytag="ID3_Tag::SetExperimental"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> bool ID3_Tag::SetExperimental </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top">bool </td>
<td class="mdname1" valign="top" nowrap> <em>exp</em> </td>
<td class="md" valign="top">) </td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
<p>
Definition at line <a class="el" href="tag_8cpp-source.html#l00464">464</a> of file <a class="el" href="tag_8cpp-source.html">tag.cpp</a>.
<p>
References <a class="el" href="tag__impl_8cpp-source.html#l00252">ID3_TagImpl::SetExperimental</a>(). </td>
</tr>
</table>
<a name="a56" doxytag="ID3_Tag::SetExtendedHeader"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> bool ID3_Tag::SetExtendedHeader </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top">bool </td>
<td class="mdname1" valign="top" nowrap> </td>
<td class="md" valign="top">) </td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
</td>
</tr>
</table>
<a name="a7" doxytag="ID3_Tag::SetExtendedHeader"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> bool ID3_Tag::SetExtendedHeader </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top">bool </td>
<td class="mdname1" valign="top" nowrap> <em>ext</em> </td>
<td class="md" valign="top">) </td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
Turns extended header rendering on or off, dependant on the value of the boolean parameter.
<p>
This option is currently ignored as id3lib doesn't yet create extended headers. This option only applies when rendering tags for ID3v2 versions that support extended headers.
<p>
<div class="fragment"><pre> myTag.SetExtendedHeader(<font class="keyword">true</font>);
</pre></div><dl compact><dt><b>
Parameters: </b><dd>
<table border=0 cellspacing=2 cellpadding=0>
<tr><td valign=top><em>bExt</em> </td><td>
Whether to render an extended header </td></tr>
</table>
</dl>
<p>
Definition at line <a class="el" href="tag_8cpp-source.html#l00425">425</a> of file <a class="el" href="tag_8cpp-source.html">tag.cpp</a>.
<p>
References <a class="el" href="tag__impl_8cpp-source.html#l00245">ID3_TagImpl::SetExtended</a>(). </td>
</tr>
</table>
<a name="a61" doxytag="ID3_Tag::SetPadding"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> bool ID3_Tag::SetPadding </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top">bool </td>
<td class="mdname1" valign="top" nowrap> </td>
<td class="md" valign="top">) </td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
</td>
</tr>
</table>
<a name="a12" doxytag="ID3_Tag::SetPadding"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> bool ID3_Tag::SetPadding </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top">bool </td>
<td class="mdname1" valign="top" nowrap> <em>pad</em> </td>
<td class="md" valign="top">) </td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
Turns padding on or off, dependant on the value of the boolean parameter.
<p>
When using ID3v2 tags in association with files, id3lib can optionally add padding to the tags to ensure minmal file write times when updating the tag in the future.
<p>
When the padding option is switched on, id3lib automatically creates padding according to the 'ID3v2 Programming Guidelines'. Specifically, enough padding will be added to round out the entire file (song plus tag) to an even multiple of 2K. Padding will only be created when the tag is attached to a file and that file is not empty (aside from a pre-existing tag).
<p>
id3lib's addition to the guidelines for padding, is that if frames are removed from a pre-existing tag (or the tag simply shrinks because of other reasons), the new tag will continue to stay the same size as the old tag (with padding making the difference of course) until such time as the padding is greater than 4K. When this happens, the padding will be reduced and the new tag will be smaller than the old.
<p>
By default, padding is switched on.
<p>
<div class="fragment"><pre> myTag.SetPadding(<font class="keyword">false</font>);
</pre></div><dl compact><dt><b>
Parameters: </b><dd>
<table border=0 cellspacing=2 cellpadding=0>
<tr><td valign=top><em>bPad</em> </td><td>
Whether or not render the tag with padding. </td></tr>
</table>
</dl>
<p>
Definition at line <a class="el" href="tag_8cpp-source.html#l00459">459</a> of file <a class="el" href="tag_8cpp-source.html">tag.cpp</a>.
<p>
References <a class="el" href="tag__impl_8cpp-source.html#l00274">ID3_TagImpl::SetPadding</a>(). </td>
</tr>
</table>
<a name="a87" doxytag="ID3_Tag::SetSpec"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> bool ID3_Tag::SetSpec </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="globals_8h.html#a216">ID3_V2Spec</a> </td>
<td class="mdname1" valign="top" nowrap> </td>
<td class="md" valign="top">) </td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
</td>
</tr>
</table>
<a name="a38" doxytag="ID3_Tag::SetSpec"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> bool ID3_Tag::SetSpec </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="globals_8h.html#a216">ID3_V2Spec</a> </td>
<td class="mdname1" valign="top" nowrap> <em>spec</em> </td>
<td class="md" valign="top">) </td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
<p>
Definition at line <a class="el" href="tag_8cpp-source.html#l00926">926</a> of file <a class="el" href="tag_8cpp-source.html">tag.cpp</a>.
<p>
References <a class="el" href="globals_8h-source.html#l00139">ID3_V2Spec</a>, <a class="el" href="tag__impl_8cpp-source.html#l00226">ID3_TagImpl::SetSpec</a>(), <a class="el" href="class_i_d3___tag_header.html#s10s8">ID3_TagHeader::SIZE</a>, and <a class="el" href="globals_8h-source.html#l00087">uchar</a>. </td>
</tr>
</table>
<a name="a55" doxytag="ID3_Tag::SetUnsync"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> bool ID3_Tag::SetUnsync </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top">bool </td>
<td class="mdname1" valign="top" nowrap> </td>
<td class="md" valign="top">) </td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
</td>
</tr>
</table>
<a name="a6" doxytag="ID3_Tag::SetUnsync"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> bool ID3_Tag::SetUnsync </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top">bool </td>
<td class="mdname1" valign="top" nowrap> <em>b</em> </td>
<td class="md" valign="top">) </td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
Turns unsynchronization on or off, dependant on the value of the boolean parameter.
<p>
If you call this method with 'false' as the parameter, the binary tag will not be unsync'ed, regardless of whether the tag should be. This option is useful when the file is only going to be used by ID3v2-compliant software. See the ID3v2 standard document for futher details on unsync.
<p>
Be default, tags are created without unsync.
<p>
<div class="fragment"><pre> myTag.SetUnsync(<font class="keyword">false</font>);
</pre></div><dl compact><dt><b>
Parameters: </b><dd>
<table border=0 cellspacing=2 cellpadding=0>
<tr><td valign=top><em>bSync</em> </td><td>
Whether the tag should be unsynchronized </td></tr>
</table>
</dl>
<p>
Definition at line <a class="el" href="tag_8cpp-source.html#l00406">406</a> of file <a class="el" href="tag_8cpp-source.html">tag.cpp</a>.
<p>
References <a class="el" href="tag__impl_8cpp-source.html#l00238">ID3_TagImpl::SetUnsync</a>(). </td>
</tr>
</table>
<a name="a54" doxytag="ID3_Tag::Size"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> size_t ID3_Tag::Size </td>
<td class="md" valign="top">( </td>
<td class="mdname1" valign="top" nowrap> </td>
<td class="md" valign="top">) </td>
<td class="md" nowrap> const</td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
</td>
</tr>
</table>
<a name="a5" doxytag="ID3_Tag::Size"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> size_t ID3_Tag::Size </td>
<td class="md" valign="top">( </td>
<td class="mdname1" valign="top" nowrap> </td>
<td class="md" valign="top">) </td>
<td class="md" nowrap> const</td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
Returns an over estimate of the number of bytes required to store a binary version of a tag.
<p>
When using <a class="el" href="class_i_d3___tag.html#a19">Render</a>() to render a binary tag to a memory buffer, first use the result of this call to allocate a buffer of unsigned chars.
<p>
<div class="fragment"><pre> <font class="keywordflow">if</font> (myTag.HasChanged())
{
size_t tagSize; = myTag.Size();
<font class="keywordflow">if</font> (tagSize > 0)
{
<a class="code" href="globals_8h.html#a33">uchar</a> *buffer = <font class="keyword">new</font> <a class="code" href="globals_8h.html#a33">uchar</a>[tagSize];
<font class="keywordflow">if</font> (<a class="code" href="globals_8h.html#a24">NULL</a> != buffer)
{
size_t actualSize = myTag.Render(buffer);
<font class="comment">// do something useful with the first</font>
<font class="comment">// 'actualSize' bytes of the buffer,</font>
<font class="comment">// like push it down a socket</font>
<font class="keyword">delete</font> [] buffer;
}
}
}
</pre></div>
<p>
<dl compact><dt><b>
See also: </b><dd>
<a class="el" href="class_i_d3___tag.html#a19">Render</a> </dl><dl compact><dt><b>
Returns: </b><dd>
The (overestimated) number of bytes required to store a binary version of a tag </dl>
<p>
Definition at line <a class="el" href="tag_8cpp-source.html#l00384">384</a> of file <a class="el" href="tag_8cpp-source.html">tag.cpp</a>.
<p>
References <a class="el" href="tag__render_8cpp-source.html#l00146">ID3_TagImpl::Size</a>(). </td>
</tr>
</table>
<a name="a72" doxytag="ID3_Tag::Strip"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> <a class="el" href="globals_8h.html#a40">flags_t</a> ID3_Tag::Strip </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="globals_8h.html#a40">flags_t</a> </td>
<td class="mdname1" valign="top" nowrap> = (<a class="el" href="globals_8h.html#a40">flags_t</a>) ID3TT_ALL </td>
<td class="md" valign="top">) </td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
</td>
</tr>
</table>
<a name="a23" doxytag="ID3_Tag::Strip"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> <a class="el" href="globals_8h.html#a40">flags_t</a> ID3_Tag::Strip </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="globals_8h.html#a40">flags_t</a> </td>
<td class="mdname1" valign="top" nowrap> <em>flags</em> = (<a class="el" href="globals_8h.html#a40">flags_t</a>) ID3TT_ALL </td>
<td class="md" valign="top">) </td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
Strips the tag(s) from the attached file.
<p>
The type of tag stripped can be specified as a parameter. The default is to strip all tag types.<dl compact><dt><b>
Parameters: </b><dd>
<table border=0 cellspacing=2 cellpadding=0>
<tr><td valign=top><em>tt</em> </td><td>
The type of tag to strip </td></tr>
</table>
</dl><dl compact><dt><b>
See also: </b><dd>
<a class="el" href="globals_8h.html#a217">ID3_TagType</a> </dl>
<p>
Definition at line <a class="el" href="tag_8cpp-source.html#l00727">727</a> of file <a class="el" href="tag_8cpp-source.html">tag.cpp</a>.
<p>
References <a class="el" href="globals_8h-source.html#l00095">flags_t</a>, and <a class="el" href="tag__file_8cpp-source.html#l00367">ID3_TagImpl::Strip</a>(). </td>
</tr>
</table>
<a name="a71" doxytag="ID3_Tag::Update"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> <a class="el" href="globals_8h.html#a40">flags_t</a> ID3_Tag::Update </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="globals_8h.html#a40">flags_t</a> </td>
<td class="mdname1" valign="top" nowrap> = (<a class="el" href="globals_8h.html#a40">flags_t</a>) ID3TT_ALL </td>
<td class="md" valign="top">) </td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
</td>
</tr>
</table>
<a name="a22" doxytag="ID3_Tag::Update"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> <a class="el" href="globals_8h.html#a40">flags_t</a> ID3_Tag::Update </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="globals_8h.html#a40">flags_t</a> </td>
<td class="mdname1" valign="top" nowrap> <em>flags</em> = (<a class="el" href="globals_8h.html#a40">flags_t</a>) ID3TT_ALL </td>
<td class="md" valign="top">) </td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
<p>
Definition at line <a class="el" href="tag_8cpp-source.html#l00716">716</a> of file <a class="el" href="tag_8cpp-source.html">tag.cpp</a>.
<p>
References <a class="el" href="globals_8h-source.html#l00095">flags_t</a>, and <a class="el" href="tag__file_8cpp-source.html#l00319">ID3_TagImpl::Update</a>(). </td>
</tr>
</table>
<hr>The documentation for this class was generated from the following files:<ul>
<li>src/<a class="el" href="tag_8cpp-source.html">tag.cpp</a><li>include/id3/<a class="el" href="tag_8h-source.html">tag.h</a></ul>
<hr><address><small>Generated on Thu Jan 3 07:35:57 2002 for id3lib by
<a href="http://www.doxygen.org/index.html">
<img src="doxygen.gif" alt="doxygen" align="middle" border=0
width=110 height=53></a>1.2.12 written by <a href="mailto:dimitri@stack.nl">Dimitri van Heesch</a>,
© 1997-2001</small></address>
</body>
</html>
distrib
>
Mandriva
>
8.2
>
i586
>
media
>
contrib
>
by-pkgid
>
2c9d30f3cf217a6cae41860ebc0d6704
>
files
>
75
