無

無

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()。

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。

如果欄位值不是 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
    )

無

無