没有任何

没有任何

此类没有公共构造函数。的实例 是 在操作准备阶段NdbBlob使用该方法创建的 。NdbOperation::getBlobHandle()（请参阅 第 2.3.20 节，“NdbOperation 类”。）此对象充当 blob 列的句柄。

下表列出了该类的公共方法以及每个方法的用途或用途：

getBlobTableName() 并且 getBlobEventName() 是静态方法。

大多数NdbBlob方法（几乎所有返回类型为 的方法int） 都会0在成功和-1失败时返回。

定义的公共类型 NdbBlob如下所示：

这是 , 的回调 NdbBlob::setActiveHook()，并在准备好的操作执行（但未提交）后立即调用。getValue()首先执行对或 的任何调用 setValue()。blob 句柄处于活动状态，因此 readData()可 writeData()用于操作 blob 值。用户定义的参数与 NdbBlob. setActiveHook() 在发生错误时返回一个非零值。

此方法初始化属于当前操作的 blob 列表，并返回列表中的第一个 blob。

NdbBlob* blobsFirstBlob
    (
      void
    )

没有。

指向所需 blob 的指针。

使用该方法获取使用初始化的 blob 列表中的下一个blobsFirstBlob()。请参阅NdbBlob::blobsFirstBlob()。

NdbBlob* blobsNextBlob
    (
      void
    )

没有。

指向所需 blob 的指针。

在提交或中止事务之前关闭 blob 句柄，同时释放内部资源。换句话说，这表明应用程序已完成从给定 blob 的读取。只有当 blob State为 Active.

int close
    (
      bool execPendingBlobOps = true
    )

此方法有一个布尔参数 execPendingBlobOps。如果此参数的值true（默认值），则在关闭 blob 句柄之前刷新所有挂起的 blob 操作。如果execPendingBlobOps 是false，则假定 blob 句柄没有要刷新的待处理读取或写入操作。

0 成功。

此方法获取 blob 事件名称。如果主事件监视 blob 列，则会创建 blob 事件。该名称包括主要事件名称。

static int getBlobEventName
    (
      char*       name,
      Ndb*        ndb,
      const char* event,
      const char* column
    )

此方法采用此处列出的四个参数：

0关于成功，-1关于失败。

该方法获取blob数据段表名。

此方法通常仅用于测试和调试目的。

static int getBlobTableName
    (
      char*       name,
      Ndb*        ndb,
      const char* table,
      const char* column
    )

此方法采用此处列出的四个参数：

0成功 返回，-1失败返回。

使用此方法获取 NdbBlob所属的 blob 列。

const Column* getColumn
    (
      void
    )

没有。

一个Column对象。

此方法获取 blob 的当前长度（以字节为单位）。

int getLength
    (
      Uint64& length
    )

参考长度。

blob 的字节长度。对于 NULLblob，此方法返回 0. 要区分长度为0blob 和 长度为 的 blob NULL，请使用 getNull()方法。

此方法检查 blob 的值是否为 NULL.

int getNull
    (
      int& isNull
    )

对整数的引用isNull。调用后，此参数具有以下值之一，解释如下：

没有。

使用此方法获取错误对象。该错误可能是特定于 blob 的，也可能是从失败的隐式操作中复制的。错误代码被复制回操作，除非操作已经有一个非零错误代码。

const NdbError& getNdbError
    (
      void
    ) const

没有任何。

一个NdbError对象。

此方法可用于查找与此句柄NdbBlob相关联的操作。

const NdbOperation* getNdbOperation
    (
      void
    ) const

没有。

指向操作的指针。

此方法返回的指针所引用的操作可以用 NdbOperation或 NdbScanOperation对象表示。

有关更多信息，请参阅第 2.3.20 节，“NdbOperation 类”和 第 2.3.24 节，“NdbScanOperation 类”。

此方法获取 blob 中的当前读/写位置。

int getPos
    (
      Uint64& pos
    )

一个参数，对位置的引用。

返回0成功或 -1失败。（在成功调用之后，pos将保留 blob 中的当前读/写位置，作为从头开始的字节数。）

NdbBlob此方法获取调用它 的对象的当前状态 。NdbBlob::State中描述了可能的状态 。

State getState
    (
      void
    )

没有任何。

类型的值 State。

使用此方法准备读取一个 blob 值；该值在调用后可用。用于 getNull()检查 NULL值；用于 getLength()获取 blob 的实际长度，并检查截断。 getValue()将当前读/写位置设置为读取数据末尾之后的点。

int getValue
    (
      void*  data,
      Uint32 bytes
    )

这个方法有两个参数。其中第一个是指向data要读取的指针；第二个是bytes 要阅读的数量。

0关于成功，-1关于失败。

此方法用于区分 blob 操作是基于语句还是基于事件。

void getVersion
    (
      int& version
    )

此方法采用单个参数，即对 blob 版本（操作类型）的整数引用。

以下三个值之一：

getVersion()总是成功的，假设它被调用为 的有效实例的方法NdbBlob。

此方法用于从 blob 中读取数据。

int readData
    (
      void*     data,
      Uint32&  bytes
    )

readData()接受一个指向 data要读取的指针，以及一个对bytes读取次数的引用。

0成功 返回，-1失败返回。调用成功后，data指向读取的数据，并bytes 保存读取的字节数。

此方法定义 blob 句柄激活的回调。到目前为止，准备好的操作队列将以无提交模式执行；然后，调用回调。有关其他信息，请参阅 NdbBlob::ActiveHook。

int setActiveHook
    (
      ActiveHook*  activeHook,
      void*        arg
    )

此方法需要此处列出的两个参数：

0关于成功，-1关于失败。

此方法将 blob 的值设置为 NULL。

int setNull
    (
      void
    )

没有。

0成功时；-1失败时。

此方法设置 blob 中读取或写入数据的位置。

int setPos
    (
      Uint64 pos
    )

setPos() 方法采用单个参数 pos（无符号 64 位整数），即读取或写入数据的位置。的值pos必须介于 0和 blob 的当前长度之间。

0关于成功，-1关于失败。

此方法用于准备插入或更新 blob 值。任何比新数据长的现有 blob 数据都将被截断。在操作执行之前，数据缓冲区必须保持有效。 setValue()将当前读/写位置设置为数据末尾之后的点。您可以设置data为空指针 ( 0) 以创建 NULL值。

int setValue
    (
      const void*  data,
      Uint32       bytes
    )

此方法采用此处列出的两个参数：

0关于成功，-1关于失败。

一个NdbBlob可以假设这些状态中的任何一个

下表显示了可能的值以及说明：

此方法用于将 blob 截断为给定长度。

int truncate
    (
      Uint64 length = 0
    )

truncate()采用单个参数，该参数指定length要将 blob 截断到的新值。length如果大于 blob 的当前长度（您可以使用 进行检查 ），则此方法无效 getLength()。

0关于成功，-1关于失败。

此方法用于将数据写入 NdbBlob. 成功调用后，读/写位置将位于写入 blob 的数据之后的第一个字节。

超过 blob 数据当前末尾的写入会自动扩展 blob。

int writeData
    (
      const void*  data,
      Uint32       bytes
    )

该方法有两个参数，一个指向 data要写入的指针和要写入的编号bytes。

0关于成功，-1关于失败。