diff options
Diffstat (limited to 'ace/SString.h')
| -rw-r--r-- | ace/SString.h | 335 |
1 files changed, 0 insertions, 335 deletions
diff --git a/ace/SString.h b/ace/SString.h deleted file mode 100644 index 419b5db3ce8..00000000000 --- a/ace/SString.h +++ /dev/null @@ -1,335 +0,0 @@ -/* -*- C++ -*- */ -// $Id$ - -// ============================================================================ -// -// = LIBRARY -// ace -// -// = FILENAME -// SString.h -// -// = AUTHOR -// Douglas C. Schmidt (schmidt@cs.wustl.edu) -// -// ============================================================================ - -#if !defined (ACE_SSTRING_H) -#define ACE_SSTRING_H - -#include "ace/ACE.h" - -// Forward decl. -class ACE_Allocator; - -class ACE_Export ACE_CString -{ - // = TITLE - // A simple "C String" (ACE_CString) class. - // - // = DESCRIPTION - // This is a place holder until all compilers implement the - // ANSI/ISO C++ standard String class. Note that we need to use - // this class since the ACE 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. NOTE: if an instance of this class is - // constructed from or assigned an empty string (with first - // element of '\0'), then it is _not_ allocated new space. - // Instead, its internal representation is set equal to a global - // empty string. -public: - friend ACE_CString operator+ (const ACE_CString &, const ACE_CString &); - friend ostream &operator << (ostream &, const ACE_CString &); - - ACE_CString (ACE_Allocator *alloc = 0); - // Default constructor. - - ACE_CString (const char *s, ACE_Allocator *alloc = 0); - // Constructor that copies <s> into dynamically allocated memory. - - ACE_CString (const ACE_CString &); - // Copy constructor. - - ACE_CString (const ACE_USHORT16 *s, ACE_Allocator *alloc = 0); - // Constructor that copies <s> into dynamically allocated memory. - // Probable loss of data. Please use with care. - - ~ACE_CString (void); - // Deletes the memory... - - ACE_CString (const char *s, size_t len, ACE_Allocator *alloc = 0); - // Constructor that copies <len> chars of <s> into dynamically - // allocated memory (will NUL terminate the result). - - void operator= (const ACE_CString &); - // Assignment operator (does copy memory). - - size_t length (void) const; - // Return the length of the string. - - u_long hash (void) const; - // Returns a hash value for this string. - - char *rep (void) const; - // Get a copy of the underlying pointer. - - const char *fast_rep (void) const; - // Get at the underlying representation directly! - // _Don't_ even think about casting the result to (char *) and modifying it, - // if it has length 0! - - const char *c_str (void) const; - // Same as STL String's c_str() - - void operator += (const ACE_CString &); - // Concat operator (copies memory). - - int strstr (const ACE_CString &s) const; - // Comparison operator that will match substrings. Returns the - // index of the first location that matches, else -1. - - char operator[] (size_t index) const; - // Return the <index'th> character in the string (doesn't perform - // bounds checking). - - ACE_CString substring (size_t offset, ssize_t length = -1); - // Return a substring given an offset and length, if length == -1 - // use rest of str return empty substring if offset or offset/length - // are invalid - - int operator== (const ACE_CString &s) const; - // Equality comparison operator (must match entire string). - - int operator!= (const ACE_CString &s) const; - // Inequality comparison operator. - - int compare (const ACE_CString &s) const; - // Performs a <strcmp>-style comparison. - - void dump (void) const; - // Dump the state of an object. - - ACE_ALLOC_HOOK_DECLARE; - // Declare the dynamic allocation hooks. - -private: - ACE_Allocator *allocator_; - // Pointer to a memory allocator. - - size_t len_; - // Length of the ACE_CString (not counting the trailing '\0'). - - char *rep_; - // Pointer to data. - - static char NULL_CString_; - // Represents the "NULL" string to simplify the internal logic. -}; - -ACE_CString operator+ (const ACE_CString &, const ACE_CString &); -ostream &operator << (ostream &, const ACE_CString &); - -class ACE_Export ACE_SString - // = TITLE - // A very "Simple String" (ACE_SString) class. - // - // = DESCRIPTION - // This is *not* a general-purpose string class. It is only - // intended for use with applications that understand how it - // works. In particular, it has no destructor... Note that we - // need to use this class since the ACE 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 -{ -public: - 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_t len, ACE_Allocator *alloc = 0); - // Constructor that copies <len> chars of <s> into dynamically - // allocated memory (will NUL terminate the result). - - ACE_SString (const ACE_SString &); - // Copy constructor. - - void operator= (const ACE_SString &); - // Assignment operator (does copy memory). - - size_t length (void) const; - // Return the length of the string. - - u_long hash (void) const; - // Returns a hash value for this string. - - void rep (char *s); - // Set the underlying pointer. Since this does not copy memory or - // delete existing memory use with extreme caution!!! - - const char *rep (void) const; - // Get the underlying pointer. - - void operator += (const ACE_SString &); - // Concat operator (does copy memory). - - int strstr (const ACE_SString &s) const; - // Comparison operator that will match substrings. Returns the - // index of the first location that matches, else -1. - - char operator[] (size_t index) const; - // Return the <index'th> character in the string (doesn't perform - // bounds checking). - - int operator== (const ACE_SString &s) const; - // Equality comparison operator (must match entire string). - - int 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. - - ACE_ALLOC_HOOK_DECLARE; - // Declare the dynamic allocation hooks. - -private: - ACE_Allocator *allocator_; - // Pointer to a memory allocator. - - size_t len_; - // Length of the ACE_SString (not counting the trailing '\0'). - - char *rep_; - // Pointer to data. -}; - -class ACE_Export ACE_WString - // = TITLE - // A persistent wide string class. - // - // = DESCRIPTION - // This is *not* a general-purpose string class. It is only - // intended for use with applications that understand how it - // works. Note that we need to use this class since the ACE - // 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 -{ - friend ACE_WString operator+ (const ACE_WString &, const ACE_WString &); -public: - ACE_WString (ACE_Allocator *alloc = 0); - // Default constructor. - - ACE_WString (const char *s, - ACE_Allocator *alloc = 0); - // Constructor that copies <s> into dynamically allocated memory. - - ACE_WString (const ACE_USHORT16 *s, - ACE_Allocator *alloc = 0); - // Constructor that copies <s> into dynamically allocated memory. - - ACE_WString (const ACE_USHORT16 *s, - size_t len, - ACE_Allocator *alloc = 0); - // Constructor that copies <len> ACE_USHORT16's of <s> into dynamically - // allocated memory (will NUL terminate the result). - - ACE_WString (size_t len, ACE_Allocator *alloc = 0); - // Constructor that dynamically allocates memory for <len> + 1 - // ACE_USHORT16 characters. The newly created memory is set memset to 0. - - ACE_WString (const ACE_WString &s); - // Copy constructor. - - ~ACE_WString (void); - // Deletes the memory... - - ACE_USHORT16 operator[] (size_t index) const; - // Return the <index'th> character in the string (doesn't perform - // bounds checking). - - void operator= (const ACE_WString &); - // Assignment operator (does copy memory). - - ACE_WString substring (size_t offset, ssize_t length = -1); - // return a substring given an offset and length, if length == -1 - // use rest of str return empty substring if offset or offset/length - // are invalid. - - void operator += (const ACE_WString &); - // Concat operator (does copy memory). - - u_long hash (void) const; - // Returns a hash value for this string. - - size_t length (void) const; - // Return the length of the string. - - ACE_USHORT16 *rep (void) const; - // Gets a copy of the underlying pointer. - - char *char_rep (void) const; - // Transform into a copy of the ASCII character representation. - - const ACE_USHORT16 *fast_rep (void) const; - // Get at the underlying representation directly! - - const ACE_USHORT16 *c_str (void) const; - // Same as STL String's c_str() - - int strstr (const ACE_WString &s) const; - // Comparison operator that will match substrings. Returns the - // index of the first location that matches, else -1. - - int operator== (const ACE_WString &s) const; - // Equality comparison operator (must match entire string). - - int operator!= (const ACE_WString &s) const; - // Inequality comparison operator. - - int compare (const ACE_WString &s) const; - // Performs a <strcmp>-style comparison. - - void dump (void) const; - // Dump the state of an object. - - ACE_ALLOC_HOOK_DECLARE; - // Declare the dynamic allocation hooks. - - static size_t wstrlen (const ACE_USHORT16 *); - // Computes the length of a "0" terminated ACE_USHORT16 *. - - void resize (size_t len); - // This method is designed for high-performance. Please use with - // care ;-) If the current size of the string is less than <len>, - // the string is resized to the new length. The data is is zero'd - // out after this operation. - -private: - ACE_Allocator *allocator_; - // Pointer to a memory allocator. - - size_t len_; - // Length of the ACE_WString. - - ACE_USHORT16 *rep_; - // Pointer to data. -}; - -ACE_WString operator+ (const ACE_WString &, const ACE_WString &); - -#if defined (__ACE_INLINE__) -#include "ace/SString.i" -#endif /* __ACE_INLINE__ */ - -#endif /* ACE_SSTRING_H */ |