RWAny Struct Reference
[Miscellaneous]

Encapsulates an object of an arbitrary type. More...

#include <rw/any.h>

List of all members.

Public Member Functions
	RWAny ()
template<class T >
	RWAny (const T &ref)
	RWAny (const RWAny &ref)
RWAny &	operator= (const RWAny &ref)
template<typename T >
RWAny &	operator= (const T &ref)
	RWAny (RWAny &&ref)
RWAny &	operator= (RWAny &&ref)
RWAny &	swap (RWAny &ref)
const std::type_info *	type () const
template<class T >
T &	get ()
template<class T >
const T &	get () const
template<class T >
T *	address ()
template<class T >
const T *	address () const

---

Detailed Description

RWAny encapsulates an object of an arbitrary type; it can:

• store objects of arbitrary types (by value or by pointer)
• retrieve the original object in a "type-safe" manner
• swap the object with another RWAny
• assign objects of type RWAny

Requirements for types held by RWAny are:

• the type must be complete
• the type must be copy constructible
• the type must be assignable

Synopsis

 #include <rw/any.h>
 RWAny a;

Persistence

None

---

Constructor & Destructor Documentation

RWAny::RWAny

(

)

[inline]

Default constructor. Creates an empty object. Post-condition: for any T, (address<T>() == 0).

template<class T >

RWAny::RWAny

(

const T &

ref

)

[inline]

Template constructor for type any holding T. Creates RWAny object holding a copy of argument ref.

RWAny::RWAny

(

const RWAny &

ref

)

[inline]

Copy constructor. Creates a copy of ref.

RWAny::RWAny

(

RWAny &&

ref

)

[inline]

Move constructor. The constructed instance takes ownership of the data owned by ref.

Condition:

This method is only available on platforms with rvalue reference support.

---

Member Function Documentation

template<class T >

const T* RWAny::address

(

)

const [inline]

Implements address retrieval. Returns the address of the object held in any or 0 if the object is not of the type requested.

template<class T >

T* RWAny::address

(

)

[inline]

Implements address retrieval. Returns the address of the object held in any or 0 if the object is not of the type requested.

template<class T >

const T& RWAny::get

(

)

const [inline]

Implements value retrieval. Returns *address<T>() if T is the type of the object stored in self, or throws an exception of type (or a type derived from) std::bad_cast otherwise.

template<class T >

T& RWAny::get

(

)

[inline]

Implements value retrieval. Returns *address<T>() if T is the type of the object stored in self, or throws an exception of type (or a type derived from) std::bad_cast otherwise.

RWAny& RWAny::operator=

(

RWAny &&

ref

)

[inline]

Move assignment. Self takes ownership of the data owned by ref.

Condition:

This method is only available on platforms with rvalue reference support.

template<typename T >

RWAny& RWAny::operator=

(

const T &

ref

)

[inline]

Template assignment operator for type any holding T. Assigns self to hold copy of argument ref.

RWAny& RWAny::operator=

(

const RWAny &

ref

)

[inline]

Assignment operator. Deep-copies ref. Returns a reference to self.

RWAny& RWAny::swap

(

RWAny &

ref

)

[inline]

Implements a swap operation. After the swap, this object contains the old content of the argument and vice versa.

const std::type_info* RWAny::type

(

)

const [inline]

Implements type retrieval. Returns &typeid (T) if any holds an object of type T, or 0 otherwise.