File indexing completed on 2024-04-28 16:08:39
0001 /*************************************************************************** 0002 * Copyright (C) 2014 by Linuxstopmotion contributors; * 0003 * see the AUTHORS file for details. * 0004 * * 0005 * This program is free software; you can redistribute it and/or modify * 0006 * it under the terms of the GNU General Public License as published by * 0007 * the Free Software Foundation; either version 2 of the License, or * 0008 * (at your option) any later version. * 0009 * * 0010 * This program is distributed in the hope that it will be useful, * 0011 * but WITHOUT ANY WARRANTY; without even the implied warranty of * 0012 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * 0013 * GNU General Public License for more details. * 0014 * * 0015 * You should have received a copy of the GNU General Public License * 0016 * along with this program; if not, write to the * 0017 * Free Software Foundation, Inc., * 0018 * 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. * 0019 ***************************************************************************/ 0020 0021 #ifndef STRINGITERATOR_H_ 0022 #define STRINGITERATOR_H_ 0023 0024 class StringIterator { 0025 public: 0026 virtual ~StringIterator(); 0027 /** 0028 * The total number of elements in the iteration. After this call the 0029 * iteration is permitted to be at the start of the iteration or where 0030 * you left it, so it is safest to call this only when {@ref next} has 0031 * never been called. 0032 */ 0033 virtual int count() = 0; 0034 /** 0035 * Have we reached the end of the iteration? 0036 * @return {@c false} if {@ref next} can be called. 0037 */ 0038 virtual bool atEnd() const = 0; 0039 /** 0040 * The current value. Behaviour is undefined if {@ref atEnd} returned 0041 * {@c true} (or would have done if called). 0042 * @return The string. Ownership is not passed. The returned memory is not 0043 * guaranteed to exist beyond the next call to {@ref next}. 0044 */ 0045 virtual const char* get() const = 0; 0046 /** 0047 * Move to the next value. Behaviour is undefined if {@ref atEnd} returned 0048 * {@c true} (or would have done if called). 0049 */ 0050 virtual void next() = 0; 0051 }; 0052 0053 #endif /* STRINGITERATOR_H_ */