Constants / Variables¶

Constants (Literals)¶

Constant Notation¶

With the exception of Octal notation, Emuera supports the same notations as 吉里吉里 (KiriKiri).
For example, the following lines all have the same meaning.

X = 32  
X = 0b100000  
X = 0x20  
X = 1p5

From top to bottom, the usual decimal notation, binary, hexadecimal, and 1 × 2 to the power of 5.
Notation like 1p5 is convenient when you want to get or set bits with bit operators.
For example, the conditional statement below becomes true when the lower 0th or 3rd bit of A stands.

IF (A & 1p0)||(A & 1p3)

Also, by using e instead of p, you can express n × 10 to the power of m.
For example, 13e3 equals 13000.
Since the above is only a notation of a constant, you can not use it as an expression.
The following notation is wrong.

X = 13e(A + 1)

We have not adopted octal notation because of compatibility issues with eramaker.
"012" is interpreted as 12 instead of 10.

変数¶

変数サイズの指定¶

EmueraではcsvフォルダにVariableSize.csvという名前のファイルを置くことで既存の変数の要素数を指定できます。
また、要素数に-1を指定することにより、ERB中でのその変数の使用を禁止することができます。

禁止設定された変数をERB中で代入や参照するとエラーになります。 禁止設定された変数をシステムが必要とする場合、代入処理は無視され、値は常に-1と扱われます。
（MONEYやNEXTCOMを禁止した場合に発生する状況です）
また、COUNTを使用禁止変数にした場合、REPEATも使用不可となり、実行時にエラー終了します（EM+EE）

ローカル変数¶

LOCAL¶

LOCALS¶

※この変数はobsoleteです。代わりに#DIM、#DIMSの使用を検討してください。
詳しくはユーザー定義の変数を参照してください。

ローカル変数（局所変数）です。
LOCALは整数、LOCALSは文字列となります
サイズは基本はLOCALが1000、LOCALSが100です。
また、#LOCALSIZE <設定する要素数>および#LOCALSSIZE <設定する要素数>
によって関数ごとに個別に要素数を変更できます。（ただし設定できる値は0より大きい整数）
セーブはされません。

@EVENTFIRST  
    LOCAL:10 = 123  
    CALL FUNC001  
    PRINTV LOCAL:10  
    WAIT  
@FUNC001  
    LOCAL:10 = 567  
    RETURN

上のコードのPRINTVの結果は123になります。
@FUNC001の中でLOCAL:10を変更していますが、@EVENTFIRST内のLOCALには変更が及びません。
多くの言語のローカル変数とは異なり、関数の呼び出しの際に初期化はされません。

内部的にはLOCAL@関数名という変数を作成しています。
なのでイベント関数など同じ名前の関数が複数ある場合は共用です。また、再帰的に呼び出された場合は同じ変数をつかうことになります。
LOCAL@EVENTFIRST:10 = 567のように他の関数用の変数も呼び出せますが推奨しません（デバッグ用の機能です）。
なお、他の関数のものを呼び出す時に、呼び出し先関数名に演算子等が含まれているとエラーとなります

ARG¶

ARGS¶

ローカル変数です。
ARGは整数、ARGSは文字列となります
サイズは基本はARGが1000、ARGSが100でVariableSize.csvで変更できます。
また、関数の引数で定義された分だけを問題なく使えるだけの要素数を自動で確保します。（VariableSize.csvで指定した数未満にはなりません）

@FUNC002, ARG:0, ARG:1, ARG,1100  
    LOCAL = ARG:0 * ARG:1 / 100  
    RETURN LOCAL

この場合、ARGの要素数は本来1000ですが、@FUNC002においてARGの要素数は0～1100の1101となります。
関数における引数指定のために使うことを想定しているので、それ以外の用途に用いると可読性が下がるかもしれません。

（ユーザー定義のプライベート変数）¶

特定の関数中で定義#DIMまたは#DIMSを用いて定義した変数はプライベート変数であるため、ローカル変数と同様に扱えます。
詳しくはユーザー定義の変数を参照してください。

セーブデータ間で共有される変数¶

GLOBAL¶

GLOBALS¶

異なるセーブデータ間で共有することができる変数です。
GLOBALは整数、GLOBALSは文字列となります
サイズは基本はGLOBALが1000、GLOBALSが100でVariableSize.csvで変更できます。
他のデータと一緒にはセーブ・ロードされません。
グローバル変数をセーブするにはSAVEGLOBAL命令を使います。
SAVEGLOBALを行うと、global.savにGLOBALとGLOBALSが保存されます。
書き込むときに既にglobal.savがある場合、上書きします
LOADGLOBAL命令により、global.savからGLOBALとGLOBALSを読み込めます。
LOADGLOBALは@EVENTFIRSTおよび@EVENTLOADのタイミングで行うことを勧めます。
GLOBAL、GLOBALSを経由すれば異なるセーブデータ間でデータを共有することができます。

（ユーザー定義のグローバル変数）¶

ERH中で定義#DIM GLOBALまたは#DIMS GLOBALを用いて定義した変数はグローバル変数となります。
また、#DIM SAVEDATA GLOBALとすることでセーブされるグローバル変数となります。
詳しくはヘッダーファイル（ERH）を参照してください。

