| Oracle® C++ Call Interface Programmer's Guide 10g Release 2 (10.2) Part Number B14294-01 |
|
|
View PDF |
The RefAny class is designed to support a reference to any type. Its primary purpose is to handle generic references and allow conversions of Ref in the type hierarchy. A RefAny object can be used as an intermediary between any two types, Ref<x> and Ref<y>, where x and y are different types.
Table 12-36 Summary of RefAny Methods
| Method | Summary |
|---|---|
| RefAny() |
Constructor for RefAny class. |
| clear() |
Clears the reference. |
| getConnection() |
Returns the connection this ref was created from. |
| isNull() |
Checks if the RefAny object is NULL. |
| markDelete() |
Marks the object as deleted. |
| operator=() |
Assignment operator for RefAny. |
| operator==() |
Checks if this RefAny object is equal to a specified RefAny. |
| operator!=() |
Checks if not equal. |
| unmarkDelete() |
Unmarks the object as deleted. |
A Ref<T> can always be converted to a RefAny; there is a method to perform the conversion in the Ref<T> template. Each Ref<T> has a constructor and assignment operator that takes a reference to RefAny.
| Syntax | Description |
|---|---|
RefAny(); |
Creates a NULL RefAny. |
RefAny( const Connection *sessptr, const OCIRef *ref); |
Creates a RefAny from a session pointer and a reference. |
RefAny( const RefAny& src); |
Creates a RefAny as a copy of another RefAny object. |
| Parameter | Description |
|---|---|
sessptr |
Session pointer |
ref |
A reference |
src |
The source RefAny object to be assigned |
This method clears the reference.
Syntax
void clear();
Returns the connection from which this reference was instantiated.
Syntax
const Connection* getConnection() const;
Returns TRUE if the object pointed to by this ref is NULL else FALSE.
Syntax
bool isNull() const;
This method marks the referred object as deleted.
Syntax
void markDelete();
Assignment operator for RefAny.
Syntax
RefAny& operator=( const RefAny& src);
| Parameter | Description |
|---|---|
src |
The source RefAny object to be assigned. |
Compares this ref with a RefAny object and returns TRUE if both the refs are referring to the same object in the cache, otherwise it returns FALSE.
Syntax
bool operator== ( const RefAny &refAnyR) const;
| Parameter | Description |
|---|---|
refAnyR |
RefAny object to which the comparison is made. |
Compares this ref with the RefAny object and returns TRUE if both the refs are not referring to the same object in the cache, otherwise it returns FALSE.
Syntax
bool operator!= ( const RefAny &refAnyR) const;
| Parameter | Description |
|---|---|
refAnyR |
RefAny object to which the comparison is made. |
This method unmarks the referred object as dirty.
Syntax
void unmarkDelete();