无

无

NdbScanFilter 提供了一种替代方法来指定扫描操作的过滤器。

由于此接口的开发仍在进行中，因此 NdbScanFilter 类的特性可能会在将来的版本中发生变化。

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

NdbScanFilter 类定义了两个公共类型

此方法用于启动复合条件，并指定用于对构成复合条件的条件进行分组的逻辑运算符。默认值为 AND。

int begin
    (
      Group group = AND
    )

Group 值：AND、OR、NAND 或 NOR 之一。有关更多信息，请参阅 NdbScanFilter::Group。

成功时为 0，失败时为 -1。

此类型表示基于将列值与某个任意值进行比较的条件，即边界条件。此类型的值为 cmp() 方法的第一个参数。

当与 COND_EQ、COND_NE、COND_LT、COND_LE、COND_GT 或 COND_GE 进行比较时，固定长度字符和二进制列值必须以列大小为前缀，并且必须填充到长度。对于在 COND_LIKE、COND_NOTLIKE、COL_AND_MASK_EQ_MASK、COL_AND_MASK_NE_MASK、COL_AND_MASK_EQ_ZERO 或 COL_AND_MASK_NE_ZERO 比较中使用的此类值，则不需要这样做。

使用 COND_LIKE 和 COND_NOTLIKE 比较的字符串可以使用模式元字符 % 和 _。有关更多信息，请参阅 NdbScanFilter::cmp()。

位运算比较运算符为 COL_AND_MASK_EQ_MASK、COL_AND_MASK_NE_MASK、COL_AND_MASK_EQ_ZERO 和 COL_AND_MASK_NE_ZERO。NdbInterpretedCode 和 NdbOperation 提供了相应的方法；有关这些方法的更多信息，请参阅 NdbInterpretedCode 位运算比较操作。

下表显示了可能的取值以及描述

此方法用于定义给定值与列值的比较。在 NDB 8.0 中，它也可以用于比较两个列。（此方法实际上并不执行比较，比较将在稍后执行扫描时完成，该扫描定义了此NdbScanFilter。）

在许多情况下，如果要比较的值是整数，则可以使用 NdbScanFilter 提供的几种便利方法来实现此目的。请参阅NdbScanFilter 整数比较方法。

int cmp
    (
      BinaryCondition condition,
      int columnId,
      const void* value,
      Uint32 length = 0
    )

此外，在 NDB 8.0 中

int cmp
    (
      BinaryCondition condition,
      int ColumnId1,
      int ColumnId2
    )

当用于将值与列进行比较时，此方法接受以下参数

当用于比较两个列时， cmp() 接受以下参数

使用此方法比较的列必须完全相同类型。这包括长度、精度、比例以及所有其他细节。

此方法返回一个整数：成功时返回 0，失败时返回 -1。

此方法用于定义列值与具有指定 ID 的参数值的比较。比较实际上是在执行定义此 NdbScanFilter 的扫描时完成的。

此方法是在 NDB 8.0.27 中添加的。

int cmp_param()
    (
      BinaryCondition condition,
      int colId,
      int paramId
    )

当用于将值与列进行比较时，此方法接受以下参数

使用此方法比较的值必须完全相同类型。这包括长度、精度、比例以及所有其他细节。

此方法返回一个整数：成功时返回 0，失败时返回 -1。

这是 NdbScanFilter 的构造函数，它创建一个该类的新的实例。

NdbScanFilter
    (
      class NdbOperation* op
    )

此方法接受一个参数，指向该过滤器适用的 NdbOperation 的指针。

NdbScanFilter 的新实例。

析构函数不接受任何参数，也不返回值。应调用它以在不再需要 NdbScanFilter 对象时将其删除。

此方法完成一个复合运算，表示没有更多条件要添加到其中。

int end
    (
      void
    )

无.

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

此方法用于对列值和整数执行相等性测试。

int eq
    (
      int    ColId,
      Uint32 value
    )

或者

int eq
    (
      int    ColId,
      Uint64 value
    )

此方法接受两个参数，如下所示

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

将当前组的项定义为 FALSE。

