没有任何

没有任何

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使用and 比较的字符串COND_NOTLIKE可以使用模式元字符%and _。有关详细信息，请参阅 NdbScanFilter::cmp()。

BIT比较运算符是 , 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。

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

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

int isnull
    (
      int ColId
    )

要测试其值的列的 ID。

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

将当前组的一个术语定义为 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
    )

没有。

指向 NdbOperation与 this 关联的指针NdbScanFilter（如果有的话）。否则，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 标准指定的不同，后者要求与 NULLreturn进行任何比较NULL，包括NULL == NULL.

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

该方法对NULL 排序没有影响；NdbScanFilter总是被认为 NULL小于任何其他值。

void setSqlCmpSemantics
    (
      void
    )

没有任何

没有任何