ucommon
|
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 COMMONCPP_TOKENIZER_H_ 00045 #define COMMONCPP_TOKENIZER_H_ 00046 00047 #ifndef COMMONCPP_CONFIG_H_ 00048 #include <commoncpp/config.h> 00049 #endif 00050 00051 #ifndef COMMONCPP_THREAD_H_ 00052 #include <commoncpp/thread.h> 00053 #endif 00054 00055 #ifndef COMMMONCPP_EXCEPTION_H_ 00056 #include <commoncpp/exception.h> 00057 #endif 00058 00059 NAMESPACE_COMMONCPP 00060 00104 class __EXPORT StringTokenizer { 00105 public: 00111 static const char * const SPACE; 00112 00122 // maybe move more global ? 00123 class NoSuchElementException { }; 00124 00129 class __EXPORT iterator { 00130 friend class StringTokenizer; // access our private constructors 00131 private: 00132 const StringTokenizer *myTok; // my StringTokenizer 00133 const char *start; // start of current token 00134 const char *tokEnd; // end of current token (->nxDelimiter) 00135 const char *endp; // one before next token 00136 char *token; // allocated token, if requested 00137 00138 // for initialization of the itEnd iterator 00139 iterator(const StringTokenizer &tok, const char *end) 00140 : myTok(&tok),tokEnd(0),endp(end),token(0) {} 00141 00142 iterator(const StringTokenizer &tok) 00143 : myTok(&tok),tokEnd(0),endp(myTok->str-1),token(0) { 00144 ++(*this); // init first token. 00145 } 00146 00147 public: 00148 iterator() : myTok(0),start(0),tokEnd(0),endp(0),token(0) {} 00149 00150 // see also: comment in implementation of operator++ 00151 virtual ~iterator() 00152 { if (token) *token='\0'; delete [] token; } 00153 00157 // everything, but not responsible for the allocated token. 00158 iterator(const iterator& i) : 00159 myTok(i.myTok),start(i.start),tokEnd(i.tokEnd), 00160 endp(i.endp),token(0) {} 00161 00165 // everything, but not responsible for the allocated token. 00166 iterator &operator = (const iterator &i) 00167 { 00168 myTok = i.myTok; 00169 start = i.start; endp = i.endp; tokEnd = i.tokEnd; 00170 if ( token ) 00171 delete [] token; 00172 token = 0; 00173 return *this; 00174 } 00175 00179 iterator &operator ++ () THROWS (NoSuchElementException); 00180 00189 const char* operator * () THROWS (NoSuchElementException); 00190 00197 inline char nextDelimiter() const 00198 {return (tokEnd) ? *tokEnd : '\0';} 00199 00204 // only compare the end-position. speed. 00205 inline bool operator == (const iterator &other) const 00206 {return (endp == other.endp);} 00207 00212 // only compare the end position. speed. 00213 inline bool operator != (const iterator &other) const 00214 {return (endp != other.endp);} 00215 }; 00216 private: 00217 friend class StringTokenizer::iterator; 00218 const char *str; 00219 const char *delim; 00220 bool skipAll, trim; 00221 iterator itEnd; 00222 00223 public: 00262 StringTokenizer (const char *str, 00263 const char *delim, 00264 bool skipAllDelim = false, 00265 bool trim = false); 00266 00276 StringTokenizer (const char *s); 00277 00281 iterator begin() const 00282 {return iterator(*this);} 00283 00288 void setDelimiters (const char *d) 00289 {delim = d;} 00290 00295 iterator begin(const char *d) 00296 { 00297 delim = d; 00298 return iterator(*this); 00299 } 00300 00304 const iterator& end() const 00305 {return itEnd;} 00306 }; 00307 00308 END_NAMESPACE 00309 00310 #endif 00311