Stream类

使用流来读取或写入流数据(通常是长数据)。

• 可读流 用于从存储过程调用的结果集或输出绑定变量获取流数据。可读流必须完全读取，直到达到数据的末尾，否则应该关闭它以丢弃任何不想要的数据。
• 可写流 用于向参数化语句(包括可调用语句)提供流数据(通常很长)。

readBuffer

从流中读取数据。size参数指定要读取的最大字节字符数。返回从流对象读取的数据量。-1表示流上的数据结束。

语法

virtual int readBuffer(

   char *buffer,

   unsigned int size) = 0;

参数	描述
buffer	指向数据缓冲区的指针；必须由调用者分配和释放。
size	指定要读取的字节数。

readLastBuffer

从流中读取最后一个缓冲区。它也可以称为顶部丢弃未读数据。size参数指定要读取的最大字节字符数。返回从流对象读取的数据量；-1表示流上的数据结束。

语法

virtual int readLastBuffer(

   char *buffer,

   unsigned int size) = 0;

参数	描述
buffer	指向数据缓冲区的指针；必须由调用者分配和释放。
size	指定要读取的字节数。

writeBuffer

将数据从缓冲区写入流。数据量由大小决定。

语法

virtual void writeBuffer(

   char *buffer,

   unsigned int size) = 0;

参数	描述
buffer	指向数据缓冲区的指针；必须由调用者分配和释放。
size	指定要读取的字节数。

writeLastBuffer

此方法将最后一个数据缓冲区写入流。也可以调用它来写入最后一块数据。写入的数据量由大小决定。

语法

virtual void writeLastBuffer(

   char *buffer,

   unsigned int size) = 0;

参数	描述
buffer	指向数据缓冲区的指针；必须由调用者分配和释放。
size	指定要读取的字节数。

status

返回当前状态。

语法

virtual Status status() const;