キャラクタ変数¶

NICKNAME¶

MASTERNAME¶

NAMEやCALLNAMEと同様のセーブされる文字列型変数です。
chara*.csvではNICKNAME、MASTERNAMEまたはあだ名、主人の呼び方として指定します。

CSTR¶

セーブされる文字列配列変数です。
CFLAGの文字列版です。
chara*.csvではCSTRとして指定します。

CUP¶

CDOWN¶

DOWNBASE¶

TCVAR¶

数値型配列変数です。
それぞれ、UP、DOWN、LOSEBASE、TFLAGのキャラクタ変数版として使用することが想定されています。
そのため初期化タイミングやセーブの可不可もこれらの変数と同じです。
ただし、CUPとCDOWNはUPCHECK命令の代わりにCUPCHECK命令を使います。

CDFLAG¶

数値型キャラクター三次元配列変数です。

CDFLAG:MASTER:0:2

などのように第一引数がキャラ登録番号なのは従来のキャラクター変数と同じですが、
第二引数と第三引数が必要になります。

（ユーザー定義のキャラクタ変数）¶

ERH中で定義#DIM CHARADATAまたは#DIMS CHARADATAを用いて定義した変数はキャラクタ変数となり、CFLAGなどと同様自由に扱えます。
詳しくはヘッダーファイル（ERH）を参照してください。

csv関連¶

csv変数¶

各csvで定義された値を参照するための変数です。
使い方は例えばTALENTNAMEとtalent.csvの関係と同じです。
全て代入不可でセーブされない1次元配列変数です。
csvで定義されていない場合、0または空文字列を返します。

cstr.csv等とstr.csvの役割を混同しないでください。
str.csvは変数STRに代入される値を決めるファイルですが、cstr.csvはCSTRNAMEを定めるファイルです。
STRNAMEを定めるファイルはstrname.csvとなっています。str.csv及びstrname.csvの使い方に注意してください。

gamebase.csv変数¶

gamebase.csvで定義された値を参照するための変数です。
すべて非配列、代入不可、セーブされない変数です。

WINDOW_TITLE¶

Emueraのウィンドウのタイトルバーに表示されている文字列です。
非配列の文字列型変数です。初期値はgamebase.csvのウィンドウタイトルに設定された値です。
ウィンドウタイトルが設定されていなければタイトルとバージョンから生成します。
タイトルも設定されていない場合、Emueraになります。

その他のcsvに関わる変数¶

MONEYLABEL¶

お金の単位が記録された変数です。
非配列の文字列型変数で、代入不可、セーブされない変数です。
初期値は_Replace.csvにて設定されるお金の単位に設定された値です。
お金の単位が設定されていない場合、eramakerと同じ$になります。

DRAWLINESTR¶

DRAWLINE命令を行ったときに表示される文字列が記録された変数です。
非配列の文字列型変数で、代入不可、セーブされない変数です。
初期値は_Replace.csvにて設定されるDRAWLINE文字に設定された値を繰り返したものです。
そのためDRAWLINE文字に設定された値そのままの文字列が入っているわけではありません。
DRAWLINE文字が設定されていない場合、eramakerと同じ、例えば
------------------------------------------------------------------------------------------------------------になります。

セーブロード関連¶

LASTLOAD_*¶

最後にロードしたデータの情報を参照するための変数です。
参照はできますが代入はできません。
全て初期値は-1または空文字列です。
ロードした時に更新され、RESETDATAやメニューのタイトルに戻るを実行すると初期値に戻ります。

LASTLOAD_VERSION¶

最後にロードしたデータのバージョン（gamebase.csvで定義する値）

LASTLOAD_NO¶

最後にロードしたデータの番号（save*.savの*に相当する番号）

LASTLOAD_TEXT¶

テキスト（PUTFORMで追加するテキスト。SAVEDATA_TEXT）

SAVEDATA_TEXT¶

セーブデータに保存され、セーブ/ロード画面で表示されるテキストです。
ロード後にLASTLOAD_TEXTで参照できるテキストでもあります。
参照も代入も可能です。
@SAVEINFOが呼ばれる時に現在時刻を表す文字列が代入され、PUTFORMで追記することができる文字列です。
@SAVEINFO中でこの文字列に直接代入することで時刻表示もカスタマイズできます。
SAVEGAMEとPUTFORMを使わない（SAVELOAD.ERBを使う場合）には出番がありません。

（ユーザー定義のセーブ可能な広域変数）¶

ERH中で定義#DIM SAVEDATAまたは#DIMS SAVEDATA"を用いて定義した変数はセーブ可能な広域変数となります。
ただし、#DIMS SAVEDATAを用いてセーブ可能な多次元広域変数を定義する場合、オプションセーブデータをバイナリ形式で保存するが有効になっている必要があります。
詳しくはヘッダーファイル（ERH）を参照してください。

多次元配列変数¶

DITEMTYPE¶

DA ～ DE¶

