PowerSORT Workstation V5.0 使用手引書

6.3.1 bsrtopen関数

bsrtopen関数は、PowerSORTのダイナミックリンクライブラリ(DLL)を仮想記憶域にロードし、各関数のアドレスをパラメタfuncに設定します。さらにPowerSORTの実行環境を準備します。

■記述形式

#include "bsrt.h"
int bsrtopen (long int BSRTVL, BSPTR_BSRTFUNC func,
　　　　　　　BSPTR_BSRTPRIM prim, BSPTR_BSRTREC rec,
　　　　　　　BSPTR_BSRTKEY key, BSPTR_BSRTFILE file,
　　　　　　　BSPTR_BSRTOPT opt);

■機能説明

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

• PowerSORTの実行環境を構築します。
• 入力にファイル(標準入力を含む)、出力にユーザアプリケーションを使用する場合、ソート機能のときはソート処理を行い、結果を出力する直前に復帰します。マージ機能のときはそれぞれのファイルから少しずつレコードを入力し、マージ処理をする直前に復帰します。
• 入出力ともファイル(標準入力、標準出力を含む)を指定した場合は、ソート処理またはマージ処理まで実施して復帰します。
• コピー機能の場合は、コピー処理を実施して復帰します。

■パラメタ詳細

◆long int BSRTVL

PowerSORTのバージョンレベル(BSRTVL)を指定します。
BSRTVLはBSORT関数のヘッダファイル(bsrt.h)で定義されています。このパラメタにより、BSORT関数のインタフェースに変更があってもユーザアプリケーションを変更することなく動作させることができます。

◆BSPTR_BSRTFUNC func

BSORT関数(bsrtput関数、bsrtget関数およびbsrtmrge関数)の各アドレスが設定されます。なお、BSPTR_BSRTFUNCは、BSRTFUNC構造体のポインタを意味します。

◆BSPTR_BSRTPRIM prim

ソート機能、マージ機能、コピー機能、レコード選択機能、レコード再編成機能、先入力先出力(FIFO)機能、レコード集約機能およびサプレス機能などを指定するパラメタです。なお、BSPTR_BSRTPRIMは、BSRTPRIM構造体のポインタを意味します。

◆BSPTR_BSRTREC rec

bsrtopen関数で指定する情報はありません。エラーがあった場合、その詳細コードが設定されます。なお、BSPTR_BSRTRECは、BSRTREC構造体のポインタを意味します。

◆BSPTR_BSRTKEY key

ソート機能またはマージ機能で使用するキーフィールドを指定します。なお、BSPTR_BSRTKEYは、BSRTKEY構造体のポインタを意味します。

◆BSPTR_BSRTFILE file

入力ファイル、出力ファイルおよび一時ファイルなどファイル情報を指定するパラメタです。なお、BSPTR_BSRTFILEは、BSRTFILE構造体のポインタを意味します。

◆BSPTR_BSRTOPT opt

オプション機能を指定するパラメタです。集約フィールド、選択フィールド、再編成フィールドおよび読み飛ばしレコード件数を指定する各構造体のポインタを指定します。
上記の構造体のポインタをいずれも指定しない場合は、bsrtopen関数のパラメタoptに0を指定します。いずれかを指定する場合は、それぞれ領域を確保した上で指定します。なお、BSPTR_BSRTOPTは、BSRTOPT構造体のポインタを意味します。

■復帰値

bsrtopen関数の復帰値を示します。

復帰値	意味
0	正常にbsrtopen関数が終了したことを示します。 続けて、bsrtput関数、bsrtget関数、bsrtmrge関数またはbsrtclse関数を発行してください。
-1	bsrtopen関数で異常が発生したことを示します。詳細な情報は、BSRTREC構造体のerrdetailまたはsub_error_codeに設定されます。 続けて、bsrtclse関数を発行してください。
-2	bsrtopen関数で異常が発生したことを示します。詳細な情報は、BSRTREC構造体のerrdetailまたはsub_error_codeに設定されます。 なお、当復帰値の場合は、bsrtclse関数を発行する必要はありません。

• BSRTVLを除いた他のパラメタは、値を設定しない場合でもbsrtopen関数発行前に0クリアする必要があります。値を設定するパラメタは、設定前にフィールドを0クリアします。
• bsrtopen関数のパラメタのうち、BSRTVL、func、prim、recは省略できません。key、file、optは省略できます。省略する場合は、bsrtopen関数のパラメタでポインタに0を指定します。
  例)

  bsrtopen( BSRTVL,func, prim, rec,
  　　　　(BSPTR_BSRTKEY) 0, (BSPTR_BSRTFILE) 0,
  　　　　(BSPTR_BSRTOPT) 0);