ACE_NS_WString Class Reference

This class retain the backward compatibility for ACE_Naming_Context and related classes. The only addition to ACE_WString is a very naive "wchar" to "char" conversion function. More...

#include <SString.h>

Inheritance diagram for ACE_NS_WString:

[legend]Collaboration diagram for ACE_NS_WString:

[legend]List of all members.

Public Member Functions
	ACE_NS_WString (ACE_Allocator *alloc=0)
	Default constructor.
	ACE_NS_WString (const char *s, ACE_Allocator *alloc=0)
	Constructor that copies s into dynamically allocated memory.
	ACE_NS_WString (const ACE_WSTRING_TYPE *s, ACE_Allocator *alloc=0)
	Constructor that copies s into dynamically allocated memory.
	ACE_NS_WString (const ACE_USHORT16 *s, size_type len, ACE_Allocator *alloc=0)
	ACE_NS_WString (const ACE_WSTRING_TYPE *s, size_type len, ACE_Allocator *alloc=0)
	ACE_NS_WString (size_type len, ACE_Allocator *alloc=0)
	ACE_NS_WString (const ACE_NS_WString &s)
	Copy constructor.
	ACE_NS_WString (ACE_WSTRING_TYPE c, ACE_Allocator *alloc=0)
	Constructor that copies c into dynamically allocated memory.
char *	char_rep (void) const
ACE_USHORT16 *	ushort_rep (void) const

---

Detailed Description

This class retain the backward compatibility for ACE_Naming_Context and related classes. The only addition to ACE_WString is a very naive "wchar" to "char" conversion function.

Definition at line 52 of file SString.h.

---

Constructor & Destructor Documentation

ACE_BEGIN_VERSIONED_NAMESPACE_DECL ACE_INLINE ACE_NS_WString::ACE_NS_WString (  ACE_Allocator *  alloc = 0  )

Default constructor. Definition at line 17 of file SString.inl. References ACE_WString. : ACE_WString (alloc) { }

ACE_NS_WString::ACE_NS_WString (  const char *  s, ACE_Allocator *  alloc = 0 )

Constructor that copies s into dynamically allocated memory. Definition at line 114 of file SString.cpp. References ACE_ALLOCATOR, ACE_WString, ACE_WSTRING_TYPE, and ACE_OS::strlen(). : ACE_WString (alloc) { if (s == 0) return; this->len_ = this->buf_len_ = ACE_OS::strlen (s); if (this->buf_len_ == 0) return; ACE_ALLOCATOR (this->rep_, (ACE_WSTRING_TYPE *) this->allocator_->malloc ((this->buf_len_ + 1) * sizeof (ACE_WSTRING_TYPE))); this->release_ = 1; for (size_type i = 0; i <= this->buf_len_; ++i) this->rep_[i] = s[i]; }

ACE_INLINE ACE_NS_WString::ACE_NS_WString (  const ACE_WSTRING_TYPE *  s, ACE_Allocator *  alloc = 0 )

Constructor that copies s into dynamically allocated memory. Definition at line 31 of file SString.inl. References ACE_WString, and ACE_WSTRING_TYPE. : ACE_WString (s, alloc) { }

ACE_NS_WString::ACE_NS_WString (  const ACE_USHORT16 *  s, size_type  len, ACE_Allocator *  alloc = 0 )

Constructor that takes in a ushort16 string (mainly used by the ACE Name_Space classes) Definition at line 136 of file SString.cpp. References ACE_ALLOCATOR, ACE_USHORT16, ACE_WString, and ACE_WSTRING_TYPE. : ACE_WString (alloc) { if (s == 0) return; this->buf_len_ = len; if (this->buf_len_ == 0) return; ACE_ALLOCATOR (this->rep_, (ACE_WSTRING_TYPE *) this->allocator_->malloc ((this->buf_len_) * sizeof (ACE_WSTRING_TYPE))); this->release_ = 1; for (size_type i = 0; i < this->buf_len_; ++i) this->rep_[i] = s[i]; }

ACE_INLINE ACE_NS_WString::ACE_NS_WString (  const ACE_WSTRING_TYPE *  s, size_type  len, ACE_Allocator *  alloc = 0 )

Constructor that copies len ACE_WSTRING_TYPE's of s into dynamically allocated memory (will NUL terminate the result). Definition at line 23 of file SString.inl. References ACE_WString, and ACE_WSTRING_TYPE. : ACE_WString (s, len, alloc) { }

ACE_INLINE ACE_NS_WString::ACE_NS_WString (  size_type  len, ACE_Allocator *  alloc = 0 )

Constructor that dynamically allocates memory for len + 1 ACE_WSTRING_TYPE characters. The newly created memory is set memset to 0. Definition at line 38 of file SString.inl. References ACE_WString. : ACE_WString (len, 0, alloc) { }

ACE_INLINE ACE_NS_WString::ACE_NS_WString (  const ACE_NS_WString &  s  )

Copy constructor. Definition at line 44 of file SString.inl. References ACE_WString. : ACE_WString (s) { }

ACE_INLINE ACE_NS_WString::ACE_NS_WString (  ACE_WSTRING_TYPE  c, ACE_Allocator *  alloc = 0 )

Constructor that copies c into dynamically allocated memory. Definition at line 50 of file SString.inl. References ACE_WString, and ACE_WSTRING_TYPE. : ACE_WString (c, alloc) { }

---

Member Function Documentation

char * ACE_NS_WString::char_rep (  void   )  const

Transform into a copy of the ASCII character representation. (caller must delete) Definition at line 67 of file SString.cpp. References ACE_NEW_RETURN, and ACE_TRACE. Referenced by ACE_NS_String::char_rep(), ACE_Local_Name_Space<, ACE_LOCK >::list_type_entries_i(), ACE_Local_Name_Space<, ACE_LOCK >::list_types_i(), and ACE_Naming_Context::resolve(). { ACE_TRACE ("ACE_NS_WString::char_rep"); if (this->len_ == 0) return 0; else { char *t = 0; ACE_NEW_RETURN (t, char[this->len_ + 1], 0); for (size_type i = 0; i < this->len_; ++i) // Note that this cast may lose data if wide chars are // actually used! t[i] = char (this->rep_[i]); t[this->len_] = '\0'; return t; } }

ACE_USHORT16 * ACE_NS_WString::ushort_rep (  void   )  const

Transform into a copy of a USHORT16 representation (caller must delete). Note, behavior is undefined when sizeof (wchar_t) != 2. Definition at line 91 of file SString.cpp. References ACE_NEW_RETURN, ACE_TRACE, and ACE_USHORT16. { ACE_TRACE ("ACE_NS_WString::ushort_rep"); if (this->len_ <= 0) return 0; else { ACE_USHORT16 *t = 0; ACE_NEW_RETURN (t, ACE_USHORT16[this->len_ + 1], 0); for (size_type i = 0; i < this->len_; ++i) // Note that this cast may lose data if wide chars are // actually used! t[i] = (ACE_USHORT16)this->rep_[i]; t[this->len_] = 0; return t; } }

---

The documentation for this class was generated from the following files:

• SString.h
• SString.cpp
• SString.inl

---