※この変数はobsoleteです。代わりに#DIM、#DIMSを使用して用途に応じた名前を付けることを検討してください。
詳しくはユーザー定義の変数を参照してください。

固定長の整数型二次元配列です。
DITEMTYPE:1:2のように呼び出します。引数は省略できません。
eramakerの二重配列は第一引数にはキャラクタ登録番号を指定するのでCHARANUMによって配列の大きさが異なります。
DITEMTYPEなどの二次元配列はVariableSize.csvで指定した大きさのまま変化することはありません。
VARSIZE命令の対象にした場合、RESULT:0とRESULT:1にそれぞれ要素数が代入されます。
VariableSize.csvでDITEMTYPE,100,200としているとDITEMTYPE:99:199まで使用でき、VARSIZE命令ではRESULT:0とRESULT:1に100と200が代入されます。

TA, TB¶

※この変数はobsoleteです。代わりに#DIM、#DIMSを使用して用途に応じた名前を付けることを検討してください。
詳しくはユーザー定義の変数を参照してください。

固定長の整数型三次元配列です。
TA:1:2:3のように呼び出します。引数は省略できません。
サイズは標準では100×100×100です。つまりTA:99:99:99まで使えます。
VariableSize.csvでサイズを変更することが可能ですが、合計で100万を超えるサイズは指定できません。
VARSIZE命令の対象にした場合、RESULT:0とRESULT:1とRESULT:2にそれぞれの要素数が代入されます。

（ユーザー定義の多次元配列変数）¶

ver1.808以降、定義#DIMまたは#DIMSを用いて定義した変数を多次元とすることができるようになりました。
詳しくはユーザー定義の変数を参照してください。

デバッグ変数¶

デバッグ変数はデバッグ用の情報を提供するための変数です。
デバッグ変数はデバッグモードで起動したときのみ意味のある値を返します。
通常モードで起動したときには空文字列又は0を返します。

全て名前の前と後ろにアンダースコア_が2つ付いています。

__FILE__¶

一次元読み取り専用変数です。
現在実行中のスクリプトのファイル名を返します。
ファイル名はエラー情報などと同じようにフォルダ構造及び拡張子までを含む形式です。

システム入力待ち中にデバッグコマンドや変数ウォッチから参照した場合など、
現在実行中のスクリプトがない場合は空文字列を返します。

__LINE__¶

一次元読み取り専用変数です。
現在実行中のスクリプトの行番号を返します。
行番号はエラー情報などと同じように1から始まる数字です。

現在実行中のスクリプトがない場合は-1を返します。

__FUNCTION__¶

一次元読み取り専用変数です。
現在実行中の関数名を返します。
関数名は@及び引数のリストを含みません。

現在実行中のスクリプトがない場合は空文字列を返します。

その他¶

TSTR¶

文字列型1次元配列です。一次元配列で、セーブはされません。
TFLAGと同じタイミングで初期化されます。

RANDDATA¶

乱数の状態を記憶するための配列です。数値型の一次元配列で代入可、セーブされます。
DUMPRANDによって記録され、INITRANDによって読み出されます。

LINECOUNT¶

これまでにPRINTした行数を返す変数です。
LINECOUNTは起動直後から改行(ウインドウ幅による改行を含まない)のたび+1、CLEARLINEした数だけ-されます。
ログバッファー(標準5000)をあふれたことによる削除によっては変動しません。
非配列の数値型変数で、代入・セーブ共に不可能です。
また、行の数え方はCLEARLINEと同様です。

ISTIMEOUT¶

以下、私家改造版1809+v2に添付のreadmeより

○TINPUT系がタイムアウトしたかをチェックする変数ISTIMEOUT追加  
　TINPUT系が呼び出された時に0に初期化され、タイムアウトすると1となります。

ver1815現在、この変数は利用不能な可能性があります。

__INT_MAX__¶

__INT_MIN__¶

数値型変数の定義域最大値、最小値という定数が記録されている非配列の数値型変数で、代入・セーブ共に不可能です。
デバッグ変数ではないので普通に起動した場合でも使用できます。

（ユーザー定義の広域変数）¶

ERH中で定義#DIMまたは#DIMSを用いて定義した変数は広域変数となり、一文字変数（Aなど）同様自由に扱えます。
詳しくはヘッダーファイル（ERH）を参照してください。

（ユーザー定義の定数）¶

ERH中および特定の関数中で、定義#DIMまたは#DIMSを用いて定義した変数は1次元配列の定数となり、代入できない変数として扱えます。
詳しくはユーザー定義の変数を参照してください。

（ユーザー定義の参照型変数）¶

特定の関数中で定義#DIM REFまたは#DIMS REFを用いて定義した変数は参照型変数となります。
詳しくはユーザー定義の変数を参照してください。

makerとの仕様の違い¶

NAME¶

CALLNAME¶

eramakerでは代入ができません。
Emueraでは代入できるようになっています。

RAND¶

CHARANUM¶

eramakerでは代入でき、セーブ・ロードされますが代入した値を使用する方法がありません。
Emueraでは代入を禁止しています。

暫定的な仕様表¶

eramakerにも存在していた変数¶

Emuera専用変数¶