プログラムインターフェース
第0.43版 2016年10月23日
第0.03版 1996年 5月 3日
ここでは、プログラム中からプログラムを生成して実行させるインターフェースの
説明をします。
クラス名からクラスを表わす内部構造体を返します。
見つからない場合はnullを返します。
.headにクラス名が入っています。
-/"$subclass"/->でサブクラスをたどることができます。
al_gp("runtime_class", "A", null, nill, null)は runtime A と同じ意味です。
base_class_nameをベースクラスとしてclass_nameのクラスを追加します。
追加に成功するとnullが、それ以外は1が返ります。
class_nameのクラスを削除します。
戻り値（optがnullのとき）
null 削除に成功
1 class_nameが文字列でない
2 class_nameがクラスを表わしていない
3 クラスが参照されている
4 派生クラスを持っている
5 ルートクラスである
optが非nullのときは「参照されている/派生クラスを持っている」にかかわらず、
クラスが強制的に削除されます。
クラスにメンバー変数を追加します。
追加に成功するとnullが、それ以外は1が返ります。
クラスに関数void public_var()がなければ追加し、その中に
メンバー変数の参照を追加します。
クラスからメンバー変数を削除します。
削除に成功するとnullが、それ以外は1が返ります。
関数引数のプロトタイプを作成します。
関数func(integer i, string s)の場合なら以下のようにします。
var list arg_dcl;
arg_dcl = al_gp("add_to_arg_dcl", null, "integer", "i", null);
arg_dcl = al_gp("add_to_arg_dcl", arg_dcl, "string", "s", null);
クラスにstatic関数を追加します。
追加に成功するとnullが、それ以外は1が返ります。
クラスに関数void public_func()がなければ追加し、その中に
static関数の参照を追加します。
クラスからstatic関数を削除します。
戻り値
null 削除に成功
1 引数が文字列でない
2 class_nameがクラスを表わしていない
3 関数が見つからない
4 関数が参照されている
クラスにvirtual関数を追加します。
追加に成功するとnullが、それ以外は1が返ります。
クラスに関数void public_func()がなければ追加し、その中に
virtual関数の参照を追加します。
クラスからvirtual関数を削除します。
戻り値
null 削除に成功
1 引数が文字列でない
2 class_nameがクラスを表わしていない
3 関数が見つからない
4 関数が参照されている
クラスのメンバー関数public_var()から参照されているメンバー変数名の
コレクションを返します。
戻り値は、()-/-/=>メンバー変数名-/-/->var_dcl
var_dclはメンバー変数を表わす内部構造体。
クラスのメンバー関数public_func()から参照されているstatic関数の
プロトタイプのコレクションを返します。
戻り値は、()-/-/=>関数のプロトタイプ-/-/->func_dcl
func_dclはメンバー関数を表わす内部構造体。
クラスのメンバー関数public_func()から参照されているvirtual関数の
プロトタイプのコレクションを返します。
戻り値は、()-/-/=>関数のプロトタイプ-/-/->func_dcl
func_dclはメンバー関数を表わす内部構造体。
型を表わす内部構造体を文字列に変換します。
オブジェクトからそのオブジェクトのクラス名を得ます
プログラム中でプログラムを行うためのオブジェクトを作成します。
以後これをプログラミングイテレータと呼ぶことにします。
単位はメンバー関数単位です。
プログラミングイテレータを破壊します。
プログラミングイテレータが不要になった場合は必ずこれを行ってください。
これを行わないとメモリリークします。
プログラミングイテレータが指している関数の中身を空にします。
プログラミングイテレータの現在さしている行に
文字列strをプログラムのソースとして挿入します。
挿入に成功するとnullが、それ以外は1が返ります。
プログラミングイテレータとして使うときの関数です。
イテレータの指す場所を行番号lnoで指定される場所に持っていきます。
行番号は0から始まります。
プログラミングイテレータとして使うときの関数です。
まだソースがある場合は１が、ない場合はnullが返ります。
プログラミングイテレータとして使うときの関数です。
ソースの最後になったら非nullを返します。
プログラミングイテレータとして使うときの関数です。
イテレータの指す場所を１行前へ進めます。
プログラミングイテレータとして使うときの関数です。
現在のイテレータの指している場所の行番号を返します。
行番号は0から始まります。
lnoが負のときや最大行番号より大きい場合は
この関数の実行後イテレータはプログラムの最後を指します。
プログラミングイテレータとして使うときの関数です。
イテレータの現在指している行のソーステキストを返します。
引数なしのstatic関数を実行します。この実行は並列処理されます。
プロセスの生成に成功するとnullが返ります。
Altairでは、文字列の比較処理を高速化するため、内部で用いる文字列の値は
クイックソートしてあって、文字列の比較はアドレスを比較すればよいという
実装になっています。この関数は、文字列をクイックソートし、比較処理はアドレスを
比較すればよい文字列に文字列を変換します。
targetがクラスを表す文字列の場合、引数ありのstatic関数を実行します。
optは無視されます。
targetがAlObjectの派生クラスのオブジェクトの場合、targetを対象オブジェクトとして
引数ありの仮想関数を実行します。
実行に成功した場合は関数の戻り値が返ります。
実行に失敗した場合は、0x80000000が返ります。
optには仮引数宣言を入れます。
この関数は実行が終了するまで制御を放しません。
戻り値には関数の戻り値が返されます。
argsには以下のような形式で引数を与えます。
((arg_name, arg_value, null), ...)
arg_nameはal_gp("unique_str", ...);でアドレスを比較すればよいだけの文字列に
変換しておく必要があります。
クラスがclass_nameのオブジェクトを作成して返します。
al_gp("new", "AAA", null, null, null); は、new AAA; と同じ意味です。
バーチャル関数テーブルをアップデートします。
注: regist_class,regist_vfuncをしてもバーチャル関数テーブルは
アップデートされません。
regist_class,regist_vfuncで関数を加えた場合、
その関数を実行する前にこの関数を呼ぶ必要があります。
現在実行中のスタックフレームを返します。スタックフレームの形式は
((this_ptr, prog, arg_base, loc_base, ctrl_stack, func), chain)
となっています。
this_ptrは、virtual関数の対象オブジェクトです。static関数の場合はnullです。
progは、現在実行中のプログラムカウンタです。
arg_baseは、実引数リストのリンクトチェーンです。
loc_baseは、ローカル変数リストのリンクトチェーンです。
ctrl_stackは、現在実行中の関数の制御構造のリンクトチェーンです。
funcは、現在実行中の関数の関数宣言(arg_dcl)です。
chainは、ひとつ前のスタックフレームです。
現在実行中の関数名を返します。
現在実行中の関数の仮引数リストを返します。
形式は、al_gp("run2", ...)にそのまま渡せる形式です。
これで得られる値は、以下で得られるarg_dclと等価です。
var list func_stack, func_dcl, arg_dcl;
func_stack = al_gp("stack_frame", null, null, null, null);
func_dcl = func_stack.head.tail.tail.tail.tail.tail.head;
arg_dcl = func_dcl.tail.tail.tail.head;
現在実行中の関数の実引数リストを返します。
形式は、al_gp("run2", ...)にそのまま渡せる形式です。
仮引数リスト、実引数リストをシリアライズ可能な形に変え、
そのリストを返します。
シリアライズ可能な形から仮引数リストを復元しそれを返します。