src/include/common/base/util/WString.h

00001 /*
00002  * Funambol is a mobile platform developed by Funambol, Inc. 
00003  * Copyright (C) 2003 - 2007 Funambol, Inc.
00004  * 
00005  * This program is free software; you can redistribute it and/or modify it under
00006  * the terms of the GNU Affero General Public License version 3 as published by
00007  * the Free Software Foundation with the addition of the following permission 
00008  * added to Section 15 as permitted in Section 7(a): FOR ANY PART OF THE COVERED
00009  * WORK IN WHICH THE COPYRIGHT IS OWNED BY FUNAMBOL, FUNAMBOL DISCLAIMS THE 
00010  * WARRANTY OF NON INFRINGEMENT  OF THIRD PARTY RIGHTS.
00011  * 
00012  * This program is distributed in the hope that it will be useful, but WITHOUT
00013  * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
00014  * FOR A PARTICULAR PURPOSE.  See the GNU General Public License for more
00015  * details.
00016  * 
00017  * You should have received a copy of the GNU Affero General Public License 
00018  * along with this program; if not, see http://www.gnu.org/licenses or write to
00019  * the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston,
00020  * MA 02110-1301 USA.
00021  * 
00022  * You can contact Funambol, Inc. headquarters at 643 Bair Island Road, Suite 
00023  * 305, Redwood City, CA 94063, USA, or at email address info@funambol.com.
00024  * 
00025  * The interactive user interfaces in modified source and object code versions
00026  * of this program must display Appropriate Legal Notices, as required under
00027  * Section 5 of the GNU Affero General Public License version 3.
00028  * 
00029  * In accordance with Section 7(b) of the GNU Affero General Public License
00030  * version 3, these Appropriate Legal Notices must retain the display of the
00031  * "Powered by Funambol" logo. If the display of the logo is not reasonably 
00032  * feasible for technical reasons, the Appropriate Legal Notices must display
00033  * the words "Powered by Funambol".
00034  */
00035 
00036 #ifndef INCL_WSTRING
00037 #define INCL_WSTRING
00038 
00040 #include "base/util/ArrayElement.h"
00041 
00042 class ArrayList;
00043 class StringBuffer;
00044 
00045 #define DEFAULT_DELIMITER (const WCHAR* )TEXT(" ")
00046 
00050 class WString: public ArrayElement {
00051     public:
00052         // Constant value for an invalid pos (returned by find and rfind)
00053         static const size_t npos;
00054 
00055         WString(const WCHAR* str = NULL, size_t len = npos);
00056 
00057         WString(const WString &sb);
00058 
00059         ~WString();
00060 
00061         WString& append(const WCHAR*);
00062 
00063         WString& append(unsigned long u, BOOL sign = TRUE);
00064 
00065         WString& append(WString& s);
00066 
00067         WString& append(WString* str);
00068 
00069         WString& set(const WCHAR*);
00070 
00074         WString& reset();
00075 
00079         const WCHAR* getChars() const;
00080         inline const WCHAR* c_str() const { return s; };
00081 
00087         size_t find(const WCHAR *str, size_t pos = 0) const;
00088 
00094         size_t ifind(const WCHAR *str, size_t pos = 0) const;
00095 
00102         size_t replace(const WCHAR *from, const WCHAR *to, size_t pos = 0);
00108         int replaceAll(const WCHAR *from, const WCHAR *to, size_t pos = 0);
00109 
00116         ArrayList &split (ArrayList &tokens,
00117                           const WCHAR *delimiters = DEFAULT_DELIMITER ) const;
00118 
00125         WString& join(ArrayList &tokens, const WCHAR *separator);
00126 
00133         WString substr(size_t pos, size_t len = npos) const;
00134 
00139         unsigned long length() const;
00140 
00144         void reserve(size_t len);
00145 
00149         WString& upperCase() ;
00150 
00154         WString& lowerCase() ;
00155 
00159         bool icmp(const WCHAR *sc) const ;
00160 
00164         bool empty() const;
00165 
00169         bool null() const;
00170 
00174         ArrayElement* clone() ;
00175 
00179         WString& operator= (const WCHAR* sc) ;
00180         WString& operator= (const WString& s) ;
00181         WString& operator= (const StringBuffer& s) ;
00182         WString& operator+= (const WCHAR* sc) ;
00183         WString& operator+= (const WString& s) ;
00184         WString& operator+= (const StringBuffer& s) ;
00185         bool operator== (const WCHAR* sc) const ;
00186         bool operator== (const WString& sb) const ;
00187         bool operator== (const StringBuffer& sb) const ;
00188         bool operator!= (const WCHAR* sc) const ;
00189         bool operator!= (const WString& s) const ;
00190         bool operator!= (const StringBuffer& sb) const ;
00191 
00192         inline operator const WCHAR*() const { return s; } ;
00193 
00194     private:
00195         WCHAR* s;
00196         size_t size;
00197 
00198         // Allocator
00199         void getmem(size_t len);
00200         // Deallocator
00201         void freemem();
00202 };
00203 
00204 WString operator+(const WString& x, const WCHAR *y);
00205 
00207 #endif
00208 

Generated on Mon Feb 4 09:50:46 2008 for Funambol Outlook Plug-in Library by  doxygen 1.5.2