CrystalSpace

Public API Reference

Main Page | Modules | Namespace List | Class Hierarchy | Alphabetical List | Class List | Directories | File List | Namespace Members | Class Members | File Members | Related Pages

scfStringArray Class Reference

This class is a thin wrapper around csStringArray with SCF capability. More...

#include <csutil/scfstringarray.h>

Inheritance diagram for scfStringArray:

iStringArray iBase List of all members.

Public Member Functions

virtual size_t Contains (const char *str, bool case_sensitive=true) const
 Alias for Find() and FindCaseInsensitive().
virtual void DeleteAll ()
 Remove all strings from array.
virtual bool DeleteIndex (size_t n)
 Delete string n from the array.
virtual void Empty ()
 Remove all strings from array, releasing allocated memory.
virtual size_t Find (const char *value) const
 Find a string, case-sensitive.
virtual size_t FindCaseInsensitive (const char *value) const
 Find a string, case-insensitive.
virtual size_t FindSortedKey (const char *value) const
 Find an element based on some key, using a comparison function.
virtual char const * Get (size_t n) const
 Get a particular string from the array.
virtual size_t GetSize () const
 Get array length.
virtual bool Insert (size_t n, char const *value)
 Insert a string before entry n in the array.
virtual bool IsEmpty () const
 Return true if the array is empty.
virtual size_t Length () const
 Get array length.
virtual char * Pop ()
 Pop an element from tail end of array.
virtual void Push (char const *value)
 Push a string onto the stack.
 scfStringArray (int limit=16, int delta=16)
 Create a iStringArray from scratch.
virtual void Sort (bool case_sensitive=true)
 Sort array.
virtual ~scfStringArray ()
 Destructor - nothing to do.

Public Attributes

 SCF_DECLARE_IBASE

Detailed Description

This class is a thin wrapper around csStringArray with SCF capability.

Definition at line 28 of file scfstringarray.h.


Constructor & Destructor Documentation

scfStringArray::scfStringArray int  limit = 16,
int  delta = 16
[inline]
 

Create a iStringArray from scratch.

Definition at line 36 of file scfstringarray.h.

References SCF_CONSTRUCT_IBASE.

virtual scfStringArray::~scfStringArray  )  [inline, virtual]
 

Destructor - nothing to do.

Definition at line 40 of file scfstringarray.h.

References SCF_DESTRUCT_IBASE.


Member Function Documentation

virtual size_t scfStringArray::Contains const char *  str,
bool  case_sensitive = true
const [inline, virtual]
 

Alias for Find() and FindCaseInsensitive().

Parameters:
str String to look for in array.
case_sensitive If true, consider case when performing comparison. (default: yes)
Returns:
csArrayItemNotFound if not found, else item index.
Remarks:
Works with sorted and unsorted arrays, but FindSortedKey() is faster on sorted arrays.

Some people find Contains() more idiomatic than Find().

Implements iStringArray.

Definition at line 123 of file scfstringarray.h.

virtual void scfStringArray::DeleteAll  )  [inline, virtual]
 

Remove all strings from array.

Deprecated:
Use Empty() instead.

Implements iStringArray.

Definition at line 160 of file scfstringarray.h.

References iStringArray::Empty().

virtual bool scfStringArray::DeleteIndex size_t  n  )  [inline, virtual]
 

Delete string n from the array.

Implements iStringArray.

Definition at line 139 of file scfstringarray.h.

virtual void scfStringArray::Empty  )  [inline, virtual]
 

Remove all strings from array, releasing allocated memory.

Implements iStringArray.

Definition at line 151 of file scfstringarray.h.

virtual size_t scfStringArray::Find const char *  value  )  const [inline, virtual]
 

Find a string, case-sensitive.

Returns:
csArrayItemNotFound if not found, else item index.
Remarks:
Works with sorted and unsorted arrays, but FindSortedKey() is faster on sorted arrays.

Implements iStringArray.

Definition at line 86 of file scfstringarray.h.

virtual size_t scfStringArray::FindCaseInsensitive const char *  value  )  const [inline, virtual]
 

Find a string, case-insensitive.

Returns:
csArrayItemNotFound if not found, else item index.
Remarks:
Works with sorted and unsorted arrays, but FindSortedKey() is faster on sorted arrays.

Implements iStringArray.

Definition at line 97 of file scfstringarray.h.

virtual size_t scfStringArray::FindSortedKey const char *  value  )  const [inline, virtual]
 

Find an element based on some key, using a comparison function.

Returns:
csArrayItemNotFound if not found, else item index.
Remarks:
The array must be sorted.

Implements iStringArray.

Definition at line 107 of file scfstringarray.h.

virtual char const* scfStringArray::Get size_t  n  )  const [inline, virtual]
 

Get a particular string from the array.

Implements iStringArray.

Definition at line 75 of file scfstringarray.h.

virtual size_t scfStringArray::GetSize  )  const [inline, virtual]
 

Get array length.

Implements iStringArray.

Definition at line 44 of file scfstringarray.h.

virtual bool scfStringArray::Insert size_t  n,
char const *  value
[inline, virtual]
 

Insert a string before entry n in the array.

Implements iStringArray.

Definition at line 145 of file scfstringarray.h.

virtual bool scfStringArray::IsEmpty  )  const [inline, virtual]
 

Return true if the array is empty.

Remarks:
Rigidly equivalent to return GetSize() == 0, but more idiomatic.

Implements iStringArray.

Definition at line 170 of file scfstringarray.h.

virtual size_t scfStringArray::Length  )  const [inline, virtual]
 

Get array length.

Deprecated:
Use GetSize() instead.

Implements iStringArray.

Definition at line 53 of file scfstringarray.h.

References iStringArray::GetSize().

virtual char* scfStringArray::Pop  )  [inline, virtual]
 

Pop an element from tail end of array.

Remarks:
Caller is responsible for invoking delete[] on the returned string when no longer needed.

Implements iStringArray.

Definition at line 69 of file scfstringarray.h.

virtual void scfStringArray::Push char const *  value  )  [inline, virtual]
 

Push a string onto the stack.

Implements iStringArray.

Definition at line 59 of file scfstringarray.h.

virtual void scfStringArray::Sort bool  case_sensitive = true  )  [inline, virtual]
 

Sort array.

Parameters:
case_sensitive If true, consider case when performing comparison. (default: yes)

Implements iStringArray.

Definition at line 133 of file scfstringarray.h.


The documentation for this class was generated from the following file:
Generated for Crystal Space by doxygen 1.4.4