DWCGdbSearchCond

定義


#include <dwc.h>

typedef struct DWCGdbSearchCond {
    char * filter;
    char * sort;
    int offset;
    int max;
    char * target_filter;
    int surrounding_num;
    int * ownerids;
    int ownerid_num;
    BOOL cache_flag;
} DWCGdbSearchCond;

説明

target_filter、surrounding_numを設定した場合、offsetとmaxは無視されます。

ownerids、ownerid_numを設定した場合、offset、target_filter、surrounding_numは無視されます。また、設定した値は考慮されませんが、sortには有効な文字列(例えばrecordid)を、maxには0以外の正の値(例えば1)を、設定して下さい。

unicodeフィールドの検索で、sort,target_filterを指定する場合、DWC_GdbUCS2ToUTF8Str関数を使うなどして、マルチバイトのUTF-8文字列で指定する必要があります。

filter SQLのWHERE句と同じ働きをします。NULLを指定した場合は指定しないことになります。
sort SQLのORDERBY句と同じ働きをします。NULLを指定した場合は指定しないことになります。
offset 検索結果の何番目から取得するか指定します。
max 検索結果を最大いくつ取ってくるか指定します。
target_filter surrounding_numを使用して周辺のレコードを取得するには、このフィルターをレコードが一つだけ検索されるように設定する必要があります。使用しない場合はNULLを与えることができます。
surrounding_num target_filterと組み合わせて使用します。1以上の数を指定すると、検索結果のレコードの上下指定個数ぶんのレコードを一緒に取得します。
ownerids 検索するレコードの作成者のプロファイルIDを配列として指定します。ownerid_numに0を指定した場合はNULLを与えることができます。
ownerid_num owneridsで指定した配列の長さを指定します。使用しない場合は0を入れてください。
cache_flag 検索結果をサーバでキャッシュするか否かを示します。キャッシュ期間は5分です。サーバの負荷を軽減するためにも、データの更新期間を短くしなければいけない場合を除いて、このフラグは有効にするようにしてください。

履歴

5.1pr2より前の変更履歴はこちら