emueraリファレンス_関数
差分
このページの2つのバージョン間の差分を表示します。
| emueraリファレンス_関数 [2026/07/02 14:12] – 作成 - 外部編集 127.0.0.1 | emueraリファレンス_関数 [2026/10/03 19:15] (現在) – 外部編集 127.0.0.1 | ||
|---|---|---|---|
| 行 1: | 行 1: | ||
| - | ---- | + | ~~NOTOC~~ |
| + | このページの内容は[[erabasicリファレンス_ゲームの実行・処理の流れ# | ||
| + | |||
| + | [[erabasicリファレンス|リファレンストップ]] · [[erabasicリファレンス_総索引|名前の総索引]] | ||
| ====== 関数 ====== | ====== 関数 ====== | ||
| + | [[erabasicリファレンス_ゲームの実行・処理の流れ# | ||
| + | |||
| ===== @EVENTLOAD ===== | ===== @EVENTLOAD ===== | ||
| - | データをロードした直後に呼び出されます。\\ | + | [[erabasicリファレンス_ゲームの実行・処理の流れ# |
| - | イベント関数なので複数定義することができます。\\ | + | |
| - | @EVENTLOADが定義されていない場合、@SHOW_SHOPへ移行します(eramakerと同じ動作)\\ | + | |
| ===== @TITLE_LOADGAME ===== | ===== @TITLE_LOADGAME ===== | ||
| - | 標準のタイトル画面でロードを選択した場合に呼び出されます。\\ | + | [[erabasicリファレンス_ゲームの実行・処理の流れ# |
| - | @TITLE_LOADGAMEを定義することでタイトルでも独自のロード画面を使用することができます。\\ | + | |
| - | 定義されていない場合、標準のロード画面が使用されます。\\ | + | |
| - | @SYSTEM_TITLEを定義した場合、明示的にCALLしない限り@TITLE_LOADGAMEが呼ばれることはありません。\\ | + | |
| ===== @SYSTEM_AUTOSAVE ===== | ===== @SYSTEM_AUTOSAVE ===== | ||
| - | オートセーブが行われるタイミングで呼び出されます。\\ | + | [[erabasicリファレンス_ゲームの実行・処理の流れ# |
| - | オートセーブの内容を独自に定めることができます。\\ | + | |
| - | 定義されていない場合、標準のセーブ機能が使用されます。\\ | + | |
| ===== @SYSTEM_TITLE ===== | ===== @SYSTEM_TITLE ===== | ||
| - | csvのロードが終了したタイミングで呼び出されます。\\ | + | [[erabasicリファレンス_ゲームの実行・処理の流れ# |
| - | また、BEGIN TITLEによっても呼び出されます。\\ | + | |
| - | @SYSTEM_TITLEを定義することで独自のタイトル画面を使用することができます。\\ | + | |
| - | 定義されていない場合、標準のタイトル画面が使用されます。\\ | + | |
| ===== @CALLTRAINEND ===== | ===== @CALLTRAINEND ===== | ||
| - | CALLTRAINによる自動実行が終了後、システム内部から自動的に呼び出される関数です。\\ | + | [[erabasicリファレンス_ゲームの実行・処理の流れ# |
| - | イベント関数ではないため多重定義できないことに注意してください。\\ | + | |
| ===== 自作関数における引数指定 ===== | ===== 自作関数における引数指定 ===== | ||
| - | ※1.54uまでと1.60以降で仕様が異なります!※\\ | + | [[erabasicリファレンス_関数の定義・呼び出し# |
| ==== 書式 ==== | ==== 書式 ==== | ||
| - | =|BOX|\\ | + | [[erabasicリファレンス_関数の定義・呼び出し# |
| - | 関数側\\ | + | |
| - | @(関数名), | ||
| - | 引数は数値ならARG(: | ||
| - | 関数中で# | ||
| - | | | = | | ||
| - | =|BOX|\\ | ||
| - | 呼び出し側\\ | ||
| - | CALL (関数名), | ||
| - | | | = | | ||
| - | 数値は数式または文字列式が使用できます。\\ | ||
| - | 文字列リテラル(定数)を引数にするときは"" | ||
| - | 書式付の文字列リテラルを引数にするときは@" | ||
| - | CALL以外にJUMP、CALLFORM、TRYCALLなどでも同じ書式が使えます。\\ | ||
| - | 関数側の引数はいくつでも指定できます。\\ | ||
| - | ver1.808現在、関数側と呼び出し側で型が異なる場合、数値から文字列、文字列から数値に関わらず変換せずエラーになります。\\ | ||
| - | ver1.807以前と同様に文字列型の引数に数値を与えて呼び出したい場合、コンフィグ設定を変更するか、TOSTR関数を用いてください。\\ | ||
| - | 引数は省略できます。省略した場合、数値型の場合は0、文字列型の場合は空文字列が代入されます(初期値を設定していない場合)。\\ | ||
| - | 呼び出された関数側ではARGとARGSで渡された値を参照できます\\ | ||
| - | 基本的に値渡しなのでARGの中身を変更しても渡した元の変数等の値は変化しないことに注意してください。\\ | ||
| - | ARGやARGS、または関数中で# | ||
| - | ver1.808現在、これらの変数を用いた場合は初期値を設定できず、また引数を省略できません。\\ | ||
| - | =|BOX|\\ | ||
| - | ; | ||
| - | @FOOBAR, ARG:0, ARGS: | ||
| - | 〜〜\\ | ||
| - | @HOGEHOGE, ARG:0, ARG:1, ARG: | ||
| - | 〜〜\\ | ||
| - | ; | ||
| - | ; | ||
| - | CALL FOOBAR, X , STR: | ||
| - | ; | ||
| - | CALL FOOBAR, 123 , " | ||
| - | ; | ||
| - | CALL FOOBAR, 123 , @" | ||
| - | ; | ||
| - | CALL FOOBAR, X + 10, " | ||
| - | ; | ||
| - | CALL FOOBAR\\ | ||
| - | ; | ||
| - | CALL FOOBAR, , " | ||
| - | ; | ||
| - | CALL FOOBAR, 123\\ | ||
| - | | | = | | ||
| - | =|BOX|\\ | ||
| - | < | ||
| - | ; | ||
| - | CALL FOOBAR, X , STR:0, Y\\ | ||
| - | ; | ||
| - | CALL FOOBAR, " | ||
| - | ; | ||
| - | CALL FOOBAR, 123 , 456\\ | ||
| - | | | = | | ||
| - | =|BOX|\\ | ||
| - | < | ||
| - | ; | ||
| - | @FOOBAR, X, Y\\ | ||
| - | ; | ||
| - | @FOOBAR, ARG:X, ARG: | ||
| - | ; | ||
| - | @FOOBAR, ARG:0, ARG: | ||
| - | | | = | | ||
| ==== 引数の初期値 ==== | ==== 引数の初期値 ==== | ||
| - | 関数の引数に初期値を設定することができます。\\ | + | [[erabasicリファレンス_関数の定義・呼び出し# |
| - | 初期値を設定する場合、関数側は以下のようになります。\\ | + | |
| - | =|BOX|\\ | ||
| - | @(関数名), | ||
| - | 引数は数値ならARG(: | ||
| - | または関数中で# | ||
| - | それ以外を指定した場合初期値は設定できません。\\ | ||
| - | | | = | | ||
| - | 指定可能な初期値は定数および定文字列のみで、変数は指定できません。\\ | ||
| - | また文字列の初期値は"" | ||
| - | 初期値を設定し、呼び出し側が引数を省略した場合、初期値に設定した値が代入されます。\\ | ||
| - | 省略せずに関数を呼び出した場合は、通常通りARGとARGSに渡された値が代入されます。\\ | ||
| - | =|BOX|\\ | ||
| - | ; | ||
| - | @FUNCTION, ARGS:0 = " | ||
| - | 〜〜\\ | ||
| - | |||
| - | ; | ||
| - | @FOOBAR, ARG:0 = MASTER, ARG:1 = TARGET\\ | ||
| - | ; | ||
| - | ; | ||
| - | @FOOBAR, X = 5, Y = 4\\ | ||
| - | | | = | | ||
| ==== 引数の参照渡し ==== | ==== 引数の参照渡し ==== | ||
| - | ver1.810から、参照型変数を仮引数にすることで引数の参照渡しができるようになりました。\\ | + | [[erabasicリファレンス_関数の定義・呼び出し# |
| - | 参照型変数の定義方法は[[emueraリファレンス_ユーザー定義の変数|参照型変数の項]]を確認してください。\\ | + | |
| - | =|BOX|\\ | + | |
| - | < | + | |
| - | + | ||
| - | @SYSTEM_TITLE\\ | + | |
| - | A = 0\\ | + | |
| - | CALL TEST(A)\\ | + | |
| - | B = 1\\ | + | |
| - | CALL TEST(B)\\ | + | |
| - | PRINTFORML A == {A}\\ | + | |
| - | PRINTFORML B == {B}\\ | + | |
| - | WAIT\\ | + | |
| - | + | ||
| - | @TEST(HOGE)\\ | + | |
| - | < | + | |
| - | HOGE = 100\\ | + | |
| - | RETURN\\ | + | |
| - | | | = | | + | |
| - | =|BOX|\\ | ||
| - | < | ||
| - | A == 100\\ | ||
| - | B == 100\\ | ||
| - | | | = | | ||
| - | 上の例で関数TESTは仮引数に参照型変数を持ちます。\\ | ||
| - | 1回目にTESTが呼ばれたとき、HOGEは実引数Aを参照するようになります。\\ | ||
| - | 関数TEST中でHOGE = 100とすることで参照先の変数Aに100が代入されるので1回目のPRINTFORMLの結果は100になります。\\ | ||
| - | 同様に2回目のTESTが呼ばれると変数Bに100が代入され、2回目のPRINTFORMLの結果も100になります。\\ | ||
| ====== 属性 ====== | ====== 属性 ====== | ||
| - | 関数の仕様や動作を決定するプリプロセッサです。\\ | + | [[erabasicリファレンス_関数の定義・呼び出し#属性|この項目の説明を開く]] |
| - | 関数に#から始まるプリプロセッサを記述する場合、関数の直下にしなくてはなりません。\\ | + | |
| ===== #ONLY ===== | ===== #ONLY ===== | ||
| - | イベント関数専用の属性です。\\ | + | [[erabasicリファレンス_関数の定義・呼び出し#only|この項目の説明を開く]] |
| - | < | + | |
| - | また# | + | |
| ===== #FUNCTION ===== | ===== #FUNCTION ===== | ||
| - | 式中関数の属性です。\\ | + | [[erabasicリファレンス_関数の定義・呼び出し# |
| - | 式中関数は通常のRETURNで終了することはできず、代わりにRETURNF < | + | |
| - | 詳しくはユーザー定義の式中関数を参照してください。\\ | + | |
| ===== #FUNCTIONS ===== | ===== #FUNCTIONS ===== | ||
| - | 式中関数の属性です。\\ | + | [[erabasicリファレンス_関数の定義・呼び出し# |
| - | 式中関数は通常のRETURNで終了することはできず、代わりにRETURNF < | + | |
| - | 詳しくはユーザー定義の式中関数を参照してください。\\ | + | |
| ====== 定義 ====== | ====== 定義 ====== | ||
| - | 変数の名前やその仕様を定義するプリプロセッサです。\\ | + | [[erabasicリファレンス_関数の定義・呼び出し#定義|この項目の説明を開く]] |
| - | 関数に#から始まるプリプロセッサを記述する場合、関数の直下にしなくてはなりません。\\ | + | |
| ===== #LOCALSIZE < | ===== #LOCALSIZE < | ||
| + | [[erabasicリファレンス_変数・定数・配列# | ||
| + | |||
| ===== #LOCALSSIZE < | ===== #LOCALSSIZE < | ||
| - | 関数ごとに個別にLOCALおよびLOCALSの要素数を指定するためのプリプロセッサです。\\ | + | [[erabasicリファレンス_変数・定数・配列# |
| - | 定数式の結果は0より大きい整数である必要があり、それ以外もしくは変数を含んだ式や解釈できない文字列が与えられた場合は無視されます。\\ | + | |
| - | 無視された場合またはこのプリプロセッサを使用しなかった場合は通常通りVariableSize.csvの設定値を使用します。\\ | + | |
| - | イベント関数にこのプリプロセッサを使用した場合、一番最初に実行されるものの設定が使用されます(ver1800現在)。\\ | + | |
| ===== #DIM ===== | ===== #DIM ===== | ||
| - | ユーザー定義変数宣言です。ERB中の特定の関数内で使用することで、その関数内でのみ使用可能な数値型変数を定義できます。\\ | + | [[erabasicリファレンス_変数・定数・配列# |
| - | 詳しくはユーザー定義の変数を参照してください。\\ | + | |
| - | また、ERH中で使用することで、すべての関数で値を共有できる数値型変数を定義できます。\\ | + | |
| - | 詳しくは[[emueraリファレンス_ヘッダーファイル_erh|Emueraリファレンス「ヘッダーファイル(ERH)」]]を参照してください。\\ | + | |
| ===== #DIMS ===== | ===== #DIMS ===== | ||
| - | ユーザー定義変数宣言です。ERB中の特定の関数内で使用することで、その関数内でのみ使用可能な文字列型変数を定義できます。\\ | + | [[erabasicリファレンス_変数・定数・配列# |
| - | 詳しくはユーザー定義の変数を参照してください。 また、ERH中で使用することで、すべての関数で値を共有できる文字列型変数を定義できます。\\ | + | |
| - | 詳しくは[[emueraリファレンス_ヘッダーファイル_erh|Emueraリファレンス「ヘッダーファイル(ERH)」]]を参照してください。\\ | + | |
| ===== #DEFINE ===== | ===== #DEFINE ===== | ||
| - | DEFINEマクロの宣言です。ERH中で使用することで、全ERBコード中の文字列をあらかじめ定義した別の文字列へ置換することができます。\\ | + | [[erabasicリファレンス_ファイル構成・定義# |
| - | 詳しくはヘッダーファイル(ERH)を参照してください。\\ | + | |
| ====== 特殊なブロックを表す行 ====== | ====== 特殊なブロックを表す行 ====== | ||
| - | これらはプリプロセッサ行です。\\ | + | [[erabasicリファレンス_ファイル構成・定義# |
| - | これらを記述した同一行において、その直後に続けて命令や関数やコメントなどを記述してはいけません。\\ | + | |
| - | これらはeramakerでは解釈できないためコーディングするときに場合によっては; | + | |
| ===== [SKIPSTART] ===== | ===== [SKIPSTART] ===== | ||
| + | [[erabasicリファレンス_ファイル構成・定義# | ||
| + | |||
| ===== [SKIPEND] ===== | ===== [SKIPEND] ===== | ||
| - | [SKIPSTART]から[SKIPEND]までの間に書いた行はEmueraでは読み込まれず実行されません。\\ | + | [[erabasicリファレンス_ファイル構成・定義# |
| - | これはEmueraとeramakerで挙動を意図的に変えたいときに使われるものです。\\ | + | |
| - | Emueraでは実行してほしくない文を記述する際に使ってください。\\ | + | |
| - | また、; | + | |
| - | 詳しくは一般の項目を参照してください。\\ | + | |
| ===== [IF XXX] ===== | ===== [IF XXX] ===== | ||
| + | [[erabasicリファレンス_ファイル構成・定義# | ||
| + | |||
| ===== [ELSEIF XXX] ===== | ===== [ELSEIF XXX] ===== | ||
| + | [[erabasicリファレンス_ファイル構成・定義# | ||
| + | |||
| ===== [ELSE] ===== | ===== [ELSE] ===== | ||
| + | [[erabasicリファレンス_ファイル構成・定義# | ||
| + | |||
| ===== [ENDIF] ===== | ===== [ENDIF] ===== | ||
| - | ある名称XXXのマクロが定義されているかどうかによって複数の行を実行するかどうか、分岐することができます。\\ | + | [[erabasicリファレンス_ファイル構成・定義# |
| - | 詳しくはヘッダーファイル(ERH)を参照してください。\\ | + | |
| ===== [IF_DEBUG] ===== | ===== [IF_DEBUG] ===== | ||
| + | [[erabasicリファレンス_ファイル構成・定義# | ||
| + | |||
| ===== [ENDIF] ===== | ===== [ENDIF] ===== | ||
| - | [IF_DEBUG]から[ENDIF]までの間に書いた行はデバッグモード時のみ実行されます。\\ | + | [[erabasicリファレンス_ファイル構成・定義# |
| - | 非デバッグモード時はコメント行と見なされ実行されません。\\ | + | |
| - | ただし、DEBUG系命令は元々非デバッグモード時には無視されるので、;#; | + | |
| - | 同様にデバッグ変数も非デバッグモード時には空文字列又は0のため、エラーの心配はありません。\\ | + | |
| - | デバッグモードについては[[emueraリファレンス_デバッグモード|こちら]]を参照してください。\\ | + | |
| ===== [IF_NDEBUG] ===== | ===== [IF_NDEBUG] ===== | ||
| + | [[erabasicリファレンス_ファイル構成・定義# | ||
| + | |||
| ===== [ENDIF] ===== | ===== [ENDIF] ===== | ||
| - | [IF_NDEBUG]から[ENDIF]までの間に書いた行は非デバッグモード時のみ実行されます。\\ | + | [[erabasicリファレンス_ファイル構成・定義# |
| - | デバッグモード時はコメント行と見なされ実行されません。\\ | + | |
| - | [IF_DEBUG]とは判定が逆になっています。\\ | + | |
| - | デバッグモードについては[[emueraリファレンス_デバッグモード|こちら]]を参照してください。\\ | + | |
emueraリファレンス_関数.1782969138.txt.gz · 最終更新: by 127.0.0.1
