msexitで呼び出され、プログラムの終了直前に実行されるプロシージャ をスタック上に配置します。mscleanに受け渡されるプロシージャは、 msexitが呼び出す最後から２番目のプロシージャです。

void   msclean (void (* proc) (void))

msclean (proc ());

なし。

この関数は、将来マルチスレッドをサポートするために、変更される予定である ことに注意してください。

この関数はスレッドセーフではありません。スレッドの内部で使用してはいけません。

この関数は、TEXT、NLSTEXT、BULK データタイプのフィールドに対して、データの挿入や更新の処理時間を改善するために 使用されます。

void   msdtfsta (msbool enable)

msdtfsta (enable);

なし。

msdtfstaを使用した場合、データをを保存するのに使用される バッファは、mraddまたはmrputが呼び出されるまで変更されない ことを保証しなくてはならないことに注意してください。

この関数は、プログラミング言語(mx,mr,プリコンパイラ) でのみ使用されるように意図されています。CREATE TABLE、 ALTER TABLEなどのような、任意のデータ定義言語(DDL)コマンドと共に使用 してはいけません。よってこの関数を、DDL文を実行するmscall関数と共に 使用してはいけません。

この関数は、プログラムを終了せずにクリーンアッププロシージャを呼び出します。

void   msend (void)

msend ();

なし。

なし。

この関数は、プログラムを終了する前に、msexitcleanupを呼び出し ます。そしてシェルに値を返します。

void   msexit (int value)

msexit (value);

なし。

msexitから呼び出される最終プロシージャは、ユーザプロシージャが スペースを解放したかをチェックします。解放されていない場合、警告メッセージを 出力します。

この関数はスレッドセーフではありません。スレッドの内部で使用してはいけま せん。

この関数は、プログラムを終了することなくクリーンアッププロシージャを 呼出します。

void msexitcleanup (void)

msexitcleanup ();

なし。

なし。

mscall、mx、mrルーチンの初期化を行います。

msbool   msinit (void)

msinit ();

成功した場合は、trueを返し、それ以外は、falseを返します。

なし。

mspsm_mallocで割付けられたスペースを解放します。

void   mspsm_free (char* space)

mspsm_free (space);

なし。

この関数は、パーシステント・ストアド・モジュール（PSM）内で使用されます。

この関数はスレッドセーフではありません。スレッドの内部で使用してはいけません。

パーシスタントストアドプロシージャ（PSM）内で、データを格納するスペース を割付けます。

void*   mspsm_malloc (int size)

space = mspsm_malloc (size);

パーシスタントストアドモジュール（PSM）内で使用する、割付けられたスペースのポインタ(void*)です。

Empress RDBMS内部で解放されるまで、スペースが割り付けられ続け ます。PSMの内部のスペースを解放する必要がある場合、Empressのmspsm_free 関数を使用します。

この関数はスレッドセーフではありません。スレッドの内部で使用してはいけま せん。

mspsm_mallocで割付けられたスペースサイズを変更します。

void*   mspsm_realloc (void* space, int size)

realloc_space = mspsm_realloc (space, size);

パーシスタントストアドプロシージャの内部で使用するために、割付けられた ポインタ(void*)です。

Empress RDBMS内部で解放されるまで、スペースが割り付けられ続け ます。

この関数はスレッドセーフではありません。スレッドの内部で使用してはいけま せん。

この関数はトリガプロシージャ内で使用され、対応する操作を異常終了させ ます。

void   mspsm_trig_abort_operation (void)

mspsm_trig_abort_operation ();

なし。

操作前にトリガが起動された場合には、操作は中止されます。

この関数はスレッドセーフではありません。スレッドの内部で使用してはいけま せん。

この関数はトリガプロシージャ内で、テーブル記述子とレコード記述の取得の ために使用されます。

void   mspsm_trig_get_record_info (void** pmr, 
                               void** poldrec, 
                               void** pnewrec)

mspsm_trig_get_record_info (pmr, poldrec, pnewrec);

なし。

1. 記述子のスペースは、システムによって割当て、解放が行なわれます。

2. この関数は、列トリガで実行されければなりません。 FOR EACH ROWオプションを指定しなくてはなりません。 詳細は、 Manual A4: Empress SQLリファレンスのCREATE TRIGGERを参照してください。

3. poldrecとpnewrecの有効性は、トリガのタイプに依存し ます。

   • UPDATEトリガは、既存のレコードpoldrecと新しいレコード pnewrecを参照することができます。
   • INSERTトリガは、新しいレコードを単に参照することができます。 古いレコードの値は意味がありません。
   • BEFORE DELETEトリガは、古いレコードを単に参照することができます。 新しいレコードの値は意味がありません。
   • AFTER DELETEトリガは、古いレコードも新しいレコードの値も意味が ありません。

4. この関数はスレッドセーフではありません。スレッドの内部で使用してはいけ ません。

テーブルにレコードを挿入します。失敗した場合は呼び出しプログラムを 終了します。

void   mradd (addr record_desc)

mradd (record_desc);

なし。

mraddを呼び出した後には、mraddendを呼び出しクリーン アップしてください。

グループの挿入を終了します。

void   mraddend (addr record_desc)

mraddend (record_desc);

なし。

なし。

この関数は、既存のオーバーフローファイル（.dtf）の中で、ユーザ に指定されたスペースを作成します。 mrbuktxtcrtの使用は入力された、データセグメントを保持するために ディスク上のスペースを準備するただ一つの方法です。 mrbuktxtcrtは、システムメモリをアロケートするのではありません。よって システムメモリよりも大きなデータセグメントを作成しても問題ありません。

割付けられたオーバーフロー.dtfエキステントは、null値が埋め込まれ ます。

long   mrbuktxtcrt (mrrdes* rec, mrades* mra, long size)

flag = mrbuktxtcrt (rec, mra, size);

失敗した場合、-1を返します。

なし。

このルーチンは、BULKまたはTEXTデータのバイト数を返し ます。

long   mrbuktxtlen(mrrdes* rec, mrades* mra)

