Oracle C++ Call Interface Programmer's Guide

Clob Class
Clob Class
The Clob class defines the common properties of objects of type CLOB. A CLOB is a
large character object stored as a column value in a row of a database table. A Clob
object contains a logical pointer to a CLOB, not the CLOB itself.
Methods of the Clob class enable you to perform specific tasks related to Clob
objects, including methods for getting the length of a SQL CLOB, for materializing a
CLOB on the client, and for extracting a part of the CLOB.
Methods in the ResultSet and Statement classes, such as getClob() and
setClob(), enable you to access an SQL CLOB value.
To create a null Clob object, use the syntax:
Clob();
The only methods valid on a null Clob object are setNull(), isNull(), and
operator=().
To create an uninitialized Clob object, use the syntax:
Clob(const Connection *connectionp);
An uninitialized Clob object can be initialized by:
■ The setEmpty() method. The CLOB can then be modified by inserting this
CLOB into the table and retrieving it using SELECT ... FOR UPDATE. The
write() method will modify the CLOB; however, the modified data will be
flushed to the table only when the transaction is committed. Note that an
insert is not required.
■ Assigning an initialized Clob object to it.
To create a copy of a Clob object, use the syntax:
Clob(const Clob &srcClob);
Summary of Clob Methods
Table 8–5 Clob Methods
Method Summary
append() on page 8-28 Append a CLOB at the end of the current CLOB.
8-26 Oracle C++ Call Interface Programmer’s Guide