Emuera/EmuDic - Revision history

Strmesko at 08:09, 2 July 2020

2020-07-02T08:09:03Z

Strmesko at 07:57, 2 July 2020

2020-07-02T07:57:02Z

Strmesko at 05:59, 2 July 2020

2020-07-02T05:59:30Z

Maldito: /* Definitions (Preprocessor) */

2020-04-10T03:01:50Z

‎Definitions (Preprocessor)

Maldito: translated half of the page

2020-04-10T03:01:14Z

translated half of the page

Sllypper: Headers

2019-04-09T20:42:45Z

Headers

Sllypper: imported from the right page

2019-04-09T20:08:47Z

imported from the right page

Show changes

Sllypper: imported japanese page

2019-04-09T05:26:25Z

imported japanese page

New page

= 一般 =
== 行末コメント ==

A = B ;AにBを代入

このように行の末尾にコメントを挿入できます
ただし、一部例外があり、「PRINT」命令のように引数が単純文字列の命令の場合にはコメント化されず文字列の一部と評価されます

PRINT foobar;ほげほげ

この場合、「foobar;ほげほげ」がPRINTされます

== 行の連結 ==

{
DIM CONST HOGE =
1,2,3,4
}

と書くと「#DIM CONST HOGE = 1,2,3,4」と解釈されます
'{'、'}'の行にはホワイトスペース以外の他の文字が存在してはなりません
改行記号のある位置には半角スペースが補われます
つまり関数名・変数名の途中で行を分割することはできないほか、
PRINTなどを分割すると表示文字列の中に改行だった半角スペースが含まれます
Emueraの文法解釈において行連結処理はコメントの解釈より先に行われます
つまり

{
#DIM CONST HOGE =
1,2,3,4 ;コメント
,5,6,7,8
}

は「#DIM CONST HOGE = 1,2,3,4 ;コメント ,5,6,7,8」となり、
「,5,6,7,8」は行末コメントの一部とみなされ無視されます

== 特別なコメント行 ==
=== ;!; ===
Emuera、eramakerのいずれでも、;で始まる行はコメント行とみなされますが、Emueraは;!;で始まる行はコメントではなく有効な行とみなします。
eramakerでは実行してほしくない文を記述する際に使ってください。
例えば@SHOWSHOPに以下のスクリプトを加えるとEmueraでの動作を禁止できます。

;!;PRINTW このスクリプトはEmueraでは実行できません
;!;QUIT

また、[SKIPSTART]や[SKIPEND]と併用することで、以下のスクリプトのようにEmuera以外での動作を禁止できます。
Emuera以外では実行してほしくない文を記述する際に使ってください。

;!;[SKIPSTART]
PRINTW このスクリプトはEmuera以外では実行できません
QUIT
;!;[SKIPEND]

=== ;#; ===
<nowiki>;#;</nowiki>で始まる行はデバッグモード時のみ実行されます。
非デバッグモード時ではコメント行と見なされ実行されません。
ただし、DEBUG系命令は元々非デバッグモード時には無視されるので、;#;を行頭に付ける必要はありません。
同様にデバッグ変数も非デバッグモード時には空文字列又は0のため、エラーの心配はありません。
デバッグモードについては[debug こちら]を参照してください。

== キャラクタ配列 ==
eramakerではおそらくキャラクタ作成用の配列が100個しか用意されていません。
そのため、chara3.csvとchara03.csvとchara3B.csvでそれぞれ別のキャラを定義しても一人しか有効になりません。
Emueraではキャラクタはメモリが許す限りいくらでも定義できます。
また、"chara*.csv"に該当すればchara101.csv、charaABC.csvなどどんなファイルでも読みに行きます。
キャラの番号が重複し、ADDCHARA又はADDSPCHARAの際に複数の候補がある場合、先に読み込まれた方のみが有効になります。

== 整数型の値の範囲 ==
eramakerで扱える整数は32ビット符号付整数、すなわち-2147483648～2147483647の範囲です。
Emueraでは吉里吉里と同じく64ビット符号付整数、-9223372036854775808～9223372036854775807の範囲の値を扱います。

== 配列変数への一括代入 ==

A:10 = 1,2,3
DA:0:0 = 1,2,3

