查看“Arrays”的源代码

{{version|1.10}}
数组是《钢铁雄心IV》中用以存储变量的方式，变量既可以是{{ruby|'''数字形式'''|numerical data}}的，也可以是{{ruby|'''作用域'''|scope data}}形式的。

数组在{{ruby|'''指令'''|effects}}中发挥作用，并且{{ruby|'''触发器'''|trigger}}能够从中读取数据。指令既可以使数组迭代入其他指令，也能使其数据在自身内进行迭代。

以下，使用<>括起的内容为'''数据类型'''，等号左侧的标识符为'''参数名称'''。
== 指令（Effects）==
{{SVersion|1.10}}

=== 添加到数组（add_to_array）  ===
{{SVersion|1.10}}

<pre>add_to_array = {
    array = <name>
    value = <value>
    index = <index>
}
</pre>
一旦将元素添加到数组中，就会创建一个数组。

array 是数组的名称，也是指令和触发器调用它的依据。

value 是指要加入数组的数据内容，它既可以是数字形式的（如1 或 var:my_num），也可以是作用域形式的（如GER 或 var:my_scope）。这些都是选填内容，如果不填，则会将当前作用域填入此处。

index 指数据内容应当被插入数组的哪个位置。{{ruby|'''缺省'''|default data}}（现普遍称'''默认'''）情况下，value会接续在数组最后。其他情况下，原有的数据会自动向后移位以适应插入。

这部分的简便写法是：<code>add_to_array = { <name> = <value> }</code>

=== 从数组中移除（remove_from_array） ===
{{SVersion|1.10}}

<pre>remove_from_array = {
	array = <name>
	value = <value>
	index = <index>
}
</pre>
array 是将被移除数据的数组名称。

value 是想要移除的数据内容。

index 指移除操作所选择的'''开始'''位置。

如果value和index都未定义，那么array只有最后一个元素会被移除。

这部分的简便写法是：<code>remove_from_array = { <name> = <value> }</code>

=== 清空数组（clear_array） ===
{{SVersion|1.10}}

<pre>clear_array = <name></pre>

清空指定数组。

=== 重置数组规模（resize_array） ===
{{SVersion|1.10}}

<pre>resize_array = {
	array = <name>
	value = <value>
	size = <int>
}
</pre>
重置特定数组array的规模（size）。

如果扩大现有数组的规模，多出来的新元素将被置为value；如果缩小现有数组的规模，则自index=size开始的元素将被丢弃。

这部分的简便写法是： <code>resize_array = { <name> = <size> }</code>

===while循环指令（while_loop_effect）===
{{SVersion|1.10}}

<pre>
while_loop_effect = {
	break = <string>
	limit = { <triggers> }
	
	<effects>
}
</pre>
对指定数组进行有条件的循环操作。只要limit为真，就重复执行指令组（用花括号括起的指令集合）。

break接受一个{{ruby|'''临时变量'''|temp variable}}，当传递给break的变量取值为'''非0'''时，迭代将结束。缺省情况下，break接受的变量名为 <code>break</code>。break无法在本指令之外被访问。

本指令接受指令组作为其参数，以指定对数组元素进行的操作。

该指令会隐性地将当前数组array作为参数。

===for each循环指令（for_each_loop）===
{{SVersion|1.10}}

<pre>
for_each_loop = {
	array = <name>
	value = <string>
	index = <string>
	break = <string>
	
	<effects>
}
</pre>
对指定数组中的每个元素调用指令组。

value指定了一个临时变量，指向迭代过程中的当前元素，缺省值为<code>v</code>。

index指定了一个临时变量，指向迭代过程中的当前位置，缺省值为<code>i</code>。

break后应分配一个'''非零'''临时变量以结束迭代，缺省值为<code>break</code>。

在此循环中可以写入指令执行某些操作，并隐性地以当前数组为参数

===for each作用域循环指令（for_each_scope_loop）===
{{SVersion|1.10}}

<pre>
for_each_scope_loop = {
	array = <name>
	break = <string>
	
	<effects>
}
</pre>
对指定数组中的每个元素调用指令组，并且在每次调用时将当前作用域更改为当前元素。

break后应分配一个'''非零'''临时变量以结束迭代，缺省值为<code>break</code>。

在此循环中可以写入指令执行某些操作，并隐性地以当前数组为参数

===随机作用域指令（random_scope_in_array） ===
{{SVersion|1.10}}

<pre>
random_scope_in_array = {
	array = <name>
	break = <string>
	limit = { <triggers> }
	
	<effects>
}
</pre>
对特定的数组中的每一变量进行循环操作，并在每次迭代时将当前作用域改为随机作用域（当前数组内的一个随机的、不同于当前作用域的变量）。

break后应分配一个'''非零'''临时变量以结束迭代，缺省值为<code>break</code>。

在此循环中可以写入指令执行某些操作，所用的数据内容应均在array内。

===添加到临时数组（add_to_temp_array）===
{{SVersion|1.10}}

与<code>add_to_array</code>代码相同，但存储对象为临时数组，此数组在脚本结束后就会消失。

===从临时数组中移除（remove_from_temp_array）===
{{SVersion|1.10}}

与<code>remove_from_array</code> 代码相同，但存储对象为临时数组，此数组在脚本结束后就会消失。

===清空临时数组（clear_temp_array）===
{{SVersion|1.10}}

与<code>clear_array </code> 代码相同，但存储对象为临时数组，此数组在脚本结束后就会消失。

===重置临时数组规模（resize_temp_array）===
{{SVersion|1.10}}

与<code>resize_array</code> 代码相同，但存储对象为临时数组，此数组在脚本结束后就会消失。

==触发器（Triggers）==
{{SVersion|1.10}}

===包含关系（is_in_array）===
{{SVersion|1.10}}

<pre>
is_in_array = {
	array = <name>
	value = <value>
}
</pre>

检测指定数组array是否含有指定元素value。

===存在量词（any_of）===
{{SVersion|1.10}}

<pre>
any_of = {
	array = <name>
	value = <string>
	index = <string>
	
	<triggers>
}
</pre>
对指定数组内的每一元素调用<triggers>并比较触发器输出和元素值。如果任一比较结果值为真则触发器输出为真，否则为假。

===全称量词（all_of） ===
{{SVersion|1.10}}

<pre>
all_of = {
	array = <name>
	value = <string>
	index = <string>
	
	<triggers>
}
</pre>
对指定数组内的每一元素调用<triggers>并比较触发器输出和元素值。如果任一比较结果值为假则触发器输出为假，否则为真。

===作用域存在量词（any_of_scopes）===
{{SVersion|1.10}}

<pre>
any_of_scopes = {
	array = <name>
	
	<triggers>
}
</pre>
对指定数组进行循环操作，将<triggers>与当前作用域进行比较，如果任一返回值为真则触发器输出为真，否则为假。

===作用域全称量词（all_of_scopes）===
{{SVersion|1.10}}

<pre>
all_of_scopes = {
	array = <name>
	
	<triggers>
}
</pre>

对指定数组进行循环操作，将<triggers>与当前作用域进行比较，如果任一返回值为假则触发器输出为假，否则为真。

==附加信息==
{{SVersion|1.10}}
你可以将某数组内变量的数目输出出来，只需要这么写：<code>set_variable = { var_name = array_name^num }</code> 。

== 例子 ==
{{SVersion|1.10}}

{{Modding navbox}}
[[分类:Modding]]