Oracle® Objects for OLE C++ Class Library Developer's Guide 10g Release 2 (10.2) Part Number B14308-01 |
|
Applies To
Description
OClob constructor
Usage
OClob(void) throw (OException)
OClob(ODatabase& odb, bool use_caching = false) throw(OException)
Arguments
Arguments |
Description |
---|---|
odb |
An initialized ODatabase providing the connection to the database where the CLOB will be created. |
use_caching |
Specifies whether Oracle uses caching when accessing this LOB. The default value is false. |
Remarks
This method constructs a new OClob instance.
If an ODatabase is passed into the constructor, a Temporary CLOB is created in the database.
Temporary LOBs are LOBs which do not exist permanently in the database. OO4O programmers most commonly use them to pass into stored procedures and functions which have LOB arguments.
Temporary LOBs do not require or take part in transactions. (It is not necessary to acquire a lock prior to writes, and rollbacks have no effect on temporary LOBs.)
The use_caching argument directs Oracle to use caching when accessing the temporary LOB. This is suggested when multiple accesses are expected on a single LOB. Caching is not required in the typical case, where a LOB is created, filled with data, passed to a stored procedure, and then discarded.
Temporary LOBs exist on the server until no more references to the corresponding OClob exist on the client. Please note that these references include any OParameter or OParamArray which contain a temporary OClob.