53.2. 拡張性

キー（インデックス付けされる値ではありません）を比較し、0より小さい、0、または0より大きい整数を返します。 それぞれ、最初のキーが2番目のキーより、小さい、等しい、または大きいことを示します。

インデックス対象値に与えられるキーの配列を返します。 返されるキーの数は*nkeysに格納しなければなりません。

問い合わせ対象の値に与えられるキーの配列を返します。 つまり、queryはインデックス可能な演算子の右辺の値です。 この左辺はインデックス対象の列です。 nは演算子クラス内の演算子の戦略番号です（項35.14.2を参照）。 extractQueryはしばしば、queryのデータ型と抽出しなければならないキー値を決定するために、nを調べなければなりません。 返されるキーの数を*nkeysに格納しなければなりません。 問い合わせがキーを含んでいない場合、extractQueryは、演算子の意味合いによって*nkeysに0または-1を格納しなければなりません。 0は全ての値がqueryに一致し、完全インデックススキャンが行われることを意味します（しかし、項53.5を参照）。 -1は何もqueryに一致せず、インデックススキャンはすべて飛ばせることを意味します。 部分一致が提供されている場合、pmatchは使用する出力引数です。 使用するには、extractQueryが*nkeys論理値の配列を割り当て、そのアドレスを*pmatchに格納しなければなりません。 関連するキーが部分一致を必要とするとき、それぞれの配列要素は真に、そうでなければ偽に設定されなければなりません。 *pmatchがNULLに設定されていない場合、GINは部分一致が必要ないと想定します。 呼び出し前に変数はNULLに初期化されますので、この引数は部分一致が提供されていない演算子クラスでは、単に無視できます。 extra_dataは、extractQueryがconsistentとcomparePartialメソッドに追加データを渡すことができるようにする出力引数です。 使用するには、extractQueryが*nkeysポインタの配列を割り当て、そのアドレスを*extra_dataに格納し、そして望まれるものは何でも個別のポインタに格納しなければなりません。 変数は呼び出し前にNULLに初期化されますので、追加データを必要としない演算子クラスでこの引数は単に無視できます。 もし*extra_dataが設定されれば、配列全部がconsistentメソッドに、適切な要素がcomparePartialメソッドに渡されます。

インデックス付けられた値が戦略番号nを持つ問い合わせ演算子を満たす（または、recheck印が返されたときはたぶん満たすかもしれない）場合に真を返します。 check配列は長さnkeysであり、このqueryデータに対して事前に行われたextractQueryが返したキーの数と同じです。 インデックス対象値が対応する問い合わせキーを持つ場合、check配列の各要素は真です。 つまり、(check[i] == TRUE)の場合、extractQueryの結果配列のi番目のキーがインデックス対象値内に存在します。 元のqueryデータ（抽出されたキー配列ではありません）は、consistentメソッドがそれを調査する必要がある場合に、渡されます。 extra_dataはextractQueryにより返された追加データ配列で、ない場合はNULLです。 成功の場合、*recheckはヒープタプルが問い合わせ演算子に対し再検査を必要とすれば真で、インデックス検査が的確であれば偽です。

問い合わせとインデックスキーの部分一致を比較します。 符号が結果を示す整数が返ります。 ゼロ未満はインデックスキーは問い合わせに一致しないが、インデックススキャンを続けるべきであることを示します。 ゼロはインデックスキーが問い合わせに一致することを示します。 ゼロより大きな値はこれ以上の一致はありえないためインデックススキャンを停止すべきであることを示します。 スキャンをいつ停止するかを決めるためにセマンテックスが必要とされる場合、部分一致問い合わせを生成した演算子の戦略番号nが提供されます。 またextra_dataはextractQueryで作成される追加データ配列の対応する要素、もしなければNULLです。