QCString::StringRep Class Reference

Classes
union	ShortOrLongStringSelector

Public Member Functions
	StringRep ()
void	initEmpty ()
	~StringRep ()
	StringRep (const StringRep &s)
	StringRep (int size)
	StringRep (const char *str)
	StringRep (const char *str, uint maxlen)
StringRep &	operator= (const StringRep &s)
StringRep &	operator= (const char *str)
bool	isEmpty () const
uint	length () const
const char *	data () const
char *	rawData () const
char &	at (int i) const
bool	resize (uint newlen)
bool	fill (char c, int len)

Private Attributes
union QCString::StringRep::ShortOrLongStringSelector	u

Detailed Description

Definition at line 415 of file qcstring.h.

Constructor & Destructor Documentation

QCString::StringRep::StringRep ( )

inline

Definition at line 418 of file qcstring.h.

        {
          initEmpty();
        }

QCString::StringRep::~StringRep ( )

inline

Definition at line 428 of file qcstring.h.

        {
          if (!u.s.isShort)
          {
            u.l.d->dispose();
          }
        }

QCString::StringRep::StringRep ( const StringRep &  s )

inline

Definition at line 435 of file qcstring.h.

        {
          if (&s!=this)
          {
            u.s.isShort = s.u.s.isShort;
            if (s.u.s.isShort)
            {
              u.s.len = s.u.s.len;
              memcpy(u.s.str,s.u.s.str,s.u.s.len+1);
            }
            else
            {
              u.l.d = s.u.l.d;
              u.l.d->refCount++;
            }
          }
          else // self-assignment
          {
            u = s.u; // avoid uninitialized warning from gcc
          }
        }

QCString::StringRep::StringRep ( int  size )

inline

Definition at line 456 of file qcstring.h.

        {
          u.s.isShort = size<=SHORT_STR_CAPACITY;
          if (size<=SHORT_STR_CAPACITY) // init short string
          {
            if (size>0)
            {
              u.s.len = size-1;
              u.s.str[size-1]='\0';
            }
            else
            {
              u.s.len = 0;
            }
          }
          else // int long string
          {
            u.l.d = LSData::create(size);
          }
        }

QCString::StringRep::StringRep ( const char *  str )

inline

Definition at line 476 of file qcstring.h.

        {
          if (str)
          {
            int len = (int)strlen(str);
            u.s.isShort = len<SHORT_STR_CAPACITY;
            if (len<SHORT_STR_CAPACITY)
            {
              u.s.len = len;
              qstrncpy(u.s.str,str,SHORT_STR_CAPACITY);
            }
            else
            {
              u.l.d = LSData::create(len+1);
              memcpy(u.l.d->toStr(),str,u.l.d->len);
            }
          }
          else // create empty string
          {
            initEmpty();
          }
        }

QCString::StringRep::StringRep ( const char *  str, uint  maxlen  )

inline

Definition at line 498 of file qcstring.h.

        {
          if (str && maxlen>0)
          {
            uint len=(uint)strlen(str);
            if (len>maxlen) len=maxlen;
            u.s.isShort = len<=SHORT_STR_MAX_LEN;
            if (u.s.isShort)
            {
              u.s.len = len;
              memcpy(u.s.str,str,len);
              u.s.str[len]='\0';
            }
            else
            {
              u.l.d = LSData::create(len+1);
              memcpy(u.l.d->toStr(),str,len);
            }
          }
          else // create empty string
          {
            initEmpty();
          }
        }

Member Function Documentation

char& QCString::StringRep::at ( int  i ) const

inline

Definition at line 607 of file qcstring.h.

        {
          if (u.s.isShort)
          {
            return (char&)u.s.str[i];
          }
          else
          {
            return u.l.d->toStr()[i];
          }
        }

const char* QCString::StringRep::data ( ) const

inline

Definition at line 584 of file qcstring.h.

        {
          if (u.s.isShort)
          {
            return u.s.len==0 ? 0 : u.s.str;
          }
          else
          {
            return u.l.d->len==0 ? 0 : u.l.d->toStr();
          }
        }

bool QCString::StringRep::fill ( char  c, int  len  )

inline

Definition at line 668 of file qcstring.h.

        {
          if (len<0) len=length();
          if (!u.s.isShort) // detach from shared string
          {
            resize(len+1);
          }
          else if (len!=(int)length())
          {
            if (len>0)
            {
              resize(len+1);
            }
          }
          if (len>0)
          {
            memset(rawData(),c,len);
          }
          return TRUE;
        }

void QCString::StringRep::initEmpty ( )

inline

Definition at line 422 of file qcstring.h.

        {
          u.s.isShort=TRUE;
          u.s.len=0;
          //memset(u.s.str,0,SHORT_STR_CAPACITY);
        }

bool QCString::StringRep::isEmpty ( ) const

inline

Definition at line 575 of file qcstring.h.

        {
          return u.s.isShort && u.s.len==0;
        }

uint QCString::StringRep::length ( ) const

inline

Definition at line 579 of file qcstring.h.

        {
          uint l = u.s.isShort ? u.s.len : u.l.d->len;
          return l;
        }

StringRep& QCString::StringRep::operator= ( const StringRep &  s )

inline

Definition at line 522 of file qcstring.h.

        {
          if (&s!=this)
          {
            if (!u.s.isShort)
            {
              u.l.d->dispose();
            }
            u.s.isShort = s.u.s.isShort;
            if (u.s.isShort) // copy by value
            {
              u.s.len = s.u.s.len;
              memcpy(u.s.str,s.u.s.str,s.u.s.len+1);
            }
            else // copy by reference
            {
              u.l.d = s.u.l.d;
              u.l.d->refCount++;
            }
          }
          else // self-assignment
          {
            u = s.u; // avoid uninitialized warning from gcc
          }
          return *this;
        }

StringRep& QCString::StringRep::operator= ( const char *  str )

inline

Definition at line 548 of file qcstring.h.

        {
          if (!u.s.isShort)
          {
            u.l.d->dispose();
          }
          if (str)
          {
            int len = (int)strlen(str);
            u.s.isShort = len<SHORT_STR_CAPACITY;
            if (len<SHORT_STR_CAPACITY)
            {
              u.s.len = len;
              qstrncpy(u.s.str,str,SHORT_STR_CAPACITY);
            }
            else
            {
              u.l.d = LSData::create(len+1);
              memcpy(u.l.d->toStr(),str,len);
            }
          }
          else
          {
            initEmpty();
          }
          return *this;
        }

char* QCString::StringRep::rawData ( ) const

inline

Definition at line 595 of file qcstring.h.

        {
          if (u.s.isShort)
          {
            return u.s.len==0 ? 0 : (char*)u.s.str;
          }
          else
          {
            //assert(u.l.d->refCount==0); // string may not be shared when accessed raw
            return u.l.d->len==0 ? 0 : u.l.d->toStr();
          }
        }

bool QCString::StringRep::resize ( uint  newlen )

inline

Definition at line 618 of file qcstring.h.

        {
          if (u.s.isShort && newlen<=SHORT_STR_CAPACITY) // resize short string
          {
            if (newlen>0)
            {
              u.s.len = newlen-1;
              u.s.str[newlen-1]='\0';
            }
            else // string becomes empty
            {
              initEmpty();
            }
          }
          else if (u.s.isShort) // turn short string into long string
          {
            StringRep tmp = *this;
            u.s.isShort=FALSE;
            u.l.d = LSData::create(newlen);
            if (tmp.u.s.len>0)
            {
              memcpy(u.l.d->toStr(),tmp.u.s.str,tmp.u.s.len+1);
            }
            else
            {
              u.l.d->toStr()[0]='\0';
            }
          }
          else if (!u.s.isShort && newlen<=SHORT_STR_CAPACITY) // turn long string into short string
          {
            if (newlen>0)
            {
              StringRep tmp(newlen); // copy short part into tmp buffer
              memcpy(tmp.u.s.str,u.l.d->toStr(),newlen-1);
              tmp.u.s.str[newlen-1]='\0';
              u.l.d->dispose();
              u.s = tmp.u.s;
            }
            else
            {
              u.l.d->dispose();
              initEmpty();
            }
          }
          else // resize long string
          {
            u.l.d = u.l.d->resize(u.l.d,newlen);
          }
          return TRUE;
        }

Member Data Documentation

union QCString::StringRep::ShortOrLongStringSelector QCString::StringRep::u

private

---

The documentation for this class was generated from the following file:

• doxygen-1.8.11/qtools/qcstring.h