int isfalse
    (
      void
    )

无.

0 表示成功，-1 表示失败。

此方法用于检查列值是否不为 NULL。

int isnotnull
    (
      int ColId
    )

要测试其值的列的 ID。

如果列值不为 NULL，则返回 0。

此方法用于检查列值是否为 NULL。

int isnull
    (
      int ColId
    )

要测试其值的列的 ID。

如果列值为 NULL，则返回 0。

将当前组的项定义为 TRUE。

int istrue
    (
      void
    )

无.

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

此方法用于对列值和整数执行大于或等于测试。

此方法接受 32 位和 64 位值，如下所示

int ge
    (
      int    ColId,
      Uint32 value
    )


int ge
    (
      int    ColId,
      Uint64 value
    )

与 eq()、lt()、le() 以及此类型其他 NdbScanFilter 方法类似，此方法接受两个参数

0 表示成功；-1 表示失败。

由于在构建 NdbScanFilter 时遇到的错误不会传播到任何相关的 NdbOperation 对象，因此有必要使用此方法来访问错误信息。

const NdbError& getNdbError
    (
      void
    )

无.

指向 NdbError 的引用。

如果 NdbScanFilter 是使用 NdbOperation 构造的，则可以使用此方法获取指向该 NdbOperation 对象的指针。

NdbOperation* getNdbOperation
    (
      void
    )

无.

指向与此 NdbScanFilter 关联的 NdbOperation 的指针，如果有的话。否则，NULL。

此类型用于描述逻辑（分组）运算符，并与 begin() 方法一起使用。（请参阅NdbScanFilter::begin()。）

下表显示了可能的取值以及描述

此方法用于对列值和整数执行大于（严格上界）测试。

此方法适用于 32 位和 64 位值

int gt
    (
      int    ColId,
      Uint32 value
    )


int gt
    (
      int    ColId,
      Uint64 value
    )

与此类型其他 NdbScanFilter 方法类似，此方法接受两个参数

0 表示成功；-1 表示失败。

此方法用于对列值和整数执行小于或等于测试。

此方法有两个变体，用于适应 32 位和 64 位值

与此类型其他 NdbScanFilter 方法类似，此方法接受两个参数

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

此方法用于对列值和整数执行小于（严格下界）测试。

此方法有 32 位和 64 位变体，如下所示

int lt
    (
      int    ColId,
      Uint32 value
    )

int lt
    (
      int    ColId,
      Uint64 value
    )

与 eq()、ne() 以及此类型其他 NdbScanFilter 方法类似，此方法接受两个参数，如下所示

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

此方法用于对列值和整数执行不相等性测试。

此方法有 32 位和 64 位变体，如下所示

int ne
    (
      int    ColId,
      Uint32 value
    )

int ne
    (
      int    ColId,
      Uint64 value
    )

与 eq() 以及此类型其他 NdbScanFilter 方法类似，此方法接受两个参数

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

此方法重置 NdbScanFilter 对象，丢弃所有以前的过滤器定义和错误状态。

void reset
    (
      void
    )

无.

无.

传统上，在进行涉及 NULL 的比较时，NdbScanFilter 将 NULL 视为等于 NULL（因此认为 NULL == NULL 为 TRUE）。这与 SQL 标准的规定不同，SQL 标准要求任何与 NULL 的比较都返回 NULL，包括 NULL == NULL。

从 NDB 8.0.26 开始，可以通过调用此方法来覆盖此行为，此方法不带任何参数。这样做会导致创建的下一个 NdbScanFilter 对象在其整个生命周期内对所有操作采用符合 SQL 标准的 NULL 比较。一旦调用了 setSqlCmpSemantics()，就无法取消设置；调用 reset() 在这方面没有效果。此方法的效果仅限于要创建的下一个 NdbScanFilter 实例；除非事先调用 setSqlCmpSemantics()，否则任何后续实例都将使用传统的比较模式。

此方法对 NULL 排序没有影响；NdbScanFilter 始终认为 NULL 小于任何其他值。

void setSqlCmpSemantics
    (
      void
    )

无

无