flag = mrbuktxtlen (rec, mra);

成功した場合は、データのバイト長を返します。 失敗した場合は、-1を返します。これはフィールドが、BULKまたは TEXTデータタイプでない場合です。

フィールドがTEXT型で、Cスタイルのゼロ終端文字(\0)を保持している場合には、 返される長さには終端文字は含まれません。

データディクショナリーをクローズします。

void   mrcldict (void)

mrcldict (void);

なし。

なし。

テーブルをクローズします。ロックされていれば解放します。

void   mrclose (addr table_desc)

mrclose (table_desc);

なし。

なし。

フィールド値をファイルフォーマットの定数と比較します。mrcvt関数 群から返されるファイルフォーマット定数が使用されます。

int   mrcompare (addr record_desc, 
                 addr attr_desc, 
                 addr var_ptr)

result = mrcompare (record_desc, attr_desc, 
                    &var);

result = mrcompare (record_desc, attr_desc, 
                    mrcvt (attr_desc, string));

フィールド値が定数より小さい場合-1、等しい場合0、大きい場合1を返します。

なし。

可変長データの検索のために、上限と下限を設定するのに使用します。

void   mrcontrol (addr attr_desc, 
                  int lower_bound,
                  int upper_bound)

mrcontrol (attr_desc, lower_bound, 
           upper_bound)

なし。

なし。

フィールド値の内部フォーマット値を変数にコピーします。マシンに依存した コードを生成するので、特定のアプリケーション内で使用してください。

msbool   mrcopyi (addr record_desc, 
                  addr attr_desc,
                  addr var_ptr)

flag = mrcopyi (record_desc, attr_desc, &var);

値がNULLなら真(1)、その他は偽(0)。

この関数の使用は、移植性に乏しいコードを生成します。変数はフィールド値を 保存するのに適した型および長さが必要です。マシン上で各Empressデータタイプ が、どのように保存されるか知っておく必要があります。

レコードのフィールド値を、他のレコードにコピーします。この関数は通常 レコードの更新で使用されます。

void   mrcopyr (addr new_rec_desc, 
                addr old_rec_desc)

mrcopyr (new_rec_desc, old_rec_desc);

なし。

どちらのレコード記述子も、同一テーブルから取得したものでなくてはいけ ません。

外部フォーマットのフィールド値を、割付けられたスペースに割当てます。

msbool   mrcopyv (addr record_desc, 
                  addr attr_desc, 
                  char* space)

flag = mrcopyv (record_desc, attr_desc, 
                space);

フィールド値がnullでない場合は真(1)、nullの場合は偽(0)を返します。

TEXTまたはBULKデータタイプのフィールドに対する検索には 使用しないでください。

引数のポインタが、スペースの割付けが行なわれていない場合、mrcopyv () は呼出しプログラムを終了させます。

外部フォーマットのフィールド値を、ファイルフォーマット（公共バッファで） に変換します。

addr   mrcvt (addr attr_desc, char* string)

value = mrcvt (attr_desc, string);

変換が成功した場合、ファイルフォーマットのフィールド値へのポインタ (addr)を返します。それ以外はゼロポインタを返します。

他のmrルーチンの関数を呼び出した場合、変換された値を破壊して しまうのでファイルフォーマットを使用する直前にmrcvtを呼び出してくだ さい。

内部フォーマットのフィールド値を、ファイルフォーマット(準私用バッファ) に変換します。

addr   mrcvti (addr attr_desc, addr var_ptr)

value = mrcvti (attr_desc, var_ptr);

変換が成功した場合、ファイルフォーマットのフィールド値へのポインタ (addr)を返します。それ以外はゼロポインタを返します。

mrcvtiは、mrcvtvとバッファを共有するので、どちらかの 関数が呼び出されると、変換された値が破壊されます。

内部フォーマットのフィールド値を、ファイルフォーマット(準私用バッファ) に変換します。

addr   mrcvti2 (addr attr_desc, addr var_ptr)

value = mrcvti2 (attr_desc, var_ptr);

変換が成功した場合、ファイルフォーマットのフィールド値へのポインタ (addr)を返します。それ以外はゼロポインタを返します。

mrcvti2は、mrcvtv2とバッファを共有するので、どちらかの 関数が呼び出されると、変換された値が破壊されます。

内部フォーマットのフィールド値を、ファイルフォーマット(公共バッファ) に変換します。

addr   mrcvtin (addr attr_desc, addr var_ptr)

value = mrcvtin (attr_desc, var_ptr);

変換が成功した場合、ファイルフォーマットのフィールド値へのポインタ (addr)を返します。それ以外はゼロポインタを返します。

他のmrルーチンの関数を呼び出した場合、変換された値を破壊して しまうのでファイルフォーマットを使用する直前にmrcvtinを呼び出してくだ さい。

外部フォーマットのフィールド値を、ファイルフォーマットに変換します。

addr   mrcvtv (addr attr_desc, char* string)

value = mrcvtv (attr_desc, string);

変換が成功した場合、ファイルフォーマットのフィールド値へのポインタ (addr)を返します。それ以外はゼロポインタを返します。

mrcvtvは、mrcvtiとバッファを共有するので、どちらかの 関数が呼び出されると、変換された値が破壊されます。

外部フォーマットのフィールド値を、ファイルフォーマットに変換します。

addr   mrcvtv2 (addr attr_desc, char* string)

value = mrcvtv2 (attr_desc, string);

変換が成功した場合、ファイルフォーマットのフィールド値へのポインタ (addr)を返します。それ以外はゼロポインタを返します。

mrcvtv2は、mrcvti2とバッファを共有するので、どちらかの 関数が呼び出されると、変換された値が破壊されます。

テーブルからレコードを削除します。失敗した場合呼出しプログラムを終了 します。

void   mrdel (addr record_desc)

mrdel (record_desc);

なし。

レコードは、mrgetbeginを呼出しで指定され、mrgetが 呼出され検索されていなくてはなりません。 mrdelendは、一回以上のmrdelが呼出された後に、クリーンアップ のために呼出さなくてはなりません。

