CrystalSpace

Public API Reference

Main Page   Modules   Class Hierarchy   Alphabetical List   Compound List   File List   Compound Members   File Members   Related Pages  

iutil/string.h

Go to the documentation of this file.
00001 /*
00002     Crystal Space String interface
00003     Copyright (C) 1999 by Brandon Ehle (Azverkan)
00004 
00005     This library is free software; you can redistribute it and/or
00006     modify it under the terms of the GNU Library General Public
00007     License as published by the Free Software Foundation; either
00008     version 2 of the License, or (at your option) any later version.
00009 
00010     This library 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 GNU
00013     Library General Public License for more details.
00014 
00015     You should have received a copy of the GNU Library General Public
00016     License along with this library; if not, write to the Free
00017     Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
00018 */
00019 
00020 #ifndef __CS_IUTIL_STRING_H__
00021 #define __CS_IUTIL_STRING_H__
00022 
00028 #include <stdarg.h>
00029 #include "csutil/scf.h"
00030 #include "csutil/ref.h"
00031 
00032 SCF_VERSION (iString, 0, 2, 0);
00033 
00035 struct iString : public iBase
00036 {
00044   virtual void SetCapacity (size_t NewSize) = 0;
00046   virtual size_t GetCapacity () const = 0;
00047 
00054   virtual void SetGrowsBy(size_t) = 0;
00056   virtual size_t GetGrowsBy() const = 0;
00057 
00062   virtual void SetGrowsExponentially(bool) = 0;
00063 
00065   virtual bool GetGrowsExponentially() const = 0;
00066 
00068   virtual void Truncate (size_t iPos) = 0;
00069 
00071   virtual void Reclaim () = 0;
00072 
00074   virtual void Clear () = 0;
00075 
00077   virtual csRef<iString> Clone () const = 0;
00078 
00080   virtual char const* GetData () const = 0;
00081 
00083   virtual char* GetData () = 0;
00084 
00086   virtual size_t Length () const = 0;
00087 
00089   virtual bool IsEmpty () const = 0;
00090 
00092   virtual char& operator [] (size_t iPos) = 0;
00093 
00095   virtual char operator [] (size_t iPos) const = 0;
00096 
00098   virtual void SetAt (size_t iPos, char iChar) = 0;
00099 
00101   virtual char GetAt (size_t iPos) const = 0;
00102 
00104   virtual void Insert (size_t iPos, iString const* iStr) = 0;
00105 
00107   virtual void Overwrite (size_t iPos, iString const* iStr) = 0;
00108 
00110   virtual void Append (const char* iStr, size_t Count = (size_t)-1) = 0;
00111 
00113   virtual void Append (const iString* iStr, size_t Count = (size_t)-1) = 0;
00114 
00119   virtual csRef<iString> Slice (size_t start, size_t len) const = 0;
00120 
00125   virtual void SubString (iString* sub, size_t start, size_t len) const = 0;
00126 
00131   virtual size_t FindFirst (const char c, size_t p = (size_t)-1) const = 0;
00132 
00138   virtual size_t FindLast (const char c, size_t p = (size_t)-1) const = 0;
00139   
00145   virtual void Format (const char* format, ...) CS_GNUC_PRINTF (2, 3) = 0;
00146 
00152   virtual void FormatV (const char* format, va_list args) = 0;
00153 
00155   virtual void Replace (const iString* iStr, size_t iCount = (size_t)-1) = 0;
00156 
00158   virtual bool Compare (const iString* iStr) const = 0;
00159 
00161   virtual bool CompareNoCase (const iString* iStr) const = 0;
00162 
00164   virtual void operator += (const iString& iStr) = 0;
00165 
00167   virtual void operator += (const char* iStr) = 0;
00168 
00170   virtual csRef<iString> operator + (const iString& iStr) const = 0;
00171 
00173   virtual operator char const* () const = 0;
00174 
00176   virtual bool operator == (const iString &iStr) const = 0;
00177 
00179   virtual void Downcase() = 0;
00180 
00182   virtual void Upcase() = 0;
00183 };
00184 
00187 #endif // __CS_IUTIL_STRING_H__

Generated for Crystal Space by doxygen 1.2.18