SAValueRead::setLongOrLobReaderMode

void setLongOrLobReaderMode( SALongOrLobReaderModes_t eMode ) const;

Sets Long or Lob data reading mode.

Parameters

eMode .    Can be one of the following SALongOrLobReaderModes_t enum values:

• SA_LongOrLobReaderDefault    Long or Lob(CLob) data reading mode is default (automatic).
• SA_LongOrLobReaderManual    Long or Lob(CLob) data reading mode is manual.

Remarks

SQLAPI++ Library provides two ways to read Long or BLob(CLob) object's value (usually SAField or SAParam object):

1. reading of Long or Lob data at once into an internal buffer (like ordinary string or binary values);
2. piecewise reading of Long or Lob data using user defined callback.

SA_LongOrLobReaderDefault reading mode used by default. 

If you want to control piecewise reading of Long or BLob(CLob) data you should call setLongOrLobReaderMode method and set SA_LongOrLobReaderManual reading mode for Long or BLob(CLob) parameters or fields you want to process with user defined callback. After that each fetch will skip reading Long and BLob(CLob) parameters that you set to be read manually. To read field or parameter defined to be read manually you should call ReadLongOrLob method for each of them after the fetch. ReadLongOrLob method will repeatedly call user defined callback declared by saLongOrLobReader_t typedef. To get more details about reading Long and BLob(CLob) data see SAField::ReadLongOrLob, SAParam::ReadLongOrLob methods and Query examples - Step 6 .

To check current object's data reading mode use LongOrLobReaderMode method.

Server specific notes

No specific information.

See also

SAValueRead::LongOrLobReaderMode , SAField::ReadLongOrLob, SAParam::ReadLongOrLob

SAField, SAParam

SALongOrLobReaderModes_t

Query examples - Step 6

Problems and Questions

If you haven't found the answer to your questions or have some problems on using the Library, please, send e-mail to howto@sqlapi.com.