PowerSORT Workstation V5.0 使用手引書

6.3.5 bsrtmrge関数

bsrtmrge関数は、bsrtopen関数でマージ機能を指定し、PowerSORTにマージするレコードを渡す場合、およびPowerSORTからマージ結果のレコードを受け取る場合に使用します。

■記述形式

#include "bsrt.h"
BSRTFUNC func; (注)
int func.bsrtmrge(BSPTR_BSRTREC rec);

注) funcはbsrtopen関数で指定したパラメタです。

■機能説明

以下にbsrtmrge関数の機能を示します。

• ユーザアプリケーションからPowerSORTにマージするレコードを渡します。
• PowerSORTからユーザアプリケーションにマージ結果のレコードが返却されます。
• ストリングの終わりをPowerSORTに通知します。ストリングとは、ソート済のレコードの集まりのことをいいます。
• マージ結果のレコードの終わりは、PowerSORTからユーザアプリケーションに通知されます。

■パラメタ詳細

◆BSPTR_BSRTREC rec

bsrtopen関数で指定したrecを指定します。なお、BSPTR_BSRTRECは、BSRTREC構造体のポインタを意味します。

■復帰値

bsrtmrge関数の復帰値を説明します。

復帰値	意味
0	正常にbsrtmrge関数が終了しました。
1	正常にbsrtmrge関数が終了しました。すべてのレコードを渡し終えたため、BSRTREC構造体のmgrec_addrとmgrec_lenに0を設定しました。
-1	bsrtmrge 関数の処理で異常が発生したことを示します。 BSRTREC構造体のerrdetailまたはsub_error_codeに詳細コードが設定されます。