上のように書いた場合、A:10～A:12にそれぞれ1,2,3の値が代入されます
下のような多次元配列では、DA:0:0～DA:0:2にそれぞれ1,2,3の値が代入されます
DA:0:0～DA:0:99の次にDA:1:0に代入することはなく、配列外参照エラーになります
ただし、複合代入演算には使えません（A += 1,2,3 などは不可）。
また、文字列型配列変数への代入に一括代入を用いる場合、[exetc#h4-.E6.96.87.E5.AD.97.E5.88.97.E5.BC.8F.E3.82.92.E7.94.A8.E3.81.84.E3.81.9F.E6.96.87.E5.AD.97.E5.88.97.E5.A4.89.E6.95.B0.E3.81.B8.E3.81.AE.E4.BB.A3.E5.85.A5 文字列式を用いた代入]を行わなくてはなりません

;STR:20に「いちご,メロン,ブルーハワイ」という文字列が代入される
STR:20 = いちご,メロン,ブルーハワイ
;STR:20～STR22にそれぞれ「いちご」「メロン」「ブルーハワイ」が代入される
STR:20 '= "いちご", "メロン", "ブルーハワイ"

== FORM構文を用いた文字列変数への代入 ==
文字列変数への代入の際、PRINTFORMと同じ形式で代入する文字列を指定できます。

SAVESTR:0 = %RESULTS%

この文でSAVESTR:0にRESULTSの中身を代入することができます。
同じ文はeramakerではSAVESTR:0に%RESULTS%という文字列そのものを代入したことになります。
Emueraで%RESULTS%という文字列そのものを代入したい場合、以下のように書いてください。

SAVESTR:0 = \%RESULT\%

\記号の直後の文字はシステム記号として扱われません。
\記号自体を文字列に含めたい場合は\\としてください。

あまりないケースですが、eramakerとEmueraで同じ動作をさせたい場合は以下のように書く必要があります。

;!;SAVESTR:0 = \%RESULT\%
;!;[SKIPSTART]
SAVESTR:0 = %RESULTS%
;!;[SKIPEND]

== 文字列式を用いた文字列変数への代入 ==
ver1813以降のEmueraでは新たに、代入演算子'=と文字列式を用いて文字列変数への代入を行うことができます。

;「STR = あいう」と同様
STR '= "あいう"
;「STR = %TSTR:0%いろは」と同様
STR '= TSTR:0 + "いろは"

== 文字列による配列変数の要素の指定 ==
以下の変数について、引数を*.csvで定義した文字列にして呼び出すことができます。
Emueraの新規変数についての詳細は[exvar Emueraで追加された拡張文法 - 定数・変数]をご覧ください。

ITEM (item.csv)
ITEMSALES (item.csv)
LOSEBASE (base.csv)
BASE (base.csv)
MAXBASE (base.csv)
ABL (abl.csv)
TALENT (talent.csv)
EXP (exp.csv)
MARK (mark.csv)
RELATION (chara*.csv)
UP (palam.csv)
DOWN (palam.csv)
PALAM (palam.csv)
JUEL (palam.csv)
GOTJUEL (palam.csv)
STAIN (stain.csv)
SOURCE (source.csv)
EX (ex.csv)
NOWEX (ex.csv)
TEQUIP (tequip.csv)
EQUIP (equip.csv)
FLAG (flag.csv)
TFLAG (tflag.csv)
CFLAG (cflag.csv)
STR (strname.csv)
SAVESTR (savestr.csv)
以下はEmueraから追加された変数
ITEMPRICE (item.csv)
DOWNBASE (base.csv)
CUP (palam.csv)
CDOWN (palam.csv)
TCVAR (tcvar.csv)
TSTR (tstr.csv)
CSTR (cstr.csv)
CDFLAG (cdflag1.csv, cdflag2.csv)
GLOBAL (global.csv)
GLOBALS (globals.csv)

例えばabl.csvに"2,技巧"という定義があれば、以下の4つの行は同じ意味になります。

ABL:技巧 += 1
ABL:2 += 1
ABL:"技巧" += 1
ABL:(ABLNAME:2) += 1

RELATIONについてはNAME、CALLNAMEのいずれでも指定できます。
同名で複数の定義がある場合、先に定義されている方が呼ばれます。
例えばabl.csvに"2,技巧"と"4,技巧"があり、"2,技巧"の方が前の行で定義されているならば、"ABL:技巧"は"ABL:2"になります。
文字列は式や変数でも可能です。その場合は以下のように()を付けてください。

ABL:(RESULTS:0) = ABL:(RESULTS:0) + 1

()を省略した場合、アイテム名と変数名が同一になる場合があります。その場合は変数が優先されます。
例えばabl.csvに"0,ローター"という定義がある場合、

@HOGE
#DIM ローター, 0
ローター = 1
PRINTFORML {ABL:ローター}

この場合、0番目のABLではなく1番目のABLであると解釈されます。
同様に、アイテム名が数値の場合、数値としての解釈が優先されます。
例えばabl.csvに"0,10"という定義をしABL:10を参照した場合は0番目のABLとは解釈されず10番目のABLとなります。

これはchara*.csv内の定義においても使用できます。
例えばabl.csvに"2,技巧"という定義があれば、以下の2つの行は同じ意味になります。

能力,2,2
能力,技巧,2

ただし、相性(RELATION)には使えません。
chara*.csvを読んでいる段階ではシステムがcharaの名前とNOの対応を把握していないためです。

== 書式付文字列（FORM構文）拡張 ==
PRINTFORMなどでつかわれる書式付文字列のうち、{}、%%に表示桁数（文字数）を指定できます。
{変数・数式等, 表示桁数, 揃え(LEFT or RIGHT)}、%変数、文字列式等, 表示桁数, 揃え(LEFT or RIGHT)%という形式で指定します。
文字数は全角文字を2文字と数えます。
表示桁数（文字数）に足りない部分は半角スペースが追加されます。
通常は右揃えですが、キーワードLEFTを指定すると左揃えになります。
指定された表示桁数よりもとの桁数の方が大きい場合、そのまま表示します。

A = 123456
STR:0 = あいう
PRINTFORML [{A}]
PRINTFORML [{A,10}]
PRINTFORML [{A,10,LEFT}]
PRINTFORML [%STR:0%]
PRINTFORML [%STR:0,10%]
PRINTFORML [%STR:0,10,LEFT%]
PRINTFORML [{A,2}]
PRINTFORML [%STR:0,2%]
;結果
[123456]
[ 123456]
[123456 ]
[あいう]
[ あいう]
[あいう ]
[123456]
[あいう]

== 文字列式中での書式付文字列（FORM構文）の使用 ==
PRINTSやユーザー定義の式中関数の引数といった文字列式中でFORM構文を使用するとエラーになります。
そのため文字列式中で書式付文字列を使用する場合、文字列式中で定文字列を使うときに"～"を使用するのと同じように
@"～"を使用します。
また、@"～"の中の文字列が\@～\@を用いた三項演算子による記載のみである場合、@"～"を省略して直接\@～\@と書くことができます

正しい例
;代入はFORM構文
STR:0 = あいう
;加算は文字列式
RESULTS += STR:0
;文字列式に定文字列を使用する例
RESULTS += "えお"
;文字列式にFORM構文を使用する例
PRINTS @"%RESULTS%かきくけこ"

;以下の4行はすべて同じである
PRINTS STR:0 + "！"
PRINTFORM %STR:0%！
PRINTS @"%STR:0%！"
PRINTFORM %STR:0 + "！"%
間違った例
;中身が「RESULTS」になる
STR:0 = RESULTS
;エラーが出る
RESULTS += えお
;エラーが出る
RESULTS += %STR:0%
;「@"」と「"」も表示される
PRINTFORM @"%RESULTS%かきくけこ"

== INPUTS系でのマクロ構文の使用 ==
INPUTSやそれに類する入力受付命令で、マクロ式を用いることができます。
マクロの書式については[howto 利用方法]のマクロの項目を確認してください。
マクロ構文を使わず、単なる文字列として()を使用する場合、\を用いてエスケープしてください。

@@ Line 20: / Line 20: @@
 ===Debug Mode===
 This is the mode when the command is started by passing "-debug" as command line argument. See [[Emuera/debug|Debug Mode]] for details.
-[[Category:EmuEra]] [[Category:Contributing]]
+[[Category:EmuEra]] [[Category:Contributing]] [[Category:Untranslated]]
 ==Windows / Dialogs==
 ===Main Window===

@@ Line 20: / Line 20: @@
 ===Debug Mode===
 This is the mode when the command is started by passing "-debug" as command line argument. See [[Emuera/debug|Debug Mode]] for details.
-[[Category:EmuEra]]
+[[Category:EmuEra]] [[Category:Contributing]]
 ==Windows / Dialogs==
 ===Main Window===

@@ Line 20: / Line 20: @@
 ===Debug Mode===
 This is the mode when the command is started by passing "-debug" as command line argument. See [[Emuera/debug|Debug Mode]] for details.
+[[Category:EmuEra]]
 ==Windows / Dialogs==
 ===Main Window===

@@ Line 67: / Line 67: @@
 A preprocessor that defines the name of a variable and its type on a line beginning with #.</br>
 Functions include #LOCALSIZE and #LOCALSSIZE to specify the number of elements in a LOCAL or LOCALS variable,</br>
-#DIM and #DIMS to define a variable, and #DEFINE to define a DEFINE macro in the ERH.</br>
+<nowiki>#DIM</nowiki> and #DIMS to define a variable, and #DEFINE to define a DEFINE macro in the ERH.</br>
 ===Functions that can be used in expressions===

@@ Line 1: / Line 1: @@
-当Wikiでの用語のまとめです。</br>
+This is a summary of the terms used in this wiki.</br>
-Emueraの拡張に伴い独自の造語が増えてきたので覚え書きとして記述してみました。</br>
+I wrote it as a memo because the original coined words have increased with the extension of Emuera.</br>
-==起動モード==
+==Startup Mode==
-===通常モード===
+===Normal Mode===
-Emueraを普通に起動したときのモードです。</br>
+This is the mode when Emuera is started normally.</br>
-EmueraXXXX.exeをダブルクリックして起動したときにこのモードになります。
+You will be in this mode when you double-click on EmueraXXXX.exe to launch it.
-===解析モード===
+===Analysis Mode===
-コマンドライン引数に解析したいファイル名を渡して起動したときのモードです。</br>
+This is the mode when a file is passed as a command line argument.</br>
-EmueraXXXX.exeにファイルをドラッグ＆ドロップして起動した場合にこのモードになります。</br>
+It also becomes this mode when a file is drag and dropped into EmueraXXXX.exe.</br>
-解析モードではドラッグ＆ドロップしたファイルの文法チェックが行われます。</br>
+In analysis mode, a grammar check is performed for dragged and dropped files.</br>
-そのため開発中のファイルの文法間違いなどを確認できます。</br>
+This allows you to check for grammatical errors in the files you are developing.</br>
-ただし要素の文字列による指定のチェックのため、使用する予定のバリアントのCSVフォルダが必要になります。</br>
+However, you will need the CSV folder of the variant you plan to use to check the type of the elements string.</br>
-使用する予定のバリアントのEmueraXXXX.exeにファイルをドラッグ＆ドロップすればいいでしょう。</br>
+Just drag and drop the file into the EmueraXXXX.exe of the variant you plan to use.</br>
-なお、1738gより解析モードのときに「ロード時にレポートを表示する」が有効になっている場合、</br>
+In addition, from 1738g, when "Report is displayed when loading" is enabled in the analysis mode, it is possible to display the report when loading.</br>
-読み込まれたERBファイルごとにその中で使われている関数のリストを表示するようになりました。</br>
+The list of functions used in each loaded ERB file is now displayed.</br>
-関数が多すぎてログが流れてしまう場合は、コンフィグでログの行数を増やしてください。
+If you have too many functions, increase the number of lines in the log in your config.
-===デバッグモード===
+===Debug Mode===
-コマンドライン引数に-Debugを渡して起動したときのモードです。詳しくは[[Emuera/debug|デバッグモード]]をご覧ください。
+This is the mode when the command is started by passing "-debug" as command line argument. See [[Emuera/debug|Debug Mode]] for details.
-==ウインドウ・ダイアログ==
+==Windows / Dialogs==
-===メインウインドウ===
+===Main Window===
-通常起動時に最初に開くウインドウのことです。
+This is the first window that opens when you normally start up.
-===メインコンソール===
+===Main Console===
-メインウインドウのうち、特に入出力を行う部分の名称です。
+The name of the part of the Main Window that is used for input and output.
-===デバッグウインドウ===
+===Debug Window===
-デバッグモードで起動したときに開くことが出来るウインドウのことです。
+This is a window that can be opened when started in Debug Mode.
-===デバッグコンソール===
+===Debug Console===
-デバッグウインドウで「コンソール」タブを選択したときに表示される入出力を行う部分の名称です。
+The name of the input/output part that is displayed when the "Console" tab is selected in the Debug Window.
-===設定ダイアログ===
+===Configuration Dialog===
-メインウインドウのメニューのヘルプ、設定から開くダイアログのことです。
+It is a dialog that can be opened from the main window menu help or settings.
-===クリップボードダイアログ===
+===Clipboard Dialog===
-メインコンソールからCtrl+Cで開くダイアログのことです。
+It is a dialog that can be opened by Ctrl+C from the main console.
-==関数==
+==Functions==
-===命令===
+===Commands===
-PRINTやWAITなどのことです。
+PRINT or WAIT, for example.
-===関数===
+===Functions===
-ERBスクリプト中で@～～文で名称を定義してCALL命令などで呼び出すもののことです。</br>
+It is a name that is defined in an ERB script with @~~ statements and called with a CALL instruction, etc.</br>
-式中で使える関数のうち、@～～文で名称を定義するものを含みます。
+Among the functions that can be used in expressions, those that define their names in sentences @~~ are included.
-===イベント関数===
+===Event Functions===
-関数のうち、関数名がEVENTで始まりシステムから呼び出されるもののことです。</br>
+A function whose name starts with "EVENT" and is called by the system.</br>
-複数定義すれば全てが呼ばれます。
+If you define more than one, all of them will be called.
-===プリプロセッサ===
+===Preprocessor===
-ERBフォルダ内のファイルにおいて、他の命令より先に処理をする行のことです。</br>
+A line in a file in the ERB folder that is processed before any other instruction.</br>
-#で始まる行、もしくは[]で括られた語句からなる行がそれです。</br>
+A line that begins with # or consists of a phrase enclosed in [].</br>
-#で始まる行は、属性や定義に分けられます。詳しくはそちらを参照してください。</br>
+Lines that begin with # are divided into attributes and definitions. Please see them for more information.</br>
-[]で括られた語句からなる行は、特殊なブロックを表すものです。</br>
+Lines consisting of words or phrases enclosed in [] represent special blocks.</br>
-詳しくは[[Emuera/exfunc#h3-E7.89.B9.E6.AE.8A.E3.81.AA.E3.83.96.E3.83.AD.E3.83.83.E3.82.AF.E3.82.92.E8.A1.A8.E3.81.99.E8.A1.8C|こちら]]のページを参照してください。</br>
+See the page [[Emuera/exfunc#h3-E7.89.B9.E6.AE.8A.E3.81.AA.E3.83.96.E3.83.AD.E3.83.83.E3.82.AF.E3.82.92.E8.A1.A8.E3.81.99.E8.A1.8C|here]] for more information</br>
-===属性（プリプロセッサ）===
+===Property (Preprocessor)===
-関数に指定する#で始まる行で、関数の仕様や動作を決定するプリプロセッサです。</br>
+A preprocessor that determines the type and behavior of a function with a line beginning with a # specified for the function.</br>
-イベント関数の実行時の挙動を制御するための#PRI,#LATER,#SINGLE,#ONLY,</br>
+There are #PRI, #LATER, #SINGLE, and #ONLY to control the behavior of when the event function is executed,</br>
-式中関数の種別を指定するための#FUNCTION,#FUNCTIONSがあります。</br>
+and #FUNCTION and #FUNCTIONS to specify the type of the function in the expression.</br>
-===定義（プリプロセッサ）===
+===Definitions (Preprocessor)===
-#で始まる行で、変数の名前やその仕様を定義するプリプロセッサです。</br>
+A preprocessor that defines the name of a variable and its type on a line beginning with #.</br>
-関数に指定するものにはLOCAL,LOCALS変数の要素数を指定するための#LOCALSIZE,#LOCALSSIZE,</br>
+Functions include #LOCALSIZE and #LOCALSSIZE to specify the number of elements in a LOCAL or LOCALS variable,</br>
-変数を定義するための#DIM,#DIMS,　ERH中でDEFINEマクロを定義するための#DEFINEがあります。</br>
+#DIM and #DIMS to define a variable, and #DEFINE to define a DEFINE macro in the ERH.</br>
-===式中で使える関数===
+===Functions that can be used in expressions===
-式中から呼び出せる「関数」です。</br>
+It is a "function" that can be called from within an expression.</br>
-「関数」には上記の関数だけでなく、後述する組み込み関数を含みます。</br>
+The "function" includes not only the above functions but also the built-in functions described below.</br>
-多くのプログラミング言語では単に「関数」と呼ばれるものです。
+In many programming languages they are simply called "functions".
-===式中関数===
+===Functions in an Expression===
-式中で使える関数の略称です。</br>
+Abbreviation for a function that can be used in an expression.</br>
-プログラミング言語における式中関数（匿名関数）やインライン関数とは無関係です。
+It has nothing to do with inexpression functions (anonymous functions) or inline functions in programming languages.
 ===組み込み関数===

← Older revision		Revision as of 20:42, 9 April 2019
Line 1:		Line 1:
−	~~= 用語集 =~~
	当Wikiでの用語のまとめです。</br>		当Wikiでの用語のまとめです。</br>
	Emueraの拡張に伴い独自の造語が増えてきたので覚え書きとして記述してみました。</br>		Emueraの拡張に伴い独自の造語が増えてきたので覚え書きとして記述してみました。</br>