ACE 6.0.3
|
A very Simple String ACE_SString class. This is not a general-purpose string class, and you should probably consider using ACE_CString is you don't understand why this class exists... More...
#include <SString.h>
Public Types | |
typedef ACE_Allocator::size_type | size_type |
Public Member Functions | |
ACE_SString (ACE_Allocator *alloc=0) | |
Default constructor. | |
ACE_SString (const char *s, ACE_Allocator *alloc=0) | |
Constructor that copies s into dynamically allocated memory. | |
ACE_SString (const char *s, size_type len, ACE_Allocator *alloc=0) | |
ACE_SString (const ACE_SString &) | |
Copy constructor. | |
ACE_SString (char c, ACE_Allocator *alloc=0) | |
Constructor that copies c into dynamically allocated memory. | |
~ACE_SString (void) | |
Default destructor. | |
char | operator[] (size_type slot) const |
char & | operator[] (size_type slot) |
ACE_SString & | operator= (const ACE_SString &) |
Assignment operator (does copy memory). | |
ACE_SString | substring (size_type offset, size_type length=npos) const |
ACE_SString | substr (size_type offset, size_type length=npos) const |
Same as substring. | |
u_long | hash (void) const |
Returns a hash value for this string. | |
size_type | length (void) const |
Return the length of the string. | |
void | rep (char *s) |
const char * | rep (void) const |
Get the underlying pointer. | |
const char * | fast_rep (void) const |
Get the underlying pointer. | |
const char * | c_str (void) const |
Same as STL String's c_str() and fast_rep(). | |
size_type | strstr (const ACE_SString &s) const |
size_type | find (const ACE_SString &str, size_type pos=0) const |
size_type | find (const char *s, size_type pos=0) const |
size_type | find (char c, size_type pos=0) const |
size_type | rfind (char c, size_type pos=npos) const |
bool | operator== (const ACE_SString &s) const |
Equality comparison operator (must match entire string). | |
bool | operator< (const ACE_SString &s) const |
Less than comparison operator. | |
bool | operator> (const ACE_SString &s) const |
Greater than comparison operator. | |
bool | operator!= (const ACE_SString &s) const |
Inequality comparison operator. | |
int | compare (const ACE_SString &s) const |
Performs a strcmp()-style comparison. | |
void | dump (void) const |
Dump the state of an object. | |
Public Attributes | |
ACE_ALLOC_HOOK_DECLARE | |
Declare the dynamic allocation hooks. | |
Static Public Attributes | |
static const size_type | npos |
No position constant. | |
Private Attributes | |
ACE_Allocator * | allocator_ |
Pointer to a memory allocator. | |
size_type | len_ |
Length of the ACE_SString (not counting the trailing '\0'). | |
char * | rep_ |
Pointer to data. |
A very Simple String ACE_SString class. This is not a general-purpose string class, and you should probably consider using ACE_CString is you don't understand why this class exists...
This class is optimized for efficiency, so it doesn't provide any internal locking. CAUTION: This class is only intended for use with applications that understand how it works. In particular, its destructor does not deallocate its memory when it is destroyed... We need this class since the ACE_Map_Manager requires an object that supports the operator == and operator !=. This class uses an ACE_Allocator to allocate memory. The user can make this a persistant class by providing an ACE_Allocator with a persistable memory pool.
ACE_SString::ACE_SString | ( | ACE_Allocator * | alloc = 0 | ) |
Default constructor.
ACE_SString::ACE_SString | ( | const char * | s, |
ACE_Allocator * | alloc = 0 |
||
) |
Constructor that copies s into dynamically allocated memory.
ACE_SString::ACE_SString | ( | const char * | s, |
size_type | len, | ||
ACE_Allocator * | alloc = 0 |
||
) |
Constructor that copies len chars of s into dynamically allocated memory (will NUL terminate the result).
ACE_SString::ACE_SString | ( | const ACE_SString & | s | ) |
Copy constructor.
ACE_SString::ACE_SString | ( | char | c, |
ACE_Allocator * | alloc = 0 |
||
) |
Constructor that copies c into dynamically allocated memory.
ACE_SString::~ACE_SString | ( | void | ) | [inline] |
Default destructor.
const char * ACE_SString::c_str | ( | void | ) | const [inline] |
Same as STL String's c_str() and fast_rep().
int ACE_SString::compare | ( | const ACE_SString & | s | ) | const [inline] |
Performs a strcmp()-style comparison.
void ACE_SString::dump | ( | void | ) | const |
Dump the state of an object.
const char * ACE_SString::fast_rep | ( | void | ) | const [inline] |
Get the underlying pointer.
ACE_SString::size_type ACE_SString::find | ( | const ACE_SString & | str, |
size_type | pos = 0 |
||
) | const [inline] |
Find str starting at pos. Returns the slot of the first location that matches (will be >= pos), else npos.
ACE_SString::size_type ACE_SString::find | ( | const char * | s, |
size_type | pos = 0 |
||
) | const [inline] |
Find <s> starting at pos. Returns the slot of the first location that matches (will be >= pos), else npos.
ACE_SString::size_type ACE_SString::find | ( | char | c, |
size_type | pos = 0 |
||
) | const [inline] |
Find c starting at pos. Returns the slot of the first location that matches (will be >= pos), else npos.
u_long ACE_SString::hash | ( | void | ) | const [inline] |
Returns a hash value for this string.
ACE_SString::size_type ACE_SString::length | ( | void | ) | const [inline] |
Return the length of the string.
bool ACE_SString::operator!= | ( | const ACE_SString & | s | ) | const [inline] |
Inequality comparison operator.
bool ACE_SString::operator< | ( | const ACE_SString & | s | ) | const [inline] |
Less than comparison operator.
ACE_SString & ACE_SString::operator= | ( | const ACE_SString & | s | ) |
Assignment operator (does copy memory).
bool ACE_SString::operator== | ( | const ACE_SString & | s | ) | const [inline] |
Equality comparison operator (must match entire string).
bool ACE_SString::operator> | ( | const ACE_SString & | s | ) | const [inline] |
Greater than comparison operator.
char & ACE_SString::operator[] | ( | size_type | slot | ) | [inline] |
Return the <slot'th> character by reference in the string (doesn't perform bounds checking).
char ACE_SString::operator[] | ( | size_type | slot | ) | const [inline] |
Return the <slot'th> character in the string (doesn't perform bounds checking).
const char * ACE_SString::rep | ( | void | ) | const [inline] |
Get the underlying pointer.
void ACE_SString::rep | ( | char * | s | ) |
Set the underlying pointer. Since this does not copy memory or delete existing memory use with extreme caution!!!
ACE_SString::size_type ACE_SString::rfind | ( | char | c, |
size_type | pos = npos |
||
) | const [inline] |
Find c starting at pos (counting from the end). Returns the slot of the first location that matches, else npos.
ACE_SString::size_type ACE_SString::strstr | ( | const ACE_SString & | s | ) | const [inline] |
Comparison operator that will match substrings. Returns the slot of the first location that matches, else npos
.
ACE_SString ACE_SString::substr | ( | size_type | offset, |
size_type | length = npos |
||
) | const [inline] |
Same as substring.
ACE_SString ACE_SString::substring | ( | size_type | offset, |
size_type | length = npos |
||
) | const |
Return a substring given an offset and length, if length == npos use rest of str return empty substring if offset or offset/length are invalid
Declare the dynamic allocation hooks.
ACE_Allocator* ACE_SString::allocator_ [private] |
Pointer to a memory allocator.
size_type ACE_SString::len_ [private] |
Length of the ACE_SString (not counting the trailing '\0').
ACE_SString::size_type const ACE_SString::npos [static] |
No position constant.
char* ACE_SString::rep_ [private] |
Pointer to data.