Main Page | Class Hierarchy | Class List | File List | Class Members | File Members

PStringList Class Reference

#include <pstring.h>

List of all members.

Public Member Functions

Construction
 PStringList (PINDEX count, char const *const *strarr, BOOL caseless=FALSE)
 PStringList (const PString &str)
 PStringList (const PStringArray &array)
 PStringList (const PSortedStringList &list)
Overrides from class PObject
virtual void ReadFrom (istream &strm)
Operations
PINDEX AppendString (const PString &str)
PINDEX InsertString (const PString &before, const PString &str)
PINDEX GetStringsIndex (const PString &str) const
PStringListoperator+= (const PStringList &list)
PStringListoperator+= (const PString &str)
PStringList operator+ (const PStringList &array)
PStringList operator+ (const PString &str)


Detailed Description

This is a list collection class of PString# objects. It has all the usual functions for a collection, with the object types set to PString# pointers.

In addition some addition functions are added that take a const PString# reference instead of a pointer as most standard collection functions do. This is more convenient for when string expressions are used as parameters to function in the collection.

See the PAbstractList# and #PList# classes and PDECLARE_LIST# macro for more information.


Constructor & Destructor Documentation

PStringList::PStringList PINDEX  count,
char const *const *  strarr,
BOOL  caseless = FALSE
 

Create a PStringList from the array of C strings.

Parameters:
strarr  Count of strings in array
caseless  Array of C strings New strings are to be PCaselessStrings

PStringList::PStringList const PString str  ) 
 

Create a PStringList of length one from the single string.

Parameters:
str  Single string to convert to a list of one.

PStringList::PStringList const PStringArray array  ) 
 

Create a PStringList from the array of strings.

Parameters:
array  Array of strings to convert to list

PStringList::PStringList const PSortedStringList list  ) 
 

Create a PStringList from the sorted list of strings.

Parameters:
list  List of strings to convert to list.


Member Function Documentation

PINLINE PINDEX PStringList::AppendString const PString str  ) 
 

Append a string to the list.

Parameters:
str  String to append.

PINLINE PINDEX PStringList::GetStringsIndex const PString str  )  const
 

Get the index of the string with the specified value. A linear search of list is performed to find the string value.

Parameters:
str  String value to search for.

PINLINE PINDEX PStringList::InsertString const PString before,
const PString str
 

Insert a string into the list.

Parameters:
str  String to insert before. String to insert.

PINLINE PStringList PStringList::operator+ const PString str  ) 
 

PINLINE PStringList PStringList::operator+ const PStringList array  ) 
 

Create a new PStringList, and add PString or PStringList to it a new PStringList

Returns:
A new PStringList with the additional elements(s)

PINLINE PStringList & PStringList::operator+= const PString str  ) 
 

PStringList& PStringList::operator+= const PStringList list  ) 
 

Concatenate a PString or PStringArray to the list

Returns:
The PStringArray with the new items appended

virtual void PStringList::ReadFrom istream &  strm  )  [virtual]
 

Input the contents of the object from the stream. This is primarily used by the standard #operator>># function.

The default behaviour reads '
' separated strings until !strm.good().


The documentation for this class was generated from the following files:
Generated on Sat Jul 24 15:36:00 2004 for PWLib by doxygen 1.3.7