テーブルがdeferredモードでオープンされ、updateモードでロックされている 場合、この関数は失敗します。

テーブルからのレコード削除後にクリーンアップ処理を実行します。

void   mrdelend (addr record_desc)

mrdelend (record_desc);

なし。

なし。

表現の構築を終了します。用心して終了してください。誤った条件は表現を 構築する間に検知されます。(ファンクション／オペレータまたはアーギュメント／ オペランドの表現への追加関数の成功か失敗によって決定されます。） この関数の使用は、mreendの使用を排除します。

void   mreabort (void)

mreabort ();

なし。

なし。

表現の構築を始めます。これは内部データ構造を初期化します。

void   mrebegin (void)

mrebegin ();

なし。

表現を構築する場合、最初に呼び出さなくてはなりません。

表現にタイプtype_descのアーギュメント/オペランドを加えます。 一定のものは外部フォーマット(文字列)にあることに注意してください。 日付や10進のようなデータタイプを含む、他のデータタイプも表現できます。

msbool   mrecons (char* string, 
                  addr type_desc)

flag = mrecons (string, type_desc);

追加に成功した場合Trueを、それ以外はfalseを返します。

なし。

表現にデータタイプ変換オペレーターを追加します。

msbool   mrecvarg (addr type_desc)

flag = mrecvarg (type_desc);

変換が可能な場合Trueを、その他はfalseを返します。

なし。

表現の構築を終了し。記述子を返します。表現記述子が直接使用された場合 (mrerunの呼出しで)、必要がなくなったら、mrefreeを呼出して 記述子を解放しなくてはなりません。 表現が検索条件の中で使用される場合、記述子はEmpressによって自動的に 解放されます。

addr   mreend (void)

expr_desc = mreend ();

表現識別子へのポインタ(addr)を返します。

なし。

表現記述子を解放します。表現が必要なくなった場合には、呼出す必要があり ます。

void   mrefree (addr expr_desc)

mrefree (expr_desc);

なし。

なし。

ファンクションまたはオペレータを追加します。(例：Empressは、 ファンクション／オペレータを提供します。またユーザはEmpress SQLに ファンクション／オペレータを定義します。) ファンクション名、ファンクションの引数の数、引数のタイプは利用可能な引数と 照合されます。もし不当な場合には、表現の中には挿入されません。呼出しに失敗した 場合は、表現スタックに影響しません。

msbool   mrefunc (char* func, int nargs)

flag = mrefunc (func, nargs);

ファンクションの追加に成功した場合Trueを返し、それ以外はfalseを返します。

なし。

最も最近の変数に制御変数を関連させてください。mreivar が呼ばれた直後に、それは通常呼ばれます。 変数のパラメータモードがIN/INOUTである場合、制御変数は入力値を示すために使用 されます。変数のパラメータモードがOUT/INOUTである場合、制御変数は出力を示す ために使用されます。 制御変数のデータタイプは、Cデータタイプのlongです。変数を制御する ポインタはファンクションに渡されます。

制御変数の有効値を示します。

msbool   mreicvar (long* icvar)

flag = mreicvar (icvar);

成功したらTrue、その他はfalseを返します。

なし。

表現へ間接ポインタを使用して、アーギュメント／オペランド変数を追加し ます。表現が評価された場合、変数のカレントデータが表現で使用されます。 C変数のタイプは、データタイプ記述子にわたすのに使われます。Chapter 2 の"Data Type Correspondences"を参照してください。

void   mreivar (addr* ivar, addr type_desc)

mreivar (ivar, type_desc);

なし。

なし。

スタックに置かれた、アーギュメント／オペランドがNULLかチェック するファンクションを追加します。

msbool   mrenull (char* func)

flag = mrenull (func);

追加に成功したらTrueを返し、それ以外はfalseを返します。

なし。

表現にフィールドのアーギュメント／オペランドを追加します。 フィールドの値は表現が評価される時に指定されたレコードから得られます。

void   mrerecattr (addr record_desc, 
                   addr attr_desc)

mrerecattr (record_desc, attr_desc);

なし。

なし。

最終のエラー状態を示す文字列を返します。

char*   mrerrmsg (void)

string = mrerrmsg ();

最終のエラー状態を示すメッセージテキストへのポインタ(char*)。

エラー発生直後にmrerrmsgが呼出される必要があります。 他のmrの呼出しによってメッセージテキストが破壊される恐れがあります。

この関数はスレッドセーフではありません。スレッドの内部で使用しないでください。

表現式を実行し結果へのポインタを返します。結果の型は表現式の型と同一 です。この関数の呼出しの間に更新される参照変数またはフィールド値を持ちながら、 複数回呼出されることがあります。表現式が制限の一部である場合は、使用しては いけません。結果がC変数内に保存される場合は、変数は適切な型であることが 必要となります。Chapter 2 の"Data Type Correspondences"を参照してください。

addr   mrerun (addr expr_desc)

result = mrerun (expr_desc);

成功した場合は、結果へのポインタ(addr)を返し、それ以外は NILを返します。

なし。

mrspv、mrmalloc、mrreallocによって割当て られたスペースを解放します。

void   mrfree (char* space)

mrfree (space);

なし。

なし。

レコードを保存するために使用されるスペースを解放します。

void   mrfrrec (addr record_desc)

mrfrrec (record_desc);

なし。

なし。

フィールド記述子からフィールド名を取得します。

char*   mrganame (addr attr_desc)

name = mrganame (attr_desc);

指定されたフィールドの名前へのポインタ(char*)を返します。

なし。

フィールド記述子から、フィールドのデータタイプ記述子を取得します。

addr   mrgdtpar (addr attr_desc)

type_desc = mrgdtpar (attr_desc);

データタイプ記述子へのポインタ(addr)を返します。

なし。

テーブルからレコードを検索します。

msbool   mrget (addr retrieval_desc)

flag = mrget (retrieval_desc);

成功した場合true(1)、失敗した場合にはfalse (0)を返します。 例：全ての レコードが検索された場合。失敗した場合には、呼出しプログラムを終了します。 レコードがロックされている場合も呼出しプログラムは失敗します。

一回以上のmrgetが呼出された後は、mrgetendを呼出して クリーンアップしてください。

検索条件をレコードと関連付けます。失敗した場合は呼出しプログラムを終了 します。

addr   mrgetbegin (addr qual_desc, addr record_desc_1,
                   [ ... addr record_desc_n,] (addr)0)

retrieval_desc = mrgetbegin (qual_desc, record_desc_1,
                             record_desc_2, ...., ADDRNIL);

mrgetへ渡される検索記述子へのポインタ(addr)が 返されます。

複数のレコードを使用することは、直積またはジョインを意味します。 (mrgetを参照) よってレコード記述子は、異なったテーブル記述子から作成されます。 mrq関数の全てのフィールド記述子は、検索条件記述子 を生成するのに使用されます。

mrgetbeginに受け渡された検索条件記述子は、破壊され再使用できません。

テーブルからのレコード検索後のクリーンアップを行ないます。

void   mrgetend (addr retrieval_desc)

mrgetend (retrieval_desc);

なし。

なし。

内部フォーマットのフィールド値を持つ、バッファへのポインタを取得します。

addr   mrgeti (addr record_desc, 
               addr attr_desc)

result = mrgeti (record_desc, attr_desc);

内部フォーマットのフィールド値を持つ、バッファへのポインタ (addr)を返します。値はmrgetvsまたはmrgetiの呼出しに より破壊されますので、直ぐに使用するかバッファにコピーしてください。

後に使用するためにレコードのポインタを取得します。

long   mrgetptr (addr record_desc)

record_ptr = mrgetptr (record_desc);

レコード記述子が、現在参照しているレコードへのポインタ (long)を返します。

この関数は、テーブルと単純なVIEWにしか機能しません。

与えられたポインタが指しているレコードを取得します。

int   mrgetrec (addr record_desc, 
                long record_ptr)

flag = mrgetrec (record_desc, record_ptr);

成功なら真(1)を返し、失敗なら偽(0)を返します。またレコードがロックされて いる場合には、(-1)を返します。

なし。

フィールドのinteger値を検索します。

int   mrgetvi (addr record_desc, 
               addr attr_desc)

result = mrgetvi (record_desc, attr_desc);

integerのフィールド値を返します。

フィールド値をintegerに変換できない場合には、関数はエラーとなり呼出し プログラムを終了します。

外部フォーマットのフィールド値を含む、バッファへのポインタを取得します。

char*   mrgetvs (addr record_desc, 
                 addr attr_desc)

result = mrgetvs (record_desc, attr_desc);

外部フォーマットのフィールド値を含む、内部バッファへのポインタ (char*)を返します。

値は、mrgetvsまたはmrgetiの呼出しにより破壊されて しまうので、直ぐに使用するか、バッファにコピーしてください。

フィールドへの集計関数の結果を返します。

char*   mrgfunc (char* function, 
                 addr retrieval_desc,
                 addr record_desc, 
                 addr attr_desc)

value = mrgfunc (function, retrieval_desc, 
                 record_desc,
                 attr_desc);

関数の値へのポインタ(char*)を返します。レコードが存在しない場合 には、空のレコードが返されます。

mrgfuncを実行した後には、mrgetendを呼出して クリーンアップする必要があります。

フィールド番号iに対応する、フィールド記述子を取得します。

addr   mrigeta (addr table_desc, 
                int  attr_number)

attr_desc = mrigeta (table_desc, 
                     attr_number);

なし。

検索レコードにレコードレベルのロックを行います。

msbool   mrlkrec (addr record_desc)

flag = mrlkrec (record_desc);

成功した場合には、真(1)を返し、ロックできない場合には、偽(0)を返します。

この関数は、レコードレベルのロックがデータディクショナリーに設定されて いない場合には、実行されません。この場合関数は真(1)を返します。

アプリケーション実行中に、他からのアクセスを制御するためにテーブルを ロックします。

msbool   mrlktab (addr table_desc)

flag = mrlktab (table_desc);

成功した場合には真(1)を返し、ロックできない場合には偽(0)を返します。

テーブルのロックレベルがNULLの場合、mrlktabは機能しま せん。この場合関数は真(1)を返します。

Empress RDBMSで使用される、スペースを割付けます。

void*   mrmalloc (int size)

space = mrmalloc (size);

割付けられたスペースへのポインタ(void*)を返します。

mrfreeで解放するまで、スペースは割付けられたままです。

レコードを保存するために、スペースを割付けます。

addr   mrmkrec (addr table_desc)

record_desc = mrmkrec (table_desc);

レコード記述子へのポインタ(addr)。

レコード記述子のために割当てられたスペースは、 mrfrrecで解放しない限り、割当てられたままとなります。

レコードの指定フィールドに、C integer値を割当てます。失敗した場合、呼出しプログラムを終了します。

void   mrmptvi (addr record_desc, 
                addr attr_desc, 
                int value)

mrmptvi (record_desc, attr_desc, 
         integer);

なし。mrmptviが失敗した場合、呼出しプログラムは終了します。

なし。

レコード内の指定フィールドに値を割当てます。失敗時には呼出しプログラムを 終了します。

void   mrmptvs (addr record_desc, 
                addr attr_desc, 
                char* value)

mrmptvs (record_desc, attr_desc, value);

なし。mrmptvsが失敗した場合、呼出しプログラムは終了します。

なし。

コードを排他制御(mutex)するための開始位置を指定します。mrmutexlock() からmrmutexunlockの間は、スレッドセーフとなります。

void   mrmutexlock (void)

mrmutexlock () 

なし。

なし。

コードを排他制御(mutex)するための終了位置を指定します。mrmutexlock() からmrmutexunlockの間は、スレッドセーフとなります。

void   mrmutexunlock (void)

mrmutexunlock () 

なし。

なし。

フィールド名から、フィールド記述子を取得します。

addr   mrngeta (addr table_desc, 
                char* attr_name)

attr_desc = mrngeta (table_desc, attr_name);

成功した場合、フィールド記述子へのポインタ(addr)を返し、 失敗した場合(名前が不当な時)には、ゼロポインタを返します。

なし。

レコード全体がNULLであるかチェックします。

msbool   mrnullr (addr record_desc)

flag = mrnullr (record_desc);

レコード全体がNULLの場合には真(1)を返し、そうでない場合は偽(0) を返します。

なし。

レコード内のフィールド値が、NULLであるかチェックします。

msbool   mrnullv (addr record_desc, addr attr_desc)

flag = mrnullv (record_desc, attr_desc);

フィールド値がNULLの場合には真(1)を返し、そうでない場合は偽(0) を返します。

なし。

mrルーチンによる、内部アクセスのためにデータディクショナリーを オープンします。失敗した場合には、呼出しプログラムを終了します。

void   mropdict (char* database_name, 
                 char mode)

mropdict   (database_name, mode);

なし。

一般的にmropdictを呼出す場合、新しいファイルが生成されると、 データベース内のファイルを破壊する危険があるので、カレントディレクトリで 実行してはいけません。（データベースディレクトリ内でアプリケーションを実行 しないこと）readモードが指定されても、データディクショナリーテーブル に読込み許可を持っていない場合、またはupdateモードが指定されていても、 同じく更新許可を持っていない場合には、mropdictは失敗し、呼出し プログラムを終了します。

mrルーチンで使用するためにテーブルをオープンします。失敗した場合 には呼出しプログラムを終了します。 テーブルには、データディクショナリーに設定されているレベルでロックが設定され ます。テーブルレベルのロックが設定されていると、この関数によってテーブルは ロックされます。

addr   mropen (char* database_name, 
               char* table_name, 
               char mode) 

table_desc = mropen (database_name, 
                     table_name, mode);

成功した場合、テーブル記述子へのポインタ(addr)を返し ます。失敗した場合には、何も返さずに呼出しプログラムを終了します。

一般的にmropenを呼出す場合、新しいファイルが生成されると、 データベース内のファイルを破壊する危険があるので、カレントディレクトリで 実行してはいけません。（データベースディレクトリ内でアプリケーションを実行 しないこと）readモードが指定されても、データディクショナリーテーブル に読込み許可を持っていない場合、またはupdateモードが指定されていても、 同じく更新許可を持っていない場合には、mropenは失敗し、呼出し プログラムを終了します。

テーブルから、前のレコードを検索します。

msbool   mrprev (addr retrieval_desc)

flag = mrprev (retrieval_desc);

成功した場合は真(1)を返し、失敗した場合には偽(0)を返します。それは 全レコードが検索済みの場合です。 レコードがロックされている場合には、呼出しは失敗し呼出しプログラムは終了します。

mrprevが呼出されて後には、クリーンアップのためにmrgetendを呼出す必要があります。

エラーに応じてエラーメッセージを出力します。呼出しプログラムは終了 します。

void   mrprterr (void)

mrprterr ();

なし。

この関数はスレッドセーフではありません。スレッドの内部で使用しないでください。

レコードを更新します。

void   mrput   (addr new_rec_desc, 
                addr old_rec_desc)

mrput (new_rec_desc, old_rec_desc);

なし。

old_rec_descは、mrgetbeginとmrgetに よって、検索された更新前のレコードを指していなくてはなりません。 そうでないと、mrputは失敗します。

テーブルがdeferredモードでオープンされ、updateロックが設定できない場合 この関数は失敗します。

内部フォーマットの値をレコードのフィールドに割当てます。

msbool   mrputi (addr record_desc, 
                 addr attr_desc, 
                 addr var_ptr)

flag = mrputi (record_desc, attr_desc, 
               var_ptr);

成功した場合は真(1)を返し、フィールドに適した値に変換できなかった場合には 偽(0)を返します。

関数が偽(0)を返した場合、レコード記述子に指されたスペースの フィールド値が変更されないことを保証できません。この関数の使用は移植性の悪い プログラムを生成することになります。

レコード内のフィールドに、C integer値を割当てます。

msbool   mrputvi (addr record_desc, 
                  addr attr_desc, 
                  int value)

flag = mrputvi (record_desc, attr_desc, 
                integer);

成功した場合には真(1)を返し、フィールドに適した値に変換できない場合は 偽(0)を返します。

関数が偽(0)を返した場合、レコード記述子に指されたスペースの フィールド値が変更されないことを保証できません。

レコード内のフィールドに、外部フォーマットを割当てます。

msbool   mrputvs (addr record_desc, 
                  addr attr_desc, 
                  char* value)

flag = mrputvs (record_desc, attr_desc, 
                value);

成功した場合には真(1)を返して、フィールドに適した値に変換できなかった 場合は偽(0)を返します。

関数が偽(0)を返した場合、レコード記述子に指されたスペースの フィールド値が変更されないことを保証できません。

mrq関数のいずれかによって取得した、2つの検索条件記述子 にAND演算を実行します。

addr   mrqand (addr qual_desc_1, 
               addr qual_desc_2)

qual_desc = mrqand (qual_desc_1, qual_desc_2);

検索条件記述子へのポインタ(addr)。

mrqandは、引数内の検索条件記述子を破壊し、割当てた スペースを開放しますので、再使用できません。

フィールド値を他のフィールド値と比較します。

addr   mrqatr (char* operator, 
               addr attr_desc_1, 
               addr attr_desc_2)

qual_desc = mrqatr (operator, attr_desc_1, 
                    attr_desc_2);

検索条件記述子へのポインタ(addr)を返します。

比較される２つのフィールドには、互換性がなくてはなりません。ない場合には mrqatrは失敗します。

フィールド値をファイルフォーマットの定数と比較します。 mrcvt関数群の１つによって返されるファイルフォーマットへのポインタを 使用します。

addr   mrqcon (char* operator, 
               addr attr_desc, 
               addr var_ptr)

qual_desc = mrqcon (operator, attr_desc, &var);

qual_desc = mrqcon (operator, attr_desc, 
                    mrcvt (attr_desc, string));

検索条件記述子へのポインタ(addr)を返します。

なし。

与えられたパス名がEmpressデータベースかチェックします。

msbool   mrqdb (char* directory)

flag = mrqdb (directory);

ディレクトリがEmpressデータベースであれば真(1)を返し、 そうでなければ偽(0)を返します。

なし。

検索条件内に表現を配置します。この後mrgetbegin関数群で検索の 初期化を行なうために受け渡される検索条件記述子を返します。

addr   mrqexpr (addr expr_desc)

qual_desc = mrqexpr (expr_desc)

検索条件記述子へのポインタを返します。表現式の記述子が有効な表現式でない場合には、関数は失敗し呼出しプログラムを終了します。

フィールド値とC integer値を比較します。

addr   mrqieq (addr attr_desc, int integer)

qual_desc = mrqieq (attr_desc, integer);

検索条件記述子へのポインタ(addr)。

なし。

検索条件を先に検索されたレコードにします。

addr   mrqlst (addr table_desc, long array[])

qual_desc = mrqlst (table_desc, array);

なし。

フィールド値をパターンと比較します。

addr   mrqmch (char* operator, 
               addr attr_desc, 
               char* pattern)

qual_desc = mrqmch (operator, attr_desc, 
                    pattern);

検索条件記述子へのポインタ(addr)。

なし。

mrq関数群から返される、検索条件記述子にNOT演算 を実行し、その意味を逆転させます。

addr   mrqnot (addr qual_desc)

qual_desc = mrqnot (qual_desc);

検索条件記述子へのポインタ(addr)。

mrqnotは、引数の検索条件記述子を破壊し、割付けられた スペースを開放しますので、再利用はできません。

フィールド値とNULLを比較します。

addr   mrqnul (char* operator, addr attr_desc)

qual_desc = mrqnul (operator, attr_desc);

検索条件記述子へのポインタ(addr)。

なし。

mrq関数のいずれかによって取得した、2つの検索条件記述子 にOR演算を実行します。

addr   mrqor (addr qual_desc_1, 
              addr qual_desc_2)

qual_desc = mrqor (qual_desc_1, 
                   qual_desc_2);

検索条件記述子へのポインタ(addr)。

mrqorは、引数内の検索条件記述子を破壊し、割当てた スペースを開放しますので、再使用できません。

フィールド値を与えられた範囲と比較します。範囲の限界は、 ファイルフォーマット値へのポインタとして指定されます。 mrcvt関数群によって返されるポインタが使用されます。

addr   mrqrng (addr attr_desc, addr lower_limit, 
               char limit_type_1,  
               addr upper_limit, 
               char limit_type_2)

qual_desc = mrqrng (attr_desc, lower_limit, 
                    limit_type_1, upper_limit, 
                    limit_type_2);

qual_desc = mrqrng (attr_desc, 
                    mrcvtv (attr_desc, string_1), 
                    limit_type_1, 
                    mrcvtv2 (attr_desc, string_2), 
                    limit_type_2);

検索条件記述子へのポインタ(addr)。

なし。

フィールド値が文字列と等しいかチェックします。

addr   mrqseq (addr attr_desc, char* string)

qual_desc = mrqseq (attr_desc, string);

検索条件記述子へのポインタ(addr)。

文字列が正しいデータタイプのフィールド値に変換できない場合には、関数は 失敗し呼出しプログラムは終了します。

mrmallocで割付けられたスペースのサイズを変更します。

void*   mrrealloc (void* space, int size)

realloc_space = mrrealloc (space, size);

Empress RDBMSで使用する割付けられたスペースへのポインタ(void*)を 返します。

mrfreeで解放しない限り、スペースは割付けられたままです。

テーブルからのレコード検索を、再度行います。

int   mrreget (addr retrieval_desc)

flag = mrreget (retrieval_desc);

成功した場合には(1)を返し、全てのレコードを検索済みの場合には(0)、 レコードがロックされている場合は(-1)を返します。 関数が失敗した場合mroperr変数に、ヘッダーファイルmrerrno.hに リストされている、MRER...コードがセットされます。これにより失敗した 原因を調べることが可能です。

mrregetを呼出した後には、クリーンアップのためにmrgetend を呼出す必要があります。

テーブルからの前のレコード検索を、再度行います。

int   mrreprev (addr retrieval_desc)

flag = mrreprev (retrieval_desc);

成功した場合には(1)を返し、全てのレコードを検索済みの場合には(0)、 レコードがロックされている場合は(-1)を返します。 関数が失敗した場合mroperr変数に、ヘッダーファイルmrerrno.hに リストされている、MRER...コードがセットされます。これにより失敗した 原因を調べることが可能です。

mrreprevを呼出した後には、クリーンアップのために mrgetendを呼出す必要があります。

NULL値をレコード内の全てのフィールドに割当てます。

void   mrsetnr (addr record_desc)

mrsetnr (record_desc);

なし。

なし。

レコード内の指定されたフィールドにNULL値を割当てます。

void   mrsetnv (addr record_desc, addr attr_desc)

mrsetnv (record_desc, attr_desc);

なし。

なし。

外部フォーマットフィールド値を保存するために、スペースを割当てます。

char*   mrspv (addr attr_desc)

space = mrspv (attr_desc);

外部フォーマットのフィールド値を、保存するために割当てられるスペースへの ポインタ(char*)を返します。TEXTまたはBULK データタイプのフィールドに使用された場合は、ゼロポインタを返します。

mrfreeで解放しない限り、スペースは割付けられたままです。

この関数は、TEXTまたはBULKデータタイプのフィールドには 使用できません。

ソート出力するために、検索条件をレコードと関連付けます。失敗した場合は 呼出しプログラムを終了します。

addr   mrsrtbegin (addr qual_desc, char indicator,
                   addr record_desc_1, 
                   [ ... addr record_desc_n,] (addr)0,
                   addr attr_desc_1, char type, 
                   [ ... addr attr_desc_n, char type,]
                   (addr)0)

retrieval_desc = mrsrtbegin (qual_desc, indicator,
                    record_desc_1, record_desc_2, ... , ADDRNIL,
                    attr_desc_1, type, attr_desc_2, type, .... , 
                    ADDRNIL);

mrgetで使用する、検索記述子へのポインタ(addr)。

複数のレコードを使用することは、直積またはジョイン(mrgetを参照) を意味します。この場合、レコード記述子はは別々のテーブル記述子 から取得する必要があります。検索条件記述子の生成に使用されるmrq 関数内のすべての、フィールド記述子は、引数としてmrsrtbeginに 与えられるレコード記述子と一致する、テーブル記述子に属している 必要があります。そうでない場合関数は失敗します。

mrsrtbeginに渡された、検索条件記述子は破壊され、再使用でき ません。

データセグメントへの更新処理の開始を示します。

void   mrsubbegin (mrrdes* rec)

mrsubbegin (rec);

なし。

mrsubbeginは、部分的な更新のためにロック処理を行います。 この関数は、挿入または更新処理の中でmraddまたはmrputを 呼出す前に実行することを推奨します。 適切なロック処理を維持するには、mrsubbeginとmrsubend間で レコードに対し、部分的な更新処理を行なう必要があります。

データセグメントへの更新処理の終了を示します。

void   mrsubend (mrrdes* rec)

mrsubend (rec);

なし。

なし。

BULKまたはTEXTデータタイプのフィールドから、データの セグメントを取得します。

long   mrsubgeti (mrrdes* rec, mrades* mra, addr* buktxtint,
                  long offset, long size)

flag = mrsubgeti (rec, mra, buktxtint, offset, size);

失敗した場合-1を返します。

要求したデータセグメントが、全体のデータより小さい場合には、.dtf ファイルのチェックサムは行なわれません。 buktxtintはポインタのポインタであることに注意してください。

BULKまたはTEXTデータタイプのフィールドへの、データ セグメントの更新処理を向上させます。フィールドのデータ部を上書きします。

long   mrsubputi (mrrdes* rec, mrades* mra, 
                  addr buktxtint, long offset)

flag = mrsubputi (rec, mra, buktxtint, offset);

失敗した場合には、-1を返します。

なし。

テーブルにレコードを挿入します。挿入に成功したか失敗したか返します。 mrtaddは、フィールドにユニークインデックスが設定されている場合に使用 します。

msbool   mrtadd (addr record_desc)

flag = mrtadd (record_desc);

成功した場合には(1)を返し、失敗した場合には(0)を返します。関数が失敗 した場合mroperr変数に、ヘッダーファイルmrerrno.hにリスト されている、MRER...コードがセットされます。これにより失敗した原因を 調べることが可能です。

mrtaddを呼出した後は、mraddendを呼出してクリーンアップ する必要があります。

テーブルからレコードを削除します。失敗した場合呼出しプログラムを終了 しません。

msbool   mrtdel (addr record_desc)

flag = mrtdel (record_desc);

成功した場合には(1)を返し、失敗した場合には(0)を返します。関数が失敗 した場合mroperr変数に、ヘッダーファイルmrerrno.hにリスト されている、MRER...コードがセットされます。これにより失敗した原因を 調べることが可能です。

レコードは、mrgetbeginを呼出しで指定され、mrgetが呼出 され検索されていなくてはなりません。 mrdelendは、一回以上の mrtdelが呼出された後に、クリーンアップのために呼出さなくてはなりま せん。

テーブルからレコードを検索します。失敗した場合呼出しプログラムを終了 しません。

int   mrtget (addr retrieval_desc)

flag = mrtget (retrieval_desc);

成功した場合は(1)、全てのレコードが検索済みの場合は(0)、レコードがロック されている場合は(-1)を返します。関数が失敗した場合mroperr変数に、 ヘッダーファイルmrerrno.hにリストされている、MRER...コードが セットされます。これにより失敗した原因を調べることが可能です。

一回以上のmrtgetが呼出された後は、mrgetendを呼出して クリーンアップしてください。

フィールドへの集計関数の結果を返します。失敗した場合には、呼出し プログラムを終了しません。

char*   mrtgfunc (char* function, 
                  addr retrieval_desc, 
                  addr record_desc, 
                  addr attr_desc)

value = mrtgfunc (function, retrieval_desc,
                  record_desc, attr_desc);

関数の値へのポインタ(char*)を返します。アクセスするレコードが ない場合はCHARNILを返します。関数が失敗した場合mroperr変数に、 ヘッダーファイルmrerrno.hにリストされている、MRER...コードが セットされます。これにより失敗した原因を調べることが可能です。

mrtgfuncが呼出された後は、mrgetendを呼出して クリーンアップする必要があります。また、値はmrfreeによって解放する 必要があります。

検索条件をレコードと関連付けます。失敗した場合は呼出しプログラムを終了 しません。

addr   mrtgtbegin (addr qual_desc, addr record_desc_1, 
                   [ ... addr record_desc_n,] (addr)0)

retrieval_desc = mrtgtbegin (qual_desc, record_desc_1,
                             record_desc_2, .... , ADDRNIL);

対象レコードが検索可能な場合、mrgetへ渡される検索記述子 へのポインタ(addr)が返されます。その他の場合には(addr)0 (ADDRNIL)が返されます。関数が失敗した場合mroperr変数に、 ヘッダーファイルmrerrno.hにリストされている、MRER...コードが セットされます。これにより失敗した原因を調べることが可能です。

複数のレコードを使用することは、直積またはジョインを意味します。 (mrgetを参照) よってレコード記述子は、異なったテーブル記述子から作成されます。 mrq関数の全てのフィールド記述子は、検索条件記述子 を生成するのに使用されます。

mrgetbeginに受け渡された検索条件記述子は、破壊され再使用できません。

mrルーチンによる、内部アクセスのためにデータディクショナリーを オープンします。失敗した場合には、呼出しプログラムを終了しません。

msbool   mrtopdict (char* database_name, 
                    char mode)

flag = mrtopdict (database_name, mode);

成功した場合には(1)を返し、失敗した場合には(0)を返します。関数が失敗 した場合mroperr変数に、ヘッダーファイルmrerrno.hにリスト されている、MRER...コードがセットされます。これにより失敗した原因を 調べることが可能です。

一般的にmrtopdictを呼出す場合、新しいファイルが生成されると、 データベース内のファイルを破壊する危険があるので、カレントディレクトリで 実行してはいけません。（データベースディレクトリ内でアプリケーションを実行 しないこと）readモードが指定されても、データディクショナリーテーブル に読込み許可を持っていない場合、またはupdateモードが指定されていても、 同じく更新許可を持っていない場合には、mrtopdictは失敗し、 エラーを通知します。

mrルーチンで使用するためにテーブルをオープンします。失敗した場合 には呼出しプログラムを終了しません。 テーブルには、データディクショナリーに設定されているレベルでロックが設定され ます。テーブルレベルのロックが設定されていると、この関数によってテーブルは ロックされます。

addr   mrtopen (char* database_name, 
                char* table_name, 
                char mode)

table_desc = mrtopen (database_name, 
                      table_name, mode);

成功した場合、テーブル記述子へのポインタ(addr)を返し、 失敗した場合には、ゼロポインタを返します。関数が失敗した場合mroperr 変数に、ヘッダーファイルmrerrno.hにリストされている、MRER... コードがセットされます。これにより失敗した原因を調べることが可能です。

一般的にmrtopenを呼出す場合、新しいファイルが生成されると、 データベース内のファイルを破壊する危険があるので、カレントディレクトリで 実行してはいけません。（データベースディレクトリ内でアプリケーションを実行 しないこと）readモードが指定されても、データディクショナリーテーブル に読込み許可を持っていない場合、またはupdateモードが指定されていても、 同じく更新許可を持っていない場合には、mrtopenは失敗し、 エラーを通知します。

テーブルから、前のレコードを検索します。失敗した場合、呼出しプログラム を終了しません。

int   mrtprev (addr retrieval_desc)

flag = mrtprev (retrieval_desc);

成功した場合は(1)、全てのレコードが検索済みの場合は(0)、レコードがロック されている場合は(-1)を返します。関数が失敗した場合mroperr変数に、 ヘッダーファイルmrerrno.hにリストされている、MRER...コードが セットされます。これにより失敗した原因を調べることが可能です。

一回以上のmrtprevが呼出された後は、mrgetendを呼出して クリーンアップしてください。

レコードを更新します。失敗したか成功したか結果を返します。mrtput は、フィールドにユニークインデックスが設定されている場合に使用してください。

msbool   mrtput (addr new_rec_desc, 
                 addr old_rec_desc)

flag = mrtput (new_rec_desc, old_rec_desc);

成功した場合には(1)、失敗した場合には(0)を返します。関数が失敗した場合 mroperr変数に、ヘッダーファイルmrerrno.hにリストされている、 MRER...コードがセットされます。これにより失敗した原因を調べることが 可能です。

old_rec_descは、mrgetbeginとmrgetに よって、検索された更新前のレコードを指していなくてはなりません。 そうでないと、mrtputは失敗します。

フィールド値を他のフィールド値と比較します。失敗した場合には通知します。

addr   mrtqatr (char* operator, 
                addr attr_desc_1, 
                addr attr_desc_2)

qual_desc = mrtqatr (operator, attr_desc_1,
                     attr_desc_2);

検索条件記述子へのポインタ(addr)を返します。失敗した 場合には、ADDRNIL((addr)0)を返します。関数が失敗した場合 mroperr変数に、ヘッダーファイルmrerrno.hにリストされている、 MRER...コードがセットされます。これにより失敗した原因を調べることが 可能です。

比較される２つのフィールドには、互換性がなくてはなりません。ない場合には mrtqatrは失敗します。

フィールド値をファイルフォーマットの定数と比較します。失敗した場合には 通知します。mrcvt関数群の１つによって返されるファイルフォーマットへの ポインタを使用します。

addr   mrtqcon (char* operator, 
                addr attr_desc, 
                addr var_ptr)

qual_desc = mrtqcon (operator, attr_desc, 
                     &var);

qual_desc = mrtqcon (operator, attr_desc, 
                     mrcvt (attr_desc, string));

検索条件記述子へのポインタ(addr)を返します。失敗した 場合には、ADDRNIL (addr)0を返します。関数が失敗した場合 mroperr変数に、ヘッダーファイルmrerrno.hにリストされている、 MRER...コードがセットされます。これにより失敗した原因を調べることが 可能です。

なし。

フィールド値をパターンと比較します。失敗した場合には通知します。

addr   mrtqmch (char* operator, 
                addr attr_desc, 
                char* pattern)

qual_desc = mrtqmch (operator, attr_desc, 
                     pattern);

検索条件記述子へのポインタ(addr)を返します。失敗した場合 には、ADDRNIL((addr)0)を返します。関数が失敗した場合 mroperr変数に、ヘッダーファイルmrerrno.hにリストされている、 MRER...コードがセットされます。これにより失敗した原因を調べることが 可能です。

なし。

フィールド値とNULLを比較します。失敗した場合通知します。

addr   mrtqnul (char* operator, addr attr_desc)

qual_desc = mrtqnul (operator, attr_desc);

検索条件記述子へのポインタ(addr)を返します。失敗した 場合にがADDRNIL((addr)0)を返します。関数が失敗した場合 mroperr変数に、ヘッダーファイルmrerrno.hにリストされている、 MRER...コードがセットされます。これにより失敗した原因を調べることが 可能です。

なし。

フィールド値を与えられた範囲と比較します。失敗した場合には通知します。

addr   mrtqrng (addr attr_desc, 
                addr lower_limit, 
                char limit_type_1,
                addr upper_limit, 
                char limit_type_2)

qual_desc = mrtqrng (attr_desc, lower_limit, 
                     limit_type_1, upper_limit, 
                     limit_type_2);

qual_desc = mrtqrng (attr_desc, 
                     mrcvtv (attr_desc, string_1), 
                     limit_type_1, 
                     mrcvtv2 (attr_desc, string_2), 
                     limit_type_2);