6.4.4 bsrtget関数

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

記述形式

#include <bsort/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に設定されます。

パラメタ詳細

以下では、bsrtget関数のパラメタについて説明します。

rec

bsrtopen関数で指定したrecを指定します。

参考

BSPTR_BSRTRECは、BSRTREC構造体のポインタを意味します。

復帰値

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

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