UCommon
/usr/src/RPM/BUILD/ucommon-6.3.3/inc/commoncpp/tokenizer.h
Go to the documentation of this file.
00001 // Copyright (C) 1999-2005 Open Source Telecom Corporation.
00002 // Copyright (C) 2006-2014 David Sugar, Tycho Softworks.
00003 // Copyright (C) 2015 Cherokees of Idaho.
00004 //
00005 // This program is free software; you can redistribute it and/or modify
00006 // it under the terms of the GNU General Public License as published by
00007 // the Free Software Foundation; either version 2 of the License, or
00008 // (at your option) any later version.
00009 //
00010 // This program is distributed in the hope that it will be useful,
00011 // but WITHOUT ANY WARRANTY; without even the implied warranty of
00012 // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
00013 // GNU General Public License for more details.
00014 //
00015 // You should have received a copy of the GNU Lesser General Public License
00016 // along this program.  If not, see <http://www.gnu.org/licenses/>.
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 ost {
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             myTok = i.myTok;
00168             start = i.start; endp = i.endp; tokEnd = i.tokEnd;
00169             if ( token )
00170                 delete [] token;
00171             token = 0;
00172             return *this;
00173         }
00174 
00178         iterator &operator++() THROWS (NoSuchElementException);
00179 
00188         const char*  operator*() THROWS (NoSuchElementException);
00189 
00196         inline char nextDelimiter() const
00197             {return (tokEnd) ? *tokEnd : '\0';}
00198 
00203         // only compare the end-position. speed.
00204         inline bool operator == (const iterator &other) const
00205             {return (endp == other.endp);}
00206 
00211         // only compare the end position. speed.
00212         inline bool operator != (const iterator &other) const
00213             {return (endp != other.endp);}
00214     };
00215 private:
00216     friend class StringTokenizer::iterator;
00217     const char *str;
00218     const char *delim;
00219     bool skipAll, trim;
00220     iterator itEnd;
00221 
00222 public:
00261     StringTokenizer (const char *str,
00262              const char *delim,
00263              bool skipAllDelim = false,
00264              bool trim = false);
00265 
00275     StringTokenizer (const char *s);
00276 
00280     iterator begin() const
00281         {return iterator(*this);}
00282 
00287     void setDelimiters (const char *d)
00288         {delim = d;}
00289 
00294     iterator begin(const char *d) {
00295         delim = d;
00296         return iterator(*this);
00297     }
00298 
00302     const iterator& end() const
00303         {return itEnd;}
00304 };
00305 
00306 } // namespace ost
00307 
00308 #endif
00309