PowerSORT Workstation V5.0 使用手引書

6.3.4 bsrtget関数

bsrtget関数は、bsrtopen関数でソート機能を指定し、かつPowerSORTからソート結果のレコードを受け取る場合に使用します。

■記述形式

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

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

■機能説明

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

• PowerSORTからレコードまたはレコード群を受け取ります。
• レコードまたはレコード群の終わりをPowerSORTから通知されます。

◆返却されるレコード群の形式

個々のレコードを連続した領域に並べて返却します。
固定長レコード形式の場合は、先頭レコードのアドレスがBSRTREC構造体のrec_addrに、レコード群の長さ(レコード長のレコード件数倍)がBSRTREC構造体のrec_lenに設定されます。
可変長レコード形式の場合は、各レコードの先頭にレコード長を格納した領域(long型)を持つ形式で、先頭レコードのアドレスがBSRTREC構造体のrec_addrに、レコードとレコード長の領域を累積した長さがBSRTREC構造体のrec_lenに設定されます。
テキストファイルのレコードの場合は、改行文字を含めたレコードを連続した領域に並べて返却します。先頭レコードのアドレスがBSRTREC構造体のrec_addrに、返却するレコードの累積した長さがBSRTREC構造体のrec_lenに設定されます。

■パラメタ詳細

◆BSPTR_BSRTREC rec

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

■復帰値

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

復帰値	意味
0	正常にbsrtget関数が終了しました。
1	正常にbsrtget関数が終了しました。すべてのレコードを渡し終えたため、BSRTREC構造体のrec_addrとrec_lenに0を設定しました。 通常の処理では、bsrtget関数の復帰値が1になるまでbsrtget関数を繰返し発行してください。
-1	bsrtget関数の処理で異常が発生したことを示します。BSRTREC構造体のerrdetailまたはsub_error_codeに詳細コードが設定されます。