---

CTBstring.hxx

Go to the documentation of this file.

#ifndef _CTBstring_HXX
#define _CTBstring_HXX 1

/*----------------------------------------------------------------------------*/
/* C Tool Box: Designed and implemented by:                                   */
/*    Walter F.J. Mueller   Gesellschaft fuer Schwerionenforschung (GSI)      */
/*                          Planckstrasse 1, D-64291 Darmstadt, Germany       */
/*                  Email:  W.F.J.Mueller@gsi.de                              */
/*                  WWW:    http://www-kp3.gsi.de/www/kp3/people/mueller.html */
/*----------------------------------------------------------------------------*/

#include "CTBgrab.hxx"
#include "CTBsharedBuffer.hxx"

class CTBstring {
  public:
                    CTBstring();
                    CTBstring(const CTBstring& rhs);
                    CTBstring(CTBstring& rhs, bool b_grab);
                    CTBstring(const CTBstring& rhs, CTBint i_length);
                    CTBstring(const CTBstring& rhs, CTBint i_offset, 
                              CTBint i_length);
                    CTBstring(const char* c_rhs);
                    CTBstring(const char* c_rhs, CTBint i_length);

                    ~CTBstring();

    const char*     Data() const;
    CTBint          Length() const;

    bool            IsNull() const;
    bool            IsEmpty() const;

    void            Copy(const CTBstring& rhs);
    void            Copy(const char* c_rhs);
    void            Copy(char c_rhs);

    void            Append(const CTBstring& rhs);
    void            Append(const char* c_rhs);
    void            Append(const char* c_rhs, CTBint i_length);
    void            Append(char c_rhs);

    void            Clear();

    int             Compare(const CTBstring& rhs) const;
    int             Compare(const char* c_rhs) const;

    int             CompareCaseBlind(const CTBstring& rhs) const;
    int             CompareCaseBlind(const char* c_rhs) const;

    bool            IsWhite() const;
    bool            IsUpperCase() const;
    bool            IsLowerCase() const;

    void            TrimWhite();
    void            CollapseWhite();
    void            ToUpperCase();
    void            ToLowerCase();

    bool            Get(long& i_val, int i_base = 0) const; 
    bool            Get(unsigned long& i_val, int i_base = 0) const; 
    bool            Get(int& i_val, int i_base = 0) const; 
    bool            Get(unsigned int& i_val, int i_base = 0) const; 
    bool            Get(double& d_val) const;
    bool            Get(float& f_val) const;

    CTBint          FindCharacter(char c, CTBint i_offset=0) const;
    CTBint          FindCharacter(const char* c_set, CTBint i_offset=0) const;
    CTBint          FindCharacter(const CTBstring& set,
                                  CTBint i_offset=0) const;

    CTBstring       Escape() const;
    CTBstring       Unescape() const;

    bool            GetLine(istream& is);

    void            Grab(CTBstring& rhs);

    void            Dump(int i_indent=0, ostream& os=cout,
                         const char* p_text=0) const;

    CTBstring&      operator=(const CTBstring& rhs);    
    CTBstring&      operator=(const char* c_rhs);
    CTBstring&      operator=(char c_rhs);    

    CTBstring&      operator+=(const CTBstring& rhs);    
    CTBstring&      operator+=(const char* c_rhs);    
    CTBstring&      operator+=(char c_rhs);    

    CTBstring&      operator<<(const CTBstring& rhs);
    CTBstring&      operator<<(const char* c_rhs);    
    CTBstring&      operator<<(char c_rhs);    


    char            operator[](CTBint i_ind) const;

    CTBstring       operator()(CTBint i_length) const;
    CTBstring       operator()(CTBint i_offset, CTBint i_length) const;

                    operator const char*() const;

    friend CTBstring operator+(const CTBstring& lhs,
                               const CTBstring& rhs);
    friend CTBstring operator+(const CTBstring& lhs,
                               const char* c_rhs);
    friend CTBstring operator+(const char* c_lhs,
                               const CTBstring& rhs);

    friend bool     operator==(const CTBstring& lhs,
                               const CTBstring& rhs);
    friend bool     operator<(const CTBstring& lhs,
                              const CTBstring& rhs);

    friend bool     operator==(const CTBstring& lhs,
                               const char* c_rhs);
    friend bool     operator<(const CTBstring& lhs,
                              const char* c_rhs);

    friend bool     operator==(const char* c_lhs,
                               const CTBstring& rhs);
    friend bool     operator<(const char* c_lhs,
                              const CTBstring& rhs);

    friend ostream& operator<<(ostream& os, const CTBstring& rhs);

  public:
    static const CTBstring&  NullString();
    static const CTBstring&  EmptyString();

  private:
    void            Unshare();
    void            EnsureUnsharedCapacity(CTBint i_capacity);
    void            NewString(const char* c_str, CTBint i_len);
    void            NewString(const char* c_str1, CTBint i_len1,
                              const char* c_str2, CTBint i_len2);
    void            AppendData(const char* c_str, CTBint i_len);
    void            Terminate();

    CTBint          FindCharacter(const char* c_set, CTBint i_len,
                                  CTBint i_offset) const;

  private: 
    CTBsharedBuffer<char> m_sbuf;           
    CTBint          mi_offset;              
    CTBint          mi_length;              
};

class CTBgrab<CTBstring> : public CTBgrabable<CTBstring> {};

// #include "CTBstring_insert.h"

#include "CTBstring.icc"

#endif

---