コールイン関数の使用法
ここでは、コールイン関数の概要を説明します。各関数の詳しい説明については、それぞれのリンクを参照してください。ここで説明するカテゴリは以下のとおりです。
-
プロセス・コントロール
これらの関数は、コールイン・セッションを開始し、停止します。また、このセッションに関連する各種設定を制御します。
-
関数とルーチン
これらの関数は、関数呼び出し、またはルーチン呼び出しを実行します。スタック関数は、関数参照またはルーチン参照をプッシュするために用意されています。
-
トランザクションとロック
これらの関数は、標準の InterSystems IRIS® トランザクション・コマンド (TSTART、TCOMMIT、および TROLLBACK) と LOCK コマンドを実行します。
-
オブジェクトの管理
これらの関数は、Oref カウンタを操作し、メソッド呼び出しを実行して、プロパティの取得、または設定を行います。スタック関数は、Oref、メソッド参照、プロパティ名に対しても含まれています。
-
グローバルの管理
これらの関数は、InterSystems IRIS で呼び出され、グローバルを操作します。関数は、グローバルを引数スタックにプッシュするために用意されています。
-
文字列の管理
これらの関数は文字列をある形式から別の形式に変換します。また、文字列引数のプッシュ、またはポップを行います。
-
単純なデータ型の管理
これらのスタック関数は、int、double、$list、または pointer 値を持つ引数のプッシュとポップに使用されます。
この後のセクションでは、個々の関数について詳しく説明します。
プロセス・コントロール
これらの関数は、コールイン・セッションの開始と停止、セッションに関連する各種設定の制御、ObjectScript コマンドや式を実行するための高レベルのインタフェースを提供します。
セッション制御
これらの関数は、コールイン・セッションを開始し、停止します。また、このセッションに関連する各種設定を制御します。
セッション制御関数
IrisAbort |
InterSystems IRIS に現在の要求を終了するように命令します。 |
IrisChangePasswordA[W][H] |
InterSystems 認証が使用されている場合、ユーザのパスワードを変更します。コールイン・セッションが初期化される前に呼び出される必要があります。 |
IrisContext |
$ZF コールバック・セッションにあるか、コールイン呼び出しの InterSystems IRIS 側にあるか、またはユーザ・プログラム側にあるかを示す整数を返します。 |
IrisCtrl |
InterSystems IRIS が CTRL-C を無視するかどうかを決定します。 |
IrisEnd |
InterSystems IRIS セッションを終了し、必要であれば、切断された接続を削除します (InterSystems IRIS 内での呼び出し)。 |
IrisEndAll |
すべてのコールイン・スレッドを切断し、そのスレッドが終了するまで待機します。 |
IrisOflush |
保留中の出力をすべてフラッシュします。 |
IrisPromptA[W][H] |
ターミナルである文字列を返します。 |
IrisSetDir |
実行時に、マネージャのディレクトリ (IrisSys\Mgr) の名前を動的に設定します。Windows では、InterSystems IRIS の共有ライブラリ・バージョンでこの関数が必要です。 |
IrisSignal |
ユーザ・プログラムによって検出されるシグナルを処理するために InterSystems IRIS に報告します。 |
IrisSecureStartA[W][H] |
InterSystems IRIS プロセスを開始します。 |
IrisStartA[W][H] |
(お勧めしません。代わりに、IrisSecureStart を使用してください) InterSystems IRIS プロセスを開始します。 |
ObjectScript の実行
これらの関数は、ObjectScript コマンドや式の実行に使用される高レベルなインタフェースを提供します。
ObjectScript コマンド関数
IrisExecuteA[W][H] |
ObjectScript コマンドを実行します (InterSystems IRIS 内での呼び出し)。 |
IrisEvalA[W][H] |
ObjectScript 式を評価します (InterSystems IRIS 内での呼び出し)。 |
IrisConvert |
IrisEval によって返された InterSystems IRIS 式の値を返します。 |
IrisType |
IrisEval で返される項目のデータ型を返します。 |
IrisErrorA[W][H] |
最新のエラー・メッセージ、関連するソース文字列、ソース文字列内でのエラーの発生箇所のオフセットを返します。 |
IrisErrxlateA[W][H] |
コールイン関数から返されたエラー番号に関連する InterSystems IRIS エラー文字列を返します。 |
関数とルーチン
これらの関数は InterSystems IRIS で呼び出され、関数呼び出し、またはルーチン呼び出しを実行します。関数は、関数参照またはルーチン参照を引数スタックにプッシュするために用意されています。
関数呼び出しおよびルーチン呼び出しを実行する関数
トランザクションとロック
これらの関数は、標準の InterSystems IRIS トランザクション・コマンド (TSTART、TCOMMIT、および TROLLBACK) と LOCK コマンドを実行します。
トランザクション
以下の関数は、標準の InterSystems IRIS トランザクション・コマンドを実行します。
トランザクション関数
ロック
これらの関数は、さまざまな形式で InterSystems IRIS LOCK コマンドを実行します。関数は、IrisAcquireLock 関数で使用する目的で引数スタックにロック名をプッシュするために用意されています。
ロック関数
オブジェクトの管理
これらの関数は、Oref カウンタを操作し、メソッド呼び出しを実行して、プロパティ値の取得、または設定を行うために、InterSystems IRIS 内で呼び出されます。スタック関数は、Oref、メソッド参照、プロパティ名に対しても含まれています。
Orefs
Oref 関数
メソッド
メソッド関数
プロパティ
プロパティ関数
グローバルの管理
これらの関数は、InterSystems IRIS で呼び出され、グローバルを操作します。関数は、グローバルを引数スタックにプッシュするために用意されています。
グローバルを管理するための関数
文字列の管理
これらの関数は文字列をある形式から別の形式に変換します。また、文字列引数のプッシュ、またはポップを行います。これらの文字列関数は、標準的な文字列および従来の短い文字列の両方で使用できます。ローカルの 8 ビット・エンコーディング、2 バイト Unicode、および 4 バイト Unicode 向きの関数が用意されています。
文字列関数
その他のデータ型の管理
以下の関数は、int、double、$list、または pointer などのデータ型の値を持つ引数をプッシュおよびポップして、ビット文字列内の指定されたビット値の位置を返すために使用されます。
その他のデータ型の関数