Sophie

Sophie

distrib > Mageia > 1 > i586 > media > core-release > by-pkgid > 1b812d1b0e765bcc0430721ff58676d2 > files > 306

libid3_3.8_3-devel-3.8.3-19.mga1.i586.rpm

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
<title>id3lib: src/tag_find.cpp Source File</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<link href="id3lib.css" rel="stylesheet" type="text/css"/>
</head>
<body>
<!-- Generated by Doxygen 1.6.3 -->
<div class="navigation" id="top">
  <div class="tabs">
    <ul>
      <li><a href="index.html"><span>Main&nbsp;Page</span></a></li>
      <li><a href="namespaces.html"><span>Namespaces</span></a></li>
      <li><a href="annotated.html"><span>Classes</span></a></li>
      <li class="current"><a href="files.html"><span>Files</span></a></li>
    </ul>
  </div>
  <div class="tabs">
    <ul>
      <li><a href="files.html"><span>File&nbsp;List</span></a></li>
      <li><a href="globals.html"><span>File&nbsp;Members</span></a></li>
    </ul>
  </div>
<h1>src/tag_find.cpp</h1><a href="tag__find_8cpp.html">Go to the documentation of this file.</a><div class="fragment"><pre class="fragment"><a name="l00001"></a>00001 <span class="comment">// $Id: tag_find.cpp,v 1.28 2003/03/02 14:39:25 t1mpy Exp $</span>
<a name="l00002"></a>00002 
<a name="l00003"></a>00003 <span class="comment">// id3lib: a C++ library for creating and manipulating id3v1/v2 tags</span>
<a name="l00004"></a>00004 <span class="comment">// Copyright 1999, 2000  Scott Thomas Haug</span>
<a name="l00005"></a>00005 
<a name="l00006"></a>00006 <span class="comment">// This library is free software; you can redistribute it and/or modify it</span>
<a name="l00007"></a>00007 <span class="comment">// under the terms of the GNU Library General Public License as published by</span>
<a name="l00008"></a>00008 <span class="comment">// the Free Software Foundation; either version 2 of the License, or (at your</span>
<a name="l00009"></a>00009 <span class="comment">// option) any later version.</span>
<a name="l00010"></a>00010 <span class="comment">//</span>
<a name="l00011"></a>00011 <span class="comment">// This library is distributed in the hope that it will be useful, but WITHOUT</span>
<a name="l00012"></a>00012 <span class="comment">// ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or</span>
<a name="l00013"></a>00013 <span class="comment">// FITNESS FOR A PARTICULAR PURPOSE.  See the GNU Library General Public</span>
<a name="l00014"></a>00014 <span class="comment">// License for more details.</span>
<a name="l00015"></a>00015 <span class="comment">//</span>
<a name="l00016"></a>00016 <span class="comment">// You should have received a copy of the GNU Library General Public License</span>
<a name="l00017"></a>00017 <span class="comment">// along with this library; if not, write to the Free Software Foundation,</span>
<a name="l00018"></a>00018 <span class="comment">// Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.</span>
<a name="l00019"></a>00019 
<a name="l00020"></a>00020 <span class="comment">// The id3lib authors encourage improvements and optimisations to be sent to</span>
<a name="l00021"></a>00021 <span class="comment">// the id3lib coordinator.  Please see the README file for details on where to</span>
<a name="l00022"></a>00022 <span class="comment">// send such submissions.  See the AUTHORS file for a list of people who have</span>
<a name="l00023"></a>00023 <span class="comment">// contributed to id3lib.  See the ChangeLog file for a list of changes to</span>
<a name="l00024"></a>00024 <span class="comment">// id3lib.  These files are distributed with id3lib at</span>
<a name="l00025"></a>00025 <span class="comment">// http://download.sourceforge.net/id3lib/</span>
<a name="l00026"></a>00026 
<a name="l00027"></a>00027 <span class="preprocessor">#include &quot;<a class="code" href="tag__impl_8h.html">tag_impl.h</a>&quot;</span> <span class="comment">//has &lt;stdio.h&gt; &quot;tag.h&quot; &quot;header_tag.h&quot; &quot;frame.h&quot; &quot;field.h&quot; &quot;spec.h&quot; &quot;id3lib_strings.h&quot; &quot;utils.h&quot;</span>
<a name="l00028"></a>00028 
<a name="l00029"></a>00029 <span class="keyword">using namespace </span>dami;
<a name="l00030"></a>00030 
<a name="l00031"></a><a class="code" href="class_i_d3___tag_impl.html#ad25eec76eeec71f958431717eb3e6f00">00031</a> <a class="code" href="class_i_d3___tag_impl.html#aa682023c07df47c19db046540d260d08">ID3_TagImpl::const_iterator</a> <a class="code" href="class_i_d3___tag_impl.html#ae2a17dca1c627e387cc4e351fff11eeb">ID3_TagImpl::Find</a>(<span class="keyword">const</span> <a class="code" href="class_i_d3___frame.html" title="The representative class of an id3v2 frame.">ID3_Frame</a> *frame)<span class="keyword"> const</span>
<a name="l00032"></a>00032 <span class="keyword"></span>{
<a name="l00033"></a>00033   <a class="code" href="class_i_d3___tag_impl.html#aa682023c07df47c19db046540d260d08">const_iterator</a> cur = _frames.begin();
<a name="l00034"></a>00034 
<a name="l00035"></a>00035   <span class="keywordflow">for</span> (; cur != _frames.end(); ++cur)
<a name="l00036"></a>00036   {
<a name="l00037"></a>00037     <span class="keywordflow">if</span> (*cur == frame)
<a name="l00038"></a>00038     {
<a name="l00039"></a>00039       <span class="keywordflow">break</span>;
<a name="l00040"></a>00040     }
<a name="l00041"></a>00041   }
<a name="l00042"></a>00042 
<a name="l00043"></a>00043   <span class="keywordflow">return</span> cur;
<a name="l00044"></a>00044 }
<a name="l00045"></a>00045 
<a name="l00046"></a><a class="code" href="class_i_d3___tag_impl.html#accfcaadd685234dab46d8b98dbec449a">00046</a> <a class="code" href="class_i_d3___tag_impl.html#a65a396e4561ed22e3feebc4e30c91bf4">ID3_TagImpl::iterator</a> <a class="code" href="class_i_d3___tag_impl.html#ae2a17dca1c627e387cc4e351fff11eeb">ID3_TagImpl::Find</a>(<span class="keyword">const</span> <a class="code" href="class_i_d3___frame.html" title="The representative class of an id3v2 frame.">ID3_Frame</a> *frame)
<a name="l00047"></a>00047 {
<a name="l00048"></a>00048   <a class="code" href="class_i_d3___tag_impl.html#a65a396e4561ed22e3feebc4e30c91bf4">iterator</a> cur = _frames.begin();
<a name="l00049"></a>00049 
<a name="l00050"></a>00050   <span class="keywordflow">for</span> (; cur != _frames.end(); ++cur)
<a name="l00051"></a>00051   {
<a name="l00052"></a>00052     <span class="keywordflow">if</span> (*cur == frame)
<a name="l00053"></a>00053     {
<a name="l00054"></a>00054       <span class="keywordflow">break</span>;
<a name="l00055"></a>00055     }
<a name="l00056"></a>00056   }
<a name="l00057"></a>00057 
<a name="l00058"></a>00058   <span class="keywordflow">return</span> cur;
<a name="l00059"></a>00059 }
<a name="l00060"></a>00060 
<a name="l00061"></a><a class="code" href="class_i_d3___tag_impl.html#ae2a17dca1c627e387cc4e351fff11eeb">00061</a> <a class="code" href="class_i_d3___frame.html" title="The representative class of an id3v2 frame.">ID3_Frame</a> *<a class="code" href="class_i_d3___tag_impl.html#ae2a17dca1c627e387cc4e351fff11eeb">ID3_TagImpl::Find</a>(<a class="code" href="globals_8h.html#a78f454bf66f16b1e1c9f8e37bda9ab8a" title="Enumeration of the different types of frames recognized by id3lib.">ID3_FrameID</a> <span class="keywordtype">id</span>)<span class="keyword"> const</span>
<a name="l00062"></a>00062 <span class="keyword"></span>{
<a name="l00063"></a>00063   <a class="code" href="class_i_d3___frame.html" title="The representative class of an id3v2 frame.">ID3_Frame</a> *frame = <a class="code" href="globals_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a>;
<a name="l00064"></a>00064 
<a name="l00065"></a>00065   <span class="comment">// reset the cursor if it isn&#39;t set</span>
<a name="l00066"></a>00066   <span class="keywordflow">if</span> (_frames.end() == _cursor)
<a name="l00067"></a>00067   {
<a name="l00068"></a>00068     _cursor = _frames.begin();
<a name="l00069"></a>00069   }
<a name="l00070"></a>00070 
<a name="l00071"></a>00071 
<a name="l00072"></a>00072   <span class="keywordflow">for</span> (<span class="keywordtype">int</span> iCount = 0; iCount &lt; 2 &amp;&amp; frame == <a class="code" href="globals_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a>; iCount++)
<a name="l00073"></a>00073   {
<a name="l00074"></a>00074     <span class="comment">// We want to cycle through the list to find the matching frame.  We</span>
<a name="l00075"></a>00075     <span class="comment">// should begin from the cursor, search each successive frame, wrapping</span>
<a name="l00076"></a>00076     <span class="comment">// if necessary.  The enclosing loop and the assignment statments below</span>
<a name="l00077"></a>00077     <span class="comment">// ensure that we first begin at the cursor and search to the end of the</span>
<a name="l00078"></a>00078     <span class="comment">// list and, if unsuccessful, start from the beginning of the list and</span>
<a name="l00079"></a>00079     <span class="comment">// search to the cursor.</span>
<a name="l00080"></a>00080     <a class="code" href="class_i_d3___tag_impl.html#aa682023c07df47c19db046540d260d08">const_iterator</a>
<a name="l00081"></a>00081       <a class="code" href="class_i_d3___tag_impl.html#a9e0d55c54fb3697b9ebb34d060bfa101">begin</a>  = (0 == iCount ? _cursor       : _frames.begin()),
<a name="l00082"></a>00082       <a class="code" href="class_i_d3___tag_impl.html#af20fcbf50b599ea55b0ec955bcad1a9d">end</a>    = (0 == iCount ? _frames.end() : _cursor);
<a name="l00083"></a>00083     <span class="comment">// search from the cursor to the end</span>
<a name="l00084"></a>00084     <span class="keywordflow">for</span> (<a class="code" href="class_i_d3___tag_impl.html#aa682023c07df47c19db046540d260d08">const_iterator</a> cur = begin; cur != <a class="code" href="class_i_d3___tag_impl.html#af20fcbf50b599ea55b0ec955bcad1a9d">end</a>; ++cur)
<a name="l00085"></a>00085     {
<a name="l00086"></a>00086       <span class="keywordflow">if</span> ((*cur != <a class="code" href="globals_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a>) &amp;&amp; ((*cur)-&gt;GetID() == id))
<a name="l00087"></a>00087       {
<a name="l00088"></a>00088         <span class="comment">// We&#39;ve found a valid frame.  Set the cursor to be the next element</span>
<a name="l00089"></a>00089         frame = *cur;
<a name="l00090"></a>00090         _cursor = ++cur;
<a name="l00091"></a>00091         <span class="keywordflow">break</span>;
<a name="l00092"></a>00092       }
<a name="l00093"></a>00093     }
<a name="l00094"></a>00094   }
<a name="l00095"></a>00095 
<a name="l00096"></a>00096   <span class="keywordflow">return</span> frame;
<a name="l00097"></a>00097 }
<a name="l00098"></a>00098 
<a name="l00099"></a>00099 <a class="code" href="class_i_d3___frame.html" title="The representative class of an id3v2 frame.">ID3_Frame</a> *<a class="code" href="class_i_d3___tag_impl.html#ae2a17dca1c627e387cc4e351fff11eeb">ID3_TagImpl::Find</a>(<a class="code" href="globals_8h.html#a78f454bf66f16b1e1c9f8e37bda9ab8a" title="Enumeration of the different types of frames recognized by id3lib.">ID3_FrameID</a> <span class="keywordtype">id</span>, <a class="code" href="globals_8h.html#a23cab982426a968437cd731900cfeb2c" title="Enumeration of the different types of fields in a frame.">ID3_FieldID</a> fldID, String data)<span class="keyword"> const</span>
<a name="l00100"></a>00100 <span class="keyword"></span>{
<a name="l00101"></a>00101   <a class="code" href="class_i_d3___frame.html" title="The representative class of an id3v2 frame.">ID3_Frame</a> *frame = <a class="code" href="globals_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a>;
<a name="l00102"></a>00102   ID3D_NOTICE( <span class="stringliteral">&quot;Find: looking for comment with data = &quot;</span> &lt;&lt; data.c_str() );
<a name="l00103"></a>00103 
<a name="l00104"></a>00104   <span class="comment">// reset the cursor if it isn&#39;t set</span>
<a name="l00105"></a>00105   <span class="keywordflow">if</span> (_frames.end() == _cursor)
<a name="l00106"></a>00106   {
<a name="l00107"></a>00107     _cursor = _frames.begin();
<a name="l00108"></a>00108     ID3D_NOTICE( <span class="stringliteral">&quot;Find: resetting cursor&quot;</span> );
<a name="l00109"></a>00109   }
<a name="l00110"></a>00110 
<a name="l00111"></a>00111   <span class="keywordflow">for</span> (<span class="keywordtype">int</span> iCount = 0; iCount &lt; 2 &amp;&amp; frame == <a class="code" href="globals_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a>; iCount++)
<a name="l00112"></a>00112   {
<a name="l00113"></a>00113     ID3D_NOTICE( <span class="stringliteral">&quot;Find: iCount = &quot;</span> &lt;&lt; iCount );
<a name="l00114"></a>00114     <span class="comment">// We want to cycle through the list to find the matching frame.  We</span>
<a name="l00115"></a>00115     <span class="comment">// should begin from the cursor, search each successive frame, wrapping</span>
<a name="l00116"></a>00116     <span class="comment">// if necessary.  The enclosing loop and the assignment statments below</span>
<a name="l00117"></a>00117     <span class="comment">// ensure that we first begin at the cursor and search to the end of the</span>
<a name="l00118"></a>00118     <span class="comment">// list and, if unsuccessful, start from the beginning of the list and</span>
<a name="l00119"></a>00119     <span class="comment">// search to the cursor.</span>
<a name="l00120"></a>00120     <a class="code" href="class_i_d3___tag_impl.html#aa682023c07df47c19db046540d260d08">const_iterator</a>
<a name="l00121"></a>00121       <a class="code" href="class_i_d3___tag_impl.html#a9e0d55c54fb3697b9ebb34d060bfa101">begin</a>  = (0 == iCount ? _cursor       : _frames.begin()),
<a name="l00122"></a>00122       <a class="code" href="class_i_d3___tag_impl.html#af20fcbf50b599ea55b0ec955bcad1a9d">end</a>    = (0 == iCount ? _frames.end() : _cursor);
<a name="l00123"></a>00123     <span class="comment">// search from the cursor to the end</span>
<a name="l00124"></a>00124     <span class="keywordflow">for</span> (<a class="code" href="class_i_d3___tag_impl.html#aa682023c07df47c19db046540d260d08">const_iterator</a> cur = begin; cur != <a class="code" href="class_i_d3___tag_impl.html#af20fcbf50b599ea55b0ec955bcad1a9d">end</a>; ++cur)
<a name="l00125"></a>00125     {
<a name="l00126"></a>00126       ID3D_NOTICE( <span class="stringliteral">&quot;Find: frame = 0x&quot;</span> &lt;&lt; hex &lt;&lt; (uint32) *cur &lt;&lt; dec );
<a name="l00127"></a>00127       <span class="keywordflow">if</span> ((*cur != <a class="code" href="globals_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a>) &amp;&amp; ((*cur)-&gt;GetID() == id) &amp;&amp;
<a name="l00128"></a>00128           (*cur)-&gt;Contains(fldID))
<a name="l00129"></a>00129       {
<a name="l00130"></a>00130         <a class="code" href="class_i_d3___field.html" title="The representative class of an ID3v2 field.">ID3_Field</a>* fld = (*cur)-&gt;GetField(fldID);
<a name="l00131"></a>00131         <span class="keywordflow">if</span> (<a class="code" href="globals_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a> == fld)
<a name="l00132"></a>00132         {
<a name="l00133"></a>00133           <span class="keywordflow">continue</span>;
<a name="l00134"></a>00134           ID3D_NOTICE( <span class="stringliteral">&quot;Find: didn&#39;t have the right field&quot;</span> );
<a name="l00135"></a>00135         }
<a name="l00136"></a>00136 
<a name="l00137"></a>00137         String text( <a class="code" href="globals_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a> == fld-&gt;<a class="code" href="class_i_d3___field.html#a1b306f45543afd5459e77200a0fc0a1f">GetRawText</a>() ? <span class="stringliteral">&quot;&quot;</span> : fld-&gt;<a class="code" href="class_i_d3___field.html#a1b306f45543afd5459e77200a0fc0a1f">GetRawText</a>() , fld-&gt;<a class="code" href="class_i_d3___field.html#a4eed557e9f540d3c9347ac31f0f8e55b" title="Returns the size of a field.">Size</a>()); <span class="comment">//PHF</span>
<a name="l00138"></a>00138         ID3D_NOTICE( <span class="stringliteral">&quot;Find: text = &quot;</span> &lt;&lt; text.c_str() );
<a name="l00139"></a>00139 
<a name="l00140"></a>00140         <span class="keywordflow">if</span> (text == data)
<a name="l00141"></a>00141         {
<a name="l00142"></a>00142           <span class="comment">// We&#39;ve found a valid frame.  Set cursor to be the next element</span>
<a name="l00143"></a>00143           frame = *cur;
<a name="l00144"></a>00144           _cursor = ++cur;
<a name="l00145"></a>00145           <span class="keywordflow">break</span>;
<a name="l00146"></a>00146         }
<a name="l00147"></a>00147       }
<a name="l00148"></a>00148     }
<a name="l00149"></a>00149   }
<a name="l00150"></a>00150 
<a name="l00151"></a>00151   <span class="keywordflow">return</span> frame;
<a name="l00152"></a>00152 }
<a name="l00153"></a>00153 
<a name="l00154"></a>00154 <a class="code" href="class_i_d3___frame.html" title="The representative class of an id3v2 frame.">ID3_Frame</a> *<a class="code" href="class_i_d3___tag_impl.html#ae2a17dca1c627e387cc4e351fff11eeb">ID3_TagImpl::Find</a>(<a class="code" href="globals_8h.html#a78f454bf66f16b1e1c9f8e37bda9ab8a" title="Enumeration of the different types of frames recognized by id3lib.">ID3_FrameID</a> <span class="keywordtype">id</span>, <a class="code" href="globals_8h.html#a23cab982426a968437cd731900cfeb2c" title="Enumeration of the different types of fields in a frame.">ID3_FieldID</a> fldID, WString data)<span class="keyword"> const</span>
<a name="l00155"></a>00155 <span class="keyword"></span>{
<a name="l00156"></a>00156   <a class="code" href="class_i_d3___frame.html" title="The representative class of an id3v2 frame.">ID3_Frame</a> *frame = <a class="code" href="globals_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a>;
<a name="l00157"></a>00157 
<a name="l00158"></a>00158   <span class="comment">// reset the cursor if it isn&#39;t set</span>
<a name="l00159"></a>00159   <span class="keywordflow">if</span> (_frames.end() == _cursor)
<a name="l00160"></a>00160   {
<a name="l00161"></a>00161     _cursor = _frames.begin();
<a name="l00162"></a>00162   }
<a name="l00163"></a>00163 
<a name="l00164"></a>00164   <span class="keywordflow">for</span> (<span class="keywordtype">int</span> iCount = 0; iCount &lt; 2 &amp;&amp; frame == <a class="code" href="globals_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a>; iCount++)
<a name="l00165"></a>00165   {
<a name="l00166"></a>00166     <span class="comment">// We want to cycle through the list to find the matching frame.  We</span>
<a name="l00167"></a>00167     <span class="comment">// should begin from the cursor, search each successive frame, wrapping</span>
<a name="l00168"></a>00168     <span class="comment">// if necessary.  The enclosing loop and the assignment statments below</span>
<a name="l00169"></a>00169     <span class="comment">// ensure that we first begin at the cursor and search to the end of the</span>
<a name="l00170"></a>00170     <span class="comment">// list and, if unsuccessful, start from the beginning of the list and</span>
<a name="l00171"></a>00171     <span class="comment">// search to the cursor.</span>
<a name="l00172"></a>00172     <a class="code" href="class_i_d3___tag_impl.html#aa682023c07df47c19db046540d260d08">const_iterator</a>
<a name="l00173"></a>00173       begin  = (0 == iCount ? _cursor       : _frames.begin()),
<a name="l00174"></a>00174       <a class="code" href="class_i_d3___tag_impl.html#af20fcbf50b599ea55b0ec955bcad1a9d">end</a>    = (0 == iCount ? _frames.end() : _cursor);
<a name="l00175"></a>00175     <span class="comment">// search from the cursor to the end</span>
<a name="l00176"></a>00176     <span class="keywordflow">for</span> (<a class="code" href="class_i_d3___tag_impl.html#aa682023c07df47c19db046540d260d08">const_iterator</a> cur = begin; cur != <a class="code" href="class_i_d3___tag_impl.html#af20fcbf50b599ea55b0ec955bcad1a9d">end</a>; ++cur)
<a name="l00177"></a>00177     {
<a name="l00178"></a>00178       <span class="keywordflow">if</span> ((*cur != <a class="code" href="globals_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a>) &amp;&amp; ((*cur)-&gt;GetID() == id) &amp;&amp;
<a name="l00179"></a>00179           (*cur)-&gt;Contains(fldID))
<a name="l00180"></a>00180       {
<a name="l00181"></a>00181         <a class="code" href="class_i_d3___field.html" title="The representative class of an ID3v2 field.">ID3_Field</a>* fld = (*cur)-&gt;GetField(fldID);
<a name="l00182"></a>00182         <span class="keywordflow">if</span> (<a class="code" href="globals_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a> == fld)
<a name="l00183"></a>00183         {
<a name="l00184"></a>00184           <span class="keywordflow">continue</span>;
<a name="l00185"></a>00185         }
<a name="l00186"></a>00186         WString text = toWString(fld-&gt;<a class="code" href="class_i_d3___field.html#a1fdd1975e77a4be34bda5f41c319dac7">GetRawUnicodeText</a>(), fld-&gt;<a class="code" href="class_i_d3___field.html#a4eed557e9f540d3c9347ac31f0f8e55b" title="Returns the size of a field.">Size</a>());
<a name="l00187"></a>00187 
<a name="l00188"></a>00188         <span class="keywordflow">if</span> (text == data)
<a name="l00189"></a>00189         {
<a name="l00190"></a>00190           <span class="comment">// We&#39;ve found a valid frame.  Set cursor to be the next element</span>
<a name="l00191"></a>00191           frame = *cur;
<a name="l00192"></a>00192           _cursor = ++cur;
<a name="l00193"></a>00193           <span class="keywordflow">break</span>;
<a name="l00194"></a>00194         }
<a name="l00195"></a>00195       }
<a name="l00196"></a>00196     }
<a name="l00197"></a>00197   }
<a name="l00198"></a>00198 
<a name="l00199"></a>00199   <span class="keywordflow">return</span> frame;
<a name="l00200"></a>00200 }
<a name="l00201"></a>00201 
<a name="l00202"></a><a class="code" href="class_i_d3___tag_impl.html#adb2f268886a34c4dffbd93a3efa041d3">00202</a> <a class="code" href="class_i_d3___frame.html" title="The representative class of an id3v2 frame.">ID3_Frame</a> *<a class="code" href="class_i_d3___tag_impl.html#ae2a17dca1c627e387cc4e351fff11eeb">ID3_TagImpl::Find</a>(<a class="code" href="globals_8h.html#a78f454bf66f16b1e1c9f8e37bda9ab8a" title="Enumeration of the different types of frames recognized by id3lib.">ID3_FrameID</a> <span class="keywordtype">id</span>, <a class="code" href="globals_8h.html#a23cab982426a968437cd731900cfeb2c" title="Enumeration of the different types of fields in a frame.">ID3_FieldID</a> fldID, uint32 data)<span class="keyword"> const</span>
<a name="l00203"></a>00203 <span class="keyword"></span>{
<a name="l00204"></a>00204   <a class="code" href="class_i_d3___frame.html" title="The representative class of an id3v2 frame.">ID3_Frame</a> *frame = <a class="code" href="globals_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a>;
<a name="l00205"></a>00205 
<a name="l00206"></a>00206   <span class="comment">// reset the cursor if it isn&#39;t set</span>
<a name="l00207"></a>00207   <span class="keywordflow">if</span> (_frames.end() == _cursor)
<a name="l00208"></a>00208   {
<a name="l00209"></a>00209     _cursor = _frames.begin();
<a name="l00210"></a>00210   }
<a name="l00211"></a>00211 
<a name="l00212"></a>00212   <span class="keywordflow">for</span> (<span class="keywordtype">int</span> iCount = 0; iCount &lt; 2 &amp;&amp; frame == <a class="code" href="globals_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a>; iCount++)
<a name="l00213"></a>00213   {
<a name="l00214"></a>00214     <span class="comment">// We want to cycle through the list to find the matching frame.  We</span>
<a name="l00215"></a>00215     <span class="comment">// should begin from the cursor, search each successive frame, wrapping</span>
<a name="l00216"></a>00216     <span class="comment">// if necessary.  The enclosing loop and the assignment statments below</span>
<a name="l00217"></a>00217     <span class="comment">// ensure that we first begin at the cursor and search to the end of the</span>
<a name="l00218"></a>00218     <span class="comment">// list and, if unsuccessful, start from the beginning of the list and</span>
<a name="l00219"></a>00219     <span class="comment">// search to the cursor.</span>
<a name="l00220"></a>00220     <a class="code" href="class_i_d3___tag_impl.html#aa682023c07df47c19db046540d260d08">const_iterator</a>
<a name="l00221"></a>00221       begin  = (0 == iCount ? _cursor       : _frames.begin()),
<a name="l00222"></a>00222       <a class="code" href="class_i_d3___tag_impl.html#af20fcbf50b599ea55b0ec955bcad1a9d">end</a>    = (0 == iCount ? _frames.end() : _cursor);
<a name="l00223"></a>00223     <span class="comment">// search from the cursor to the end</span>
<a name="l00224"></a>00224     <span class="keywordflow">for</span> (<a class="code" href="class_i_d3___tag_impl.html#aa682023c07df47c19db046540d260d08">const_iterator</a> cur = begin; cur != <a class="code" href="class_i_d3___tag_impl.html#af20fcbf50b599ea55b0ec955bcad1a9d">end</a>; ++cur)
<a name="l00225"></a>00225     {
<a name="l00226"></a>00226       <span class="keywordflow">if</span> ((*cur != <a class="code" href="globals_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a>) &amp;&amp; ((*cur)-&gt;GetID() == id) &amp;&amp;
<a name="l00227"></a>00227           ((*cur)-&gt;GetField(fldID)-&gt;Get() == data))
<a name="l00228"></a>00228       {
<a name="l00229"></a>00229         <span class="comment">// We&#39;ve found a valid frame.  Set the cursor to be the next element</span>
<a name="l00230"></a>00230         frame = *cur;
<a name="l00231"></a>00231         _cursor = ++cur;
<a name="l00232"></a>00232         <span class="keywordflow">break</span>;
<a name="l00233"></a>00233       }
<a name="l00234"></a>00234     }
<a name="l00235"></a>00235   }
<a name="l00236"></a>00236 
<a name="l00237"></a>00237   <span class="keywordflow">return</span> frame;
<a name="l00238"></a>00238 }
<a name="l00239"></a>00239 
</pre></div></div>
<hr class="footer"/><address style="text-align: right;"><small>Generated on Wed Jan 12 23:46:35 2011 for id3lib by&nbsp;
<a href="http://www.doxygen.org/index.html">
<img class="footer" src="doxygen.png" alt="doxygen"/></a> 1.6.3 </small></address>
</body>
</html>