头文件(ERH)

翻译自原文档:https://osdn.net/projects/emuera/wiki/ERH

除了扩展名为ERB的文件外,ERB文件夹还可以包含扩展名为ERH的文件。

ERH文件包含必须在ERB之前处理的信息,即用#DIM#DIMS定义广域变量,用#DEFINE定义宏。

除了#DIM#DIMS#DEFINE之外,标题中不应该有其他行。

Emuera 读取所有放在ERB文件夹中的*.ERH文件。

处理的顺序是csv文件夹中的文件-> *.ERH -> *.ERB,所以ERH的效果与CSV文件夹中的描述不一样。

反之,由_rename.csv进行的替换也将适用于*.ERH

由于eramakerEX没有对ERH应用_rename.csv,所以 EramakerEX 与 ERH 不兼容。

广域变量的定义

另请参见用户定义的变量

在头文件中,可以声明新的变量。

与在ERB中声明的私有变量不同,这将是一个广域变量,可以从ERB的所有点引用。

与私有变量不同,DYNAMICSTATIC变量之间没有区别,不可能使用REF来声明引用类型的变量,但是使用CONST的常量可以以同样的方式声明。

你可以声明多达三个维度的变量。

如果没有指定元素的数量,该变量就会变成一个有一个元素的数组,所以它可以像非数组变量一样使用。

变量可以用#DIM#DIMS来声明,如下所示。

如果使用#DIM HOGE,1,2,它就会变成一个二维数组。

*.erh中:

#DIM MY_INT
#DIM MY_INT_ARRAY, 100
#DIMS MY_STR
#DIMS MY_STR_ARRAY, 100
1
2
3
4

通过在ERH中定义上述内容,就有可能在ERB中定义:

MY_INT = 100
MY_INT_ARRAY:10 = MY_INT_ARRAY:10 + 45
MY_STR = AAA
PRINTFORML {MY_INT_ARRAY:10} %MY_STR%
1
2
3
4

可以作为一个变量使用。

在使用#DIM的变量声明中,元素的数量可以被指定为一个数字或一个常量表达。

然而,请注意,与*.ERB中的#DIM不同,该宏没有被扩展。

SAVEDATA 关键字

你可以在声明一个变量时加入SAVEDATA关键字来声明该变量被保存。

然而,当声明一个可以使用SAVEDATA关键字保存的多维变量时,必须启用以二进制格式保存保存的数据选项。

在ERH中:

#DIM SAVEDATA MY_INT_ARRAY, 100
#DIMS SAVEDATA MY_STR_ARRAY, 100
1
2

通过这样的声明,MY_INT_ARRAYMY_STR_ARRAY的内容将以与现有变量(如DAYMONEY)相同的方式保存和加载。

反之,没有SAVEDATA关键字的变量声明将不会被保存,而在加载时将被初始化。

CHARADATA 关键字

可以通过在变量声明中添加CHARADATA关键字来声明字符变量。

CHARADATA可以和SAVEDATA关键字一起使用。

在 ERH 中:

#DIM CHARADATA C_INT_ARRAY, 100
#DIMS CHARADATA C_STR_ARRAY, 100
#DIM CHARADATA SAVEDATA CS_INT_ARRAY, 100
1
2
3

在上面的例子中,C_INT_ARRAYC_STR_ARRAY是字符变量,但没有被保存和加载。

CS_INT_ARRAY是一个字符变量,可以被保存和加载。

GLOBAL 关键字

你可以通过在变量声明中加入GLOBAL关键字来声明一个全局变量。

GLOBAL可以和SAVEDATA关键字一起使用。

在 ERH 中:

#DIM GLOBAL G_INT_ARRAY, 100
#DIMS GLOBAL G_STR_ARRAY, 100
#DIM GLOBAL SAVEDATA GS_INT_ARRAY, 100
1
2
3

在正常的保存加载过程中,全局变量不被加载或初始化。

由于这一特性,它们可以被用来在不同的保存数据之间共享数据。

如果同时使用GLOBALSAVEDATA关键字,变量将被SAVEGLOBALLOADGLOBAL指令读写到global.sav文件。

关于其他细节,如初始值和常量化,请参见用户定义的变量

宏的定义

宏是一个函数,它将 ERB 代码中的一串字符替换为另一个预先定义的字符串。

虽然它被称为宏,但它与 Emuera 运行时可使用F1-F12键的键盘宏没有关系。

这个函数是基于 C 和 C++ 的#define

通过在 ERH 文件中定义宏,它适用于所有 ERB 文件中的代码。

基本用法

一个宏通常定义如下:

#DEFINE <替换源标识符> <替换目标表达式>
1

这将用 ERB 中的<替换源标识符>替换<替换目标表达式>。例如,在 ERH 中:

#DEFINE FIVE 5
1

那么 ERB 中的字符串FIVE将被替换成5。例如,如果你定义:

X = FIVE
1

替换后:

X = 5
1

一个宏也可以有行末注释。

分号后的任何内容都会作为注释被忽略。

分号之后的内容不包括在宏中,也不会被展开。

;ERH
#DEFINE FIVE 5 ;注释

;ERB
X = FIVE + FIVE

;运行时
X = 5 + 5
1
2
3
4
5
6
7
8

请注意,宏的扩展几乎是作为一个字符串来完成的。

;ERH
#DEFINE SIX           1 + 5
#DEFINE NINE          8 + 1

;ERB
X = SIX * NINE
1
2
3
4
5
6

你可能认为6*9或36将被分配给X,但事实上:

X = 1 + 5 * 8 + 1
1

所以乘法优先,得到X=42。

宏可以扩展为一个常数字符串,如~~,或扩展为一个变量、函数或表达式。

这个宏也可以扩展成一个常量字符串,比如~~,或者扩展成一个变量、函数或表达式,所以如果你把它看作是扩展#DEFINE右边的字符串,你就会明白这个意思。

;ERH
#DEFINE HOGE        "嘿嘿嘿嘿"
#DEFINE PIYO        A
#DEFINE FUGA        DA:10
#DEFINE HOGERA      LOCAL + MY_FUNC(X, Y)

;ERB
X = STRLEN(HOGE)
Y = PIYO + 5
FUGA:20 += PIYO
LOCAL = HOGERA

@MY_FUNC(ARG, ARG:1)
#FUNCTION

;运行时
X = STRLEN("嘿嘿嘿嘿")
Y = A + 5
DA:10:20 += A
LOCAL = LOCAL + MY_FUNC(X, Y)

@MY_FUNC(ARG, ARG:1)
#FUNCTION
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23

由于宏被扩展为字符串,因此替换有可能是运算符或表达式的一部分,而不是一个完整的表达式。

然而,不建议使用这种方法。

如果不仔细使用,会严重破坏代码的可读性。

;ERH
#DEFINE PLUS       +
#DEFINE FIVEPLUS   5 +

;ERB
X = 1 PLUS 2
Y = FIVEPLUS 2

;运行时
X = 1 + 2
Y = 5 + 2
1
2
3
4
5
6
7
8
9
10
11

多重宏替换

可以定义包含巨集的宏。这样的宏将被倍数展开,直到加载 ERB 时宏不能再被应用。

;ERH
#DEFINE FIVE_1 5
#DEFINE FIVE_2 FIVE_1 + FIVE_1
#DEFINE FIVE_3 FIVE_2 + FIVE_2

;ERB
X = FIVE_3

;运行时
X = 5 + 5 + 5 + 5
1
2
3
4
5
6
7
8
9
10

如果该宏在一定数量的扩展后仍然存在,Emuera 将作为一个疑似自引用或循环引用的宏终止进程,并以错误退出。

请注意不要创建自我参照或循环的宏,如以下内容。

;ERH
#DEFINE HOGE HOGE
#DEFINE PIYO FUGA + 1
#DEFINE FUGA PIYO + 2

;ERB(会报错)
X = HOGE
Y = PIYO
1
2
3
4
5
6
7
8

预处理程序

可以根据是否定义了某一名称的宏,分割执行多行。

只有当XXX是DEFINE时,[IF XXX][ENDIF]行之间的行才会被执行。例如,你可以使用以下方法:

;ERB
[IF HOGE]
  PRINTL HOGEが定義されている
[ELSEIF PUYO]
  PRINTL HOGEが定義されていない
  PRINTL PUYOが定義されている
[ELSE]
  PRINTL HOGEもPUYOも定義されていない
[ENDIF]
1
2
3
4
5
6
7
8
9

为此,你也可以定义空宏(没有替换目标的宏)。

;ERH
#DEFINE HOGE
1
2

宏的限制条件

宏基本上只在表达式中部署。

;ERH
#DEFINE FIVE 5

;ERB
PRINT FIVE
1
2
3
4
5

简单地打印出字符FIVE

这与PRINT X相同,它只打印字母X,而不是X的值。

宏替换不能是一个赋值运算符或包含赋值运算符的表达式。

下面的宏定义将导致一个错误:

;ERH(会报错)
#DEFINE HOGE =
#DEFINE PUGE X = 1
1
2
3

我提到,宏可以在表达式中替换,但在宏中只需完成括号对应。下面的宏定义将导致一个错误:

;ERH(会报错)
#DEFINE HOGE ( X +
#DEFINE PUGE Y )

;ERB
Z = HOGE PUGE
1
2
3
4
5
6

不可能将一个宏替换成一条指令。

下面的宏定义将导致一个错误:

;ERH
#DEFINE MY_PRINTL     PRINTL

;ERB
MY_PRINTL 这是PRINTL

;运行时
;会报错
1
2
3
4
5
6
7
8

如上所述,该宏只适用于*.ERB,不适用于*.csv*.ERH

ERB,但不包括*.csv*.ERH,也不包括预处理程序、属性名称或行首。

[SKIPSTART]等,#DIM#FUNCTION等,以及@EVENTFIRST@部分等,都不被替换。

例如,#DEFINE HOGE SKIPSTART并不以[HOGE]开始注释。

然而,即使是#后面的字符串,如#DIM的变量名,也可以被替换。

例如,下面的代码:

;ERH
#DEFINE HOGE MY_INT
#DEFINE FIVE 5

;ERB
@FUNC
#DIM HOGE, FIVE
HOGE:0 = 10

;运行时
@FUNC
#DIM MY_INT, 5
MY_INT:0 = 10
1
2
3
4
5
6
7
8
9
10
11
12
13

就工作正常。

Last Updated: 2021/9/30 上午5:06:17
Contributors: Miswanting