Oracle® Objects for OLE C++ Class Library Developer's Guide 10g Release 2 (10.2) Part Number B14308-01 |
|
Applies To
OAdvise, OClient, OConnection, OConnectionCollection, ODatabase, ODatabaseCollection, ODynaset, ODynasetMark, OField, OFieldCollection, OParameter, OParameterCollection, OSession, OSessionCollection, OValue, OAQ, OAQAgent, OAQMsg, OBfile, OBlob, OClob, OCollection, OException, OMDAttribute, OMetaData, OObject, ORef, OServer, OSnapshotID
Description
This method assigns one object to another.
Usage
OAdvise &OAdvise::operator =(const OAdvise &other)
OClient &OClient::operator =(const OClient &other)
OConnection &OConnection::operator =(const OConnection &other)
OConnectionCollection &OConnectionCollection::operator =(const OConnectionCollection &other)
ODatabase &ODatabase::operator =(const ODatabase &other)
ODatabaseCollection &ODatabaseCollection::operator =(const ODatabaseCollection &other)
ODynaset &ODynaset::operator =(const ODynaset &other)
ODynasetMark &ODynasetMark::operator =(const ODynasetMark &other)
OField &OField::operator =(const OField &other)
OFieldCollection &OFieldCollection::operator =(const OFieldCollection &other)
OParameter &OParameter::operator =(const OParameter &other)
OParameterCollection &OParameterCollection::operator =(const OParameterCollection &other)
OSession &OSession::operator =(const OSession &other)
OSessionCollection &OSessionCollection::operator =(const OSessionCollection &other)
OValue &OValue::operator =(const OValue &other)
OAQ &OAQ::operator =(const OAQ &other)
OAQAgent &OAQAgent::operator =(const OAQAgent &other)
OAQMsg &OAQMsg::operator =(const OAQMsg &other)
OBfile &OBfile::operator =(const OBfile &other)
OBlob &OBlob::operator =(const OBlob &other)
OClob &OClob::operator =(const OClob &other)
OException &OException::operator =(const OException &other)
OMDAttribute &OMDAttribute::operator =(const OMDAttribute &other)
OMetaData &OMetaData::operator =(const OMetaData &other)
OObject &OObject::operator =(const OObject &other)
OCollection &OCollection::operator =(const OCollection &other)
ORef &ORef::operator =(const ORef &other)
OServer &OServer::operator =(const OServer &other)
OSnapShotID &OSnapShotID::operator =(const OSnapShotID &other)
Arguments
other |
The object that is the source of the assignment. |
The assignment operator makes the object a copy of another object.
For the classes OAdvise, OClient, OConnection, OConnectionCollection, ODatabase, ODynaset, OField, OFieldCollection, OParameter, OParameterCollection, OSession, and OSessionCollection, a copied object becomes another handle that refers to the same underlying implementation object. Strings owned by the source object are not copied to the destination object (although the same information - such as database name and SQL statement - are available from the new object).
Note: For OField, what is being copied is not the value of the field, but the OField handle itself.
ODynasetMark and OValue are simpler objects. The data of the source object is simply copied.
If the object is already open, it is closed before the assignment. As a result, if the assignment fails, the return value of the operation will be a closed object.
The work that is done by assigning is the same as for a copy constructor.
OBinder and OBound have operator= defined in the header file, but the operator is not implemented. This is done so that the compiler's default implementation will not be used (it would be incorrect). If you want an assignment operator for your OBinder or OBound subclass, you must implement it.
Return Value
The object that was assigned to.
Example
An illustration of the meaning of assignment:
// open an ODatabase ODatabase odb("ExampleDB", "scott", "tiger"); // open an ODynaset ODynaset odyn(odb, "select ename, sal, comm from employees"); // get a field on sal and commission OField salfield = odyn.GetField("sal"); OField commfield = odyn.GetField("comm"); // declare some OValue variables OValue salval; OValue commval; // now look at the values of the first record odyn.GetFieldValue("sal", &salval); odyn.GetFieldValue("comm", &commval); // let us say that salval contains 5000 and commval contains 300 salval = bonusval; // assign commission value to salary // now salval contains 300 // can we do the same with OFields? NO! int isal = (int) salfield; // isal is now 5000 int ibonus = (int) commfield; // ibonus is now 300 salfield = commfield; // assign comm OField to salary OField // NOTE: we have only assigned the OField variable int isal2 = (int) salfield; // isal2 is 300 /* isal2 is 300 because salfield is now referring to the field "comm" in the record. */ // now update the record odyn.StartEdit() salfield.SetValue(4000); odyn.Update(); // we have just set the "comm" field to 4000, not the "sal" field