NAME

ACE_WString - A persistent wide string class.

SYNOPSIS


#include <ace/SString.h>


class ACE_WString
{
  public:
    ACE_WString (ACE_Allocator *allocator = 0);
    ACE_WString (const char *s, ACE_Allocator *allocator = 0);
    ACE_WString (const ACE_USHORT16 *s, ACE_Allocator *allocator = 0);
    ACE_WString (
        const ACE_USHORT16 *s,
        size_t len,
        ACE_Allocator *allocator = 0
        );
    ACE_WString (const ACE_WString &s);
    ~ACE_WString (void);
    ACE_USHORT16 operator[] (size_t index) const;
    void operator= (const ACE_WString &);
    void operator += (const ACE_WString &);
    size_t length (void) const;
    ACE_USHORT16 *rep (void) const;
    char *char_rep (void) const;
    ACE_USHORT16 *fast_rep (void) const;
    int strstr (const ACE_WString &s) const;
    int operator== (const ACE_WString &s) const;
    int operator!= (const ACE_WString &s) const;
    void dump (void) const;
    ACE_ALLOC_HOOK_DECLARE;
  private:
    ACE_Allocator *allocator_;
    size_t wstrlen (const ACE_USHORT16 *);
    size_t len_;
    ACE_USHORT16 *rep_;
};

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

PUBLIC MEMBERS

ACE_WString (ACE_Allocator *allocator = 0);
ACE_WString (const char *s, ACE_Allocator *allocator = 0);
ACE_WString (const ACE_USHORT16 *s, ACE_Allocator *allocator = 0);
ACE_WString (
    const ACE_USHORT16 *s,
    size_t len,
    ACE_Allocator *allocator = 0
    );
ACE_WString (const ACE_WString &s);
~ACE_WString (void);
ACE_USHORT16 operator[] (size_t index) const;
void operator= (const ACE_WString &);
void operator += (const ACE_WString &);
size_t length (void) const;
ACE_USHORT16 *rep (void) const;
char *char_rep (void) const;
ACE_USHORT16 *fast_rep (void) const;
int strstr (const ACE_WString &s) const;
int operator== (const ACE_WString &s) const;
int operator!= (const ACE_WString &s) const;
void dump (void) const;
ACE_ALLOC_HOOK_DECLARE;

PRIVATE MEMBERS

ACE_Allocator *allocator_;
size_t wstrlen (const ACE_USHORT16 *);
size_t len_;
ACE_USHORT16 *rep_;

AUTHOR

Douglas C. Schmidt (schmidt@cs.wustl.edu)

LIBRARY

ace