C++ API Reference for Oracle® Coherence Community Edition
(14.1.1.0.1)
F23533-01

String::StringHandle Class Template Reference

#include <coherence/lang/String.hpp>

Inherits TypedHandle< T >.

List of all members.

---

Detailed Description

template<class T>
class coherence::lang::String::StringHandle< T >

StringHandle provides standard TypedHandle features as well as auto-boxing support for standard string types including:.

• char[] C-style NUL terminated char array
• std::string STL string
• std::wstring STL wide string

Boxing from wchar_t[] is supported, but requires an explicit constructor call in order to avoid ambiguity when assigning a String handle/view to NULL.

Unboxing to char[] and wchar[] is not supported as it is unsafe to maintain a reference to the underlying character array without holding a reference to the String. Unboxing to std::string, and std::wstring is both supported and safe.

Public Member Functions
	StringHandle ()
	Create an empty StringHandle.
	StringHandle (const char *ach)
	Create a new StringHandle from a boxable type.
	StringHandle (const wchar_t *ach)
	Create a new StringHandle from a boxable type.
template<class C, class R, class A>
	__attribute__ ((always_inline)) inline StringHandle(const std
	Create a new StringHandle from a boxable type.
template<class O>
	S (const TypedHandle< O > &that)
	Create a new StringHandle from the TypedHandle with a type conversion.
	StringHandle (const StringHandle &that)
	The copy constructor.
	StringHandle (T *o)
	Create a new StringHandle from the raw pointer.
template<class O>
StringHandle &	operator= (const TypedHandle< O > &that)
	The assignment operator.
StringHandle &	operator= (const char *ach)
	The "boxing" operator.

---

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

• coherence/lang/String.hpp

Copyright © 2000, 2020, Oracle and/or its affiliates. Licensed under the Universal Permissive License v 1.0 as shown at http://oss.oracle.com/licenses/upl.