GNU CommonC++
|
00001 // Copyright (C) 1999-2005 Open Source Telecom Corporation. 00002 // Copyright (C) 2006-2010 David Sugar, Tycho Softworks. 00003 // 00004 // This program is free software; you can redistribute it and/or modify 00005 // it under the terms of the GNU General Public License as published by 00006 // the Free Software Foundation; either version 2 of the License, or 00007 // (at your option) any later version. 00008 // 00009 // This program is distributed in the hope that it will be useful, 00010 // but WITHOUT ANY WARRANTY; without even the implied warranty of 00011 // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the 00012 // GNU General Public License for more details. 00013 // 00014 // You should have received a copy of the GNU General Public License 00015 // along with this program; if not, write to the Free Software 00016 // Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. 00017 // 00018 // As a special exception, you may use this file as part of a free software 00019 // library without restriction. Specifically, if other files instantiate 00020 // templates or use macros or inline functions from this file, or you compile 00021 // this file and link it with other files to produce an executable, this 00022 // file does not by itself cause the resulting executable to be covered by 00023 // the GNU General Public License. This exception does not however 00024 // invalidate any other reasons why the executable file might be covered by 00025 // the GNU General Public License. 00026 // 00027 // This exception applies only to the code released under the name GNU 00028 // Common C++. If you copy code from other releases into a copy of GNU 00029 // Common C++, as the General Public License permits, the exception does 00030 // not apply to the code that you add in this way. To avoid misleading 00031 // anyone as to the status of such modified files, you must delete 00032 // this exception notice from them. 00033 // 00034 // If you write modifications of your own for GNU Common C++, it is your choice 00035 // whether to permit this exception to apply to your modifications. 00036 // If you do not wish that, delete this exception notice. 00037 // 00038 00044 #ifndef CCXX_TOKENIZER_H_ 00045 #define CCXX_TOKENIZER_H_ 00046 00047 #ifndef CCXX_MISSING_H_ 00048 #include <cc++/missing.h> 00049 #endif 00050 00051 #ifndef CCXX_THREAD_H_ 00052 #include <cc++/thread.h> 00053 #endif 00054 00055 #ifdef CCXX_NAMESPACES 00056 namespace ost { 00057 #endif 00058 00102 class __EXPORT StringTokenizer { 00103 public: 00109 static const char * const SPACE; 00110 00120 // maybe move more global ? 00121 class NoSuchElementException { }; 00122 00127 class __EXPORT iterator { 00128 friend class StringTokenizer; // access our private constructors 00129 private: 00130 const StringTokenizer *myTok; // my StringTokenizer 00131 const char *start; // start of current token 00132 const char *tokEnd; // end of current token (->nxDelimiter) 00133 const char *endp; // one before next token 00134 char *token; // allocated token, if requested 00135 00136 // for initialization of the itEnd iterator 00137 iterator(const StringTokenizer &tok, const char *end) 00138 : myTok(&tok),tokEnd(0),endp(end),token(0) {} 00139 00140 iterator(const StringTokenizer &tok) 00141 : myTok(&tok),tokEnd(0),endp(myTok->str-1),token(0) { 00142 ++(*this); // init first token. 00143 } 00144 00145 public: 00146 iterator() : myTok(0),start(0),tokEnd(0),endp(0),token(0) {} 00147 00148 // see also: comment in implementation of operator++ 00149 virtual ~iterator() 00150 { if (token) *token='\0'; delete [] token; } 00151 00155 // everything, but not responsible for the allocated token. 00156 iterator(const iterator& i) : 00157 myTok(i.myTok),start(i.start),tokEnd(i.tokEnd), 00158 endp(i.endp),token(0) {} 00159 00163 // everything, but not responsible for the allocated token. 00164 iterator &operator = (const iterator &i) 00165 { 00166 myTok = i.myTok; 00167 start = i.start; endp = i.endp; tokEnd = i.tokEnd; 00168 if ( token ) 00169 delete [] token; 00170 token = 0; 00171 return *this; 00172 } 00173 00177 iterator &operator ++ () THROWS (NoSuchElementException); 00178 00187 const char* operator * () THROWS (NoSuchElementException); 00188 00195 inline char nextDelimiter() const 00196 {return (tokEnd) ? *tokEnd : '\0';} 00197 00202 // only compare the end-position. speed. 00203 inline bool operator == (const iterator &other) const 00204 {return (endp == other.endp);} 00205 00210 // only compare the end position. speed. 00211 inline bool operator != (const iterator &other) const 00212 {return (endp != other.endp);} 00213 }; 00214 private: 00215 friend class StringTokenizer::iterator; 00216 const char *str; 00217 const char *delim; 00218 bool skipAll, trim; 00219 iterator itEnd; 00220 00221 public: 00260 StringTokenizer (const char *str, 00261 const char *delim, 00262 bool skipAllDelim = false, 00263 bool trim = false); 00264 00274 StringTokenizer (const char *s); 00275 00279 iterator begin() const 00280 {return iterator(*this);} 00281 00286 void setDelimiters (const char *d) 00287 {delim = d;} 00288 00293 iterator begin(const char *d) 00294 { 00295 delim = d; 00296 return iterator(*this); 00297 } 00298 00302 const iterator& end() const 00303 {return itEnd;} 00304 }; 00305 00306 #ifdef CCXX_NAMESPACES 00307 } 00308 #endif 00309 00310 #endif 00311