Applies To
OField,
OParameter
OValue
Description
This method returns the object's value as a string.
Usage
operator const char *() const
Remarks
This methods hands the value of the object back to the caller as a
null-terminated string. If the object's current value is not a string, the method attempts
to convert the value to a string. This can fail, resulting in the return of a
NULL pointer.
The actual memory to which the returned pointer points is managed by the
object. It should not be freed by the caller; it will be freed when the object is
destroyed or closed or when another const char * cast is made.
Return Value
A valid, null-terminated const char pointer on success; NULL on failure.
Example
This example deletes all managers. We determine which employees are managers
by casting the job field to a string.
// open the database
ODatabase odb("ExampleDB", "scott", "tiger");
// open a dynaset on the employee table
ODynaset empdyn(odb, "select * from emp");
// get an OField object for looking at the job field
OField job = empdyn.GetField("job");
// look through all the employees
while (!empdyn.IsEOF())
{
if (0 == strcmp((const char *) job, "MANAGER"))
{ // we found a manager; delete that employee
empdyn.DeleteRecord();
}
// go to next record (gets us to valid record)
// or past EOF if there are no more records
empdyn.MoveNext();
}