Write Method

Applies To

Description

Writes a buffer into the OBlob or OClob value of this object and returns the total amount of the data written, in bytes for OBlob objects, and characters for OClob objects.

Usage

unsigned long Write(short *status, unsigned char *buffer, unsigned long buffersize, unsigned char piecetype = OLOB_ONE_PIECE, unsigned long offset = 0) const throw(OException)

unsigned long Write(unsigned char *buffer, unsigned long buffersize, unsigned char piecetype = OLOB_ONE_PIECE, unsigned long offset = 0) const throw(OException)

Arguments

Arguments	Description
status	Status of the current operation. Possible return values are: OLOB_NEED_DATA - There is more data to be written OLOB_NODATA - There is no data to be written usually due to an error condition OLOB_SUCCESS - Data written successfully
buffer	Pointer to user-supplied buffer.
buffersize	Size of the buffer. This is the number of bytes that will be written.
piecetype	An integer specifying which piece of the buffer is being written. Possible values include: OLOB_ONE_PIECE - buffer will be written in a single piece. This is the default. OLOB_FIRST_PIECE - buffer represents the piece of LOB data to be written. OLOB_NEXT_PIECE - buffer represents the next piece of LOB data to be written. OLOB_LAST_PIECE - buffer represents the last piece of LOB data to be written.
offset	1-based offset, in bytes, into the LOB to indicate where the writing will begin. The default value of zero causes the write to start at the beginning of the LOB in non-streaming mode or the value passed to EnableStreaming when in streaming mode.

Remarks

Either a row-level lock or object-level lock should be obtained before calling this method.

This method writes the LOB data from the offset and returns the number of bytes (Blobs/Bfiles) or characters (Clobs) written.

See the Remarks for EnableStreaming. See GetOptimumChunkSize for additional comments.

Examples

Example: Writing a Blob

Example: Writing a Clob