Skip Headers
Oracle® Objects for OLE C++ Class Library Developer's Guide
10g Release 2 (10.2)

Part Number B14308-01
Go to Documentation Home
Home
Go to Book List
Book List
Go to Table of Contents
Contents
Go to Index
Index
Go to Master Index
Master Index
Go to Feedback page
Contact Us

OClob Method

Applies To

OClob

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.