PStringStream Class Reference

#include <pstring.h>

Inheritance diagram for PStringStream:

PString PCharArray PBaseArray< T > PAbstractArray PContainer PObject PHTML PServiceHTML List of all members.

Public Member Functions

 PStringStream ()
 PStringStream (PINDEX fixedBufferSize)
 PStringStream (const PString &str)
 PStringStream (const char *cstr)
virtual PStringMakeEmpty ()
PStringStreamoperator= (const PStringStream &strm)
PStringStreamoperator= (const PString &str)
PStringStreamoperator= (const char *cstr)
PStringStreamoperator= (char ch)
virtual ~PStringStream ()
 Destroy the string stream, deleting the stream buffer.

Protected Member Functions

virtual void AssignContents (const PContainer &cont)

Detailed Description

This class is a standard C++ stream class descendent for reading or writing streamed data to or from a PString# class.

All of the standard stream I/O operators, manipulators etc will operate on the PStringStream class.


Constructor & Destructor Documentation

PStringStream::PStringStream (  ) 

Create a new, empty, string stream. Data may be output to this stream, but attempts to input from it will return end of file.

The internal string is continually grown as required during output.

PStringStream::PStringStream ( PINDEX  fixedBufferSize  ) 

Create a new, empty, string stream of a fixed size. Data may be output to this stream, but attempts to input from it will return end of file. When the fixed size is reached then no more data may be output to it.

PStringStream::PStringStream ( const PString str  ) 

Create a new string stream and initialise it to the provided value. The string stream references the same string buffer as the str# parameter until any output to the string stream is attempted. The reference is then broken and the instance of the string stream becomes a unique reference to a string buffer.

Parameters:
str  Initial value for string stream.

PStringStream::PStringStream ( const char *  cstr  ) 

Create a new string stream and initialise it with the provided value. The stream may be read or written from. Writes will append to the end of the string.

Parameters:
cstr  Initial value for the string stream.

virtual PStringStream::~PStringStream (  )  [virtual]

Destroy the string stream, deleting the stream buffer.


Member Function Documentation

virtual void PStringStream::AssignContents ( const PContainer cont  )  [protected, virtual]

Copy the container contents. This copies the contents from one reference to another.

No duplication of contents occurs, for instance if the container is an array, the pointer to the array memory is copied, not the array memory block itself.

This function will get called by the base assignment operator.

Reimplemented from PContainer.

Reimplemented in PHTML.

virtual PString& PStringStream::MakeEmpty (  )  [virtual]

Make the current string empty

Reimplemented from PString.

PINLINE PStringStream & PStringStream::operator= ( char  ch  ) 

Assign the character to the current object. The current instance then becomes a unique reference to a copy of the character parameter. eg: {verbatim} myStr = 'A'; {verbatim}

Returns:
reference to the current PString object.
Parameters:
ch  Character to assign.

Reimplemented from PString.

Reimplemented in PHTML.

PINLINE PStringStream & PStringStream::operator= ( const char *  cstr  ) 

Assign the C string to the string stream. The current instance then becomes a unique reference to a copy of the cstr# parameter. The cstr# parameter is typically a literal string, eg: {verbatim} myStr = "fred"; {verbatim}

This will reset the read pointer for input to the beginning of the string. Also, any data output to the string up until the asasignement will be lost.

Returns:
reference to the current PStringStream object.
Parameters:
cstr  C string to assign.

Reimplemented from PString.

Reimplemented in PHTML.

PINLINE PStringStream & PStringStream::operator= ( const PString str  ) 

Assign the string to the current object. The current instance then becomes another reference to the same string in the str# parameter.

This will reset the read pointer for input to the beginning of the string. Also, any data output to the string up until the asasignement will be lost.

Returns:
reference to the current PStringStream object.
Parameters:
str  New string to assign.

Reimplemented from PString.

Reimplemented in PHTML.

PINLINE PStringStream & PStringStream::operator= ( const PStringStream strm  ) 

Assign the string part of the stream to the current object. The current instance then becomes another reference to the same string in the strm# parameter.

This will reset the read pointer for input to the beginning of the string. Also, any data output to the string up until the asasignement will be lost.

Returns:
reference to the current PStringStream object.


The documentation for this class was generated from the following files:
Generated on Thu May 27 01:36:49 2010 for PTLib by  doxygen 1.4.7