Interstage Shunsaku Data Manager アプリケーション開発ガイド - Microsoft(R) Windows(R) 2000/ Microsoft(R) Windows Server(TM) 2003 - - UNIX共通 -

11.2.2.1 条件に一致するXML文書の件数を取得する

条件に一致するデータを取り出す前に、件数のみ取得したい場合があります。

このような場合、ShunGetHitCount関数の引数に条件式を指定して、件数のみを取得します。

条件に一致するXML文書の件数を取得する場合の流れについて、以下の図に示します。

[図:条件に一致するXML文書の件数を取得する場合の流れ]

■記述例

SHUNHSTMT StmtH;
/* データ操作ハンドルの割当て */
ShunAllocHandle(ConH, &StmtH);                            (1)
/* 検索式を指定してヒット件数を取得 */
ShunGetHitCount(StmtH,                               
"/document/base/prefecture == '大阪'",
           &Hit_Cnt);                                     (2)

/* ヒット件数の取出し */
printf("ヒット件数              = %d\n", Hit_Cnt);

/* データ操作ハンドルの解放 */
ShunFreeHandle(StmtH);                                    (3)

◆(1) データ操作ハンドルの割当て

事前にデータ操作ハンドルを割り当てます。データ操作ハンドルは、ShunAllocHandle関数に、親ハンドルとなるコネクションハンドルを指定して割り当てます。

◆(2) 検索の実行

ShunGetHitCount関数のパラメタに、データ操作ハンドル、検索式を指定して検索を実行します。ヒット件数のみを返却します。

◆(3) データ操作ハンドルの解放

データの検索および結果の取出しが完了したら、ShunFreeHandle関数でデータ操作ハンドルを解放します。