## NAME

ACE_NS_String - This class and ACE_NS_Internal are used as Adapters to work with the Map_Manager.

## SYNOPSIS

    #include <ACE/Local_Name_Space.h>

    class ACE_NS_String
    {
      public:
        ACE_NS_String (void);
        ACE_NS_String (
            ACE_USHORT16 *dst,
            const ACE_USHORT16 *src,
            size_t len
            );
        ACE_NS_String (const ACE_WString &);
        operator ACE_WString () const;
        char *char_rep (void) const;
        int strstr (const ACE_NS_String &) const;
        int operator == (const ACE_NS_String &) const;
        int operator != (const ACE_NS_String &) const;
        size_t len (void) const;
        ACE_USHORT16 *fast_rep (void) const;
        size_t hash (void) const;
      private:
        size_t len_;
        ACE_USHORT16 *rep_;
    };

## DESCRIPTION

In order to work correctly, this class must be able to convert back and forth with `ACE_WStrings`. Note that this class must not have a destructor since otherwise we'll have problems...

## Initialization.

    ACE_NS_String (void);

Default "no-op" constructor.

    ACE_NS_String (
        ACE_USHORT16 *dst,
        const ACE_USHORT16 *src,
        size_t len
        );

Initialization method.

    ACE_NS_String (const ACE_WString &);

Converts an ACE_WString to an ACE_NS_String;

    operator ACE_WString () const;

Converts an ACE_NS_String to fresh copy of an ACE_WString;

    char *char_rep (void) const;

Return the ASCII character representation.

    int strstr (const ACE_NS_String &) const;

Matches on substrings.

    int operator == (const ACE_NS_String &) const;

Compare an ACE_NS_String.

    int operator != (const ACE_NS_String &) const;

Compare an ACE_NS_String.

    size_t len (void) const;

Returns length of the string

    ACE_USHORT16 *fast_rep (void) const;

Returns the underlying representation.

    size_t hash (void) const;

Returns a hash value for this string.

## AUTHOR

Prashant Jain (pjain@cs.wustl.edu), Irfan Pyarali (irfan@wuerl.wustl.edu), and Douglas C. Schmidt (schmidt@cs.wustl.edu).

## LIBRARY

ACE