QStringBuffer Class Reference

Inheritance diagram for QStringBuffer:

Public Member Functions
	QStringBuffer (QString *str)
	~QStringBuffer ()
bool	open (int m)
void	close ()
void	flush ()
uint	size () const
int	at () const
bool	at (int pos)
int	readBlock (char *p, uint len)
int	writeBlock (const char *p, uint len)
int	getch ()
int	putch (int ch)
int	ungetch (int ch)
Public Member Functions inherited from QIODevice
	QIODevice ()
virtual	~QIODevice ()
int	flags () const
int	mode () const
int	state () const
bool	isDirectAccess () const
bool	isSequentialAccess () const
bool	isCombinedAccess () const
bool	isBuffered () const
bool	isRaw () const
bool	isSynchronous () const
bool	isAsynchronous () const
bool	isTranslated () const
bool	isReadable () const
bool	isWritable () const
bool	isReadWrite () const
bool	isInactive () const
bool	isOpen () const
int	status () const
void	resetStatus ()
virtual bool	atEnd () const
bool	reset ()
virtual int	readLine (char *data, uint maxlen)
int	writeBlock (const QByteArray &data)
QByteArray	readAll ()

Protected Attributes
QString *	s
Protected Attributes inherited from QIODevice
int	ioIndex

Private Member Functions
	QStringBuffer (const QStringBuffer &)
QStringBuffer &	operator= (const QStringBuffer &)

Additional Inherited Members
Protected Member Functions inherited from QIODevice
void	setFlags (int f)
void	setType (int)
void	setMode (int)
void	setState (int)
void	setStatus (int)

Detailed Description

Definition at line 258 of file qtextstream.cpp.

Constructor & Destructor Documentation

QStringBuffer::QStringBuffer

(

QString *

str

)

Definition at line 282 of file qtextstream.cpp.

{
    s = str;
}

QStringBuffer::~QStringBuffer

(

)

Definition at line 287 of file qtextstream.cpp.

{
}

QStringBuffer::QStringBuffer ( const QStringBuffer &  )

private

Member Function Documentation

int QStringBuffer::at ( ) const

virtual

Virtual function that returns the current I/O device index.

This index is the data read/write head of the I/O device.

See also

size()

Reimplemented from QIODevice.

Definition at line 337 of file qtextstream.cpp.

{
    return ioIndex;
}

bool QStringBuffer::at ( int  pos )

virtual

Virtual function that sets the I/O device index to pos.

See also

size()

Reimplemented from QIODevice.

Definition at line 342 of file qtextstream.cpp.

{
#if defined(CHECK_STATE)
    if ( !isOpen() ) {
        qWarning( "QStringBuffer::at: Buffer is not open" );
        return FALSE;
    }
#endif
    if ( (uint)pos >= s->length()*2 ) {
#if defined(CHECK_RANGE)
        qWarning( "QStringBuffer::at: Index %d out of range", pos );
#endif
        return FALSE;
    }
    ioIndex = pos;
    return TRUE;
}

void QStringBuffer::close ( )

virtual

Closes the I/O device.

This virtual function must be reimplemented by all subclasses.

See also

open()

Implements QIODevice.

Definition at line 320 of file qtextstream.cpp.

{
    if ( isOpen() ) {
        setFlags( IO_Direct );
        ioIndex = 0;
    }
}

void QStringBuffer::flush ( )

virtual

Flushes an open I/O device.

This virtual function must be reimplemented by all subclasses.

Implements QIODevice.

Definition at line 328 of file qtextstream.cpp.

{
}

int QStringBuffer::getch ( )

virtual

Reads a single byte/character from the I/O device.

Returns the byte/character read, or -1 if the end of the I/O device has been reached.

This virtual function must be reimplemented by all subclasses.

See also

putch(), ungetch()

Implements QIODevice.

Definition at line 417 of file qtextstream.cpp.

{
#if defined(CHECK_STATE)
    if ( !isOpen() ) {                          // buffer not open
        qWarning( "QStringBuffer::getch: Buffer not open" );
        return -1;
    }
    if ( !isReadable() ) {                      // reading not permitted
        qWarning( "QStringBuffer::getch: Read operation not permitted" );
        return -1;
    }
#endif
    if ( (uint)ioIndex >= s->length()*2 ) {           // overflow
        setStatus( IO_ReadError );
        return -1;
    }
    return *((char*)s->unicode() + ioIndex++);
}

bool QStringBuffer::open ( int  mode )

virtual

Opens the I/O device using the specified mode. Returns TRUE if successful, or FALSE if the device could not be opened.

The mode parameter m must be a combination of the following flags.

• IO_Raw specified raw (unbuffered) file access.
• IO_ReadOnly opens a file in read-only mode.
• IO_WriteOnly opens a file in write-only mode.
• IO_ReadWrite opens a file in read/write mode.
• IO_Append sets the file index to the end of the file.
• IO_Truncate truncates the file.
• IO_Translate enables carriage returns and linefeed translation for text files under MS-DOS, Window, OS/2 and Macintosh. On Unix systems this flag has no effect. Use with caution as it will also transform every linefeed written to the file into a CRLF pair. This is likely to corrupt your file when writing binary data to it. Cannot be combined with IO_Raw.

This virtual function must be reimplemented by all subclasses.

See also

close()

Implements QIODevice.

Definition at line 292 of file qtextstream.cpp.

{
    if ( !s ) {
#if defined(CHECK_STATE)
        qWarning( "QStringBuffer::open: No string" );
#endif
        return FALSE;
    }
    if ( isOpen() ) {                           // buffer already open
#if defined(CHECK_STATE)
        qWarning( "QStringBuffer::open: Buffer already open" );
#endif
        return FALSE;
    }
    setMode( m );
    if ( m & IO_Truncate ) {                    // truncate buffer
        s->truncate( 0 );
    }
    if ( m & IO_Append ) {                      // append to end of buffer
        ioIndex = s->length()*(int)sizeof(QChar);
    } else {
        ioIndex = 0;
    }
    setState( IO_Open );
    setStatus( 0 );
    return TRUE;
}

QStringBuffer& QStringBuffer::operator= ( const QStringBuffer &  )

private

int QStringBuffer::putch ( int  ch )

virtual

Writes the character ch to the I/O device.

Returns ch, or -1 if some error occurred.

This virtual function must be reimplemented by all subclasses.

See also

getch(), ungetch()

Implements QIODevice.

Definition at line 436 of file qtextstream.cpp.

{
    char c = ch;
    if ( writeBlock(&c,1) < 0 )
        return -1;
    else
        return ch;
}

int QStringBuffer::readBlock ( char *  data, uint  maxlen  )

virtual

Reads at most maxlen bytes from the I/O device into data and returns the number of bytes actually read.

This virtual function must be reimplemented by all subclasses.

See also

writeBlock()

Implements QIODevice.

Definition at line 361 of file qtextstream.cpp.

{
#if defined(CHECK_STATE)
    CHECK_PTR( p );
    if ( !isOpen() ) {                          // buffer not open
        qWarning( "QStringBuffer::readBlock: Buffer not open" );
        return -1;
    }
    if ( !isReadable() ) {                      // reading not permitted
        qWarning( "QStringBuffer::readBlock: Read operation not permitted" );
        return -1;
    }
#endif
    if ( (uint)ioIndex + len > s->length()*sizeof(QChar) ) {
        // overflow
        if ( (uint)ioIndex >= s->length()*sizeof(QChar) ) {
            setStatus( IO_ReadError );
            return -1;
        } else {
            len = s->length()*2 - (uint)ioIndex;
        }
    }
    memcpy( p, ((const char*)(s->unicode()))+ioIndex, len );
    ioIndex += len;
    return len;
}

uint QStringBuffer::size ( ) const

virtual

Virtual function that returns the size of the I/O device.

See also

at()

Implements QIODevice.

Definition at line 332 of file qtextstream.cpp.

{
    return s ? s->length()*(int)sizeof(QChar) : 0;
}

int QStringBuffer::ungetch ( int  ch )

virtual

Puts the character ch back into the I/O device and decrements the index if it is not zero.

This function is normally called to "undo" a getch() operation.

Returns ch, or -1 if some error occurred.

This virtual function must be reimplemented by all subclasses.

See also

getch(), putch()

Implements QIODevice.

Definition at line 445 of file qtextstream.cpp.

{
#if defined(CHECK_STATE)
    if ( !isOpen() ) {                          // buffer not open
        qWarning( "QStringBuffer::ungetch: Buffer not open" );
        return -1;
    }
    if ( !isReadable() ) {                      // reading not permitted
        qWarning( "QStringBuffer::ungetch: Read operation not permitted" );
        return -1;
    }
#endif
    if ( ch != -1 ) { // something to do with eof
        if ( ioIndex )
            ioIndex--;
        else
            ch = -1;
    }
    return ch;
}

int QStringBuffer::writeBlock ( const char *  data, uint  len  )

virtual

Writes len bytes from p to the I/O device and returns the number of bytes actually written.

This virtual function must be reimplemented by all subclasses.

See also

readBlock()

Implements QIODevice.

Definition at line 388 of file qtextstream.cpp.

{
#if defined(CHECK_NULL)
    if ( p == 0 && len != 0 )
        qWarning( "QStringBuffer::writeBlock: Null pointer error" );
#endif
#if defined(CHECK_STATE)
    if ( !isOpen() ) {                          // buffer not open
        qWarning( "QStringBuffer::writeBlock: Buffer not open" );
        return -1;
    }
    if ( !isWritable() ) {                      // writing not permitted
        qWarning( "QStringBuffer::writeBlock: Write operation not permitted" );
        return -1;
    }
    if ( ioIndex&1 ) {
        qWarning( "QStringBuffer::writeBlock: non-even index - non Unicode" );
        return -1;
    }
    if ( len&1 ) {
        qWarning( "QStringBuffer::writeBlock: non-even length - non Unicode" );
        return -1;
    }
#endif
    s->replace(ioIndex/2, len/2, (QChar*)p, len/2);
    ioIndex += len;
    return len;
}

Member Data Documentation

QString* QStringBuffer::s

protected

Definition at line 274 of file qtextstream.cpp.

---

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

• doxygen-1.8.11/qtools/qtextstream.cpp