API Host ScriptArray

ScriptArray

用于 host 输入/输出及类 JSON 数据的动态数组对象。

命名空间：AuroraScript.Runtime.Types。种类：class。

返回 .NET Host API 参考

概述

用于 host 输入/输出及类 JSON 数据的动态数组对象。

快速参考

ScriptArray 的最小用法。

var values = new ScriptArray();
values.Push(ScriptDatum.FromNumber(42));

var first = values.GetElement(0);
Console.WriteLine(first.Number); // 42

构造函数

ScriptArray()

创建 ScriptArray 实例。

ScriptArray()

参数

无。

返回值

新的 ScriptArray 实例。

ScriptArray(int capacity)

创建 ScriptArray 实例。

ScriptArray(int capacity)

参数

名称	类型	必填	描述
capacity	int	是	初始存储容量。

返回值

新的 ScriptArray 实例。

ScriptArray(ScriptArray array)

创建 ScriptArray 实例。

ScriptArray(ScriptArray array)

参数

名称	类型	必填	描述
array	ScriptArray	是	由新实例复制或枚举的源数组或 span。

返回值

新的 ScriptArray 实例。

ScriptArray(List<ScriptObject> list)

创建 ScriptArray 实例。

ScriptArray(List<ScriptObject> list)

参数

名称	类型	必填	描述
list	List<ScriptObject>	是	复制到数组中的源对象列表。

返回值

新的 ScriptArray 实例。

ScriptArray(Span<ScriptDatum> array)

创建 ScriptArray 实例。

ScriptArray(Span<ScriptDatum> array)

参数

名称	类型	必填	描述
array	Span<ScriptDatum>	是	由新实例复制或枚举的源数组或 span。

返回值

新的 ScriptArray 实例。

ScriptArray(ScriptDatum[] array)

创建 ScriptArray 实例。

ScriptArray(ScriptDatum[] array)

参数

名称	类型	必填	描述
array	ScriptDatum[]	是	由新实例复制或枚举的源数组或 span。

返回值

新的 ScriptArray 实例。

ScriptArray(ScriptObject[] array)

创建 ScriptArray 实例。

ScriptArray(ScriptObject[] array)

参数

名称	类型	必填	描述
array	ScriptObject[]	是	由新实例复制或枚举的源数组或 span。

返回值

新的 ScriptArray 实例。

属性

Length

int Length

参数

无。

返回值

返回 int。

方法

GetElement

ScriptDatum GetElement(int index)

void GetElement(int index, ref ScriptDatum scriptDatum)

• ScriptDatum GetElement(int index)
• void GetElement(int index, ref ScriptDatum scriptDatum)

参数

名称	类型	必填	描述
index	int	是	从零开始的元素索引。
scriptDatum	ScriptDatum	视情况而定	元素值或目标，具体取决于所选签名。

返回值

返回值的重载返回所选 ScriptDatum；ref 重载将所选元素写入 scriptDatum，无返回值。

SetElement

void SetElement(int index, in ScriptDatum datum)

参数

名称	类型	必填	描述
index	int	是	从零开始的元素索引。
datum	ScriptDatum	是	元素值或目标，具体取决于所选签名。

返回值

无。

Push

void Push(ScriptDatum datum)

参数

名称	类型	必填	描述
datum	ScriptDatum	是	元素值或目标，具体取决于所选签名。

返回值

无。

Remove

void Remove(int index)

参数

名称	类型	必填	描述
index	int	是	从零开始的元素索引。

返回值

无。

Values

Span<ScriptDatum> Values()

参数

无。

返回值

返回 Span<ScriptDatum>。

ToDatumArray

ScriptDatum[] ToDatumArray()

参数

无。

返回值

返回 ScriptDatum[]。

Has

bool Has(in ScriptDatum element)

参数

名称	类型	必填	描述
element	ScriptDatum	是	签名所需的 ScriptDatum 参数。

返回值

返回 bool。

IndexOf

int IndexOf(in ScriptDatum searchElement, int? fromIndex)

参数

名称	类型	必填	描述
searchElement	ScriptDatum	是	签名所需的 ScriptDatum 参数。
fromIndex	int?	是	签名所需的 int? 参数。

返回值

返回 int。

LastIndexOf

int LastIndexOf(in ScriptDatum searchElement, int? fromIndex)

参数

名称	类型	必填	描述
searchElement	ScriptDatum	是	签名所需的 ScriptDatum 参数。
fromIndex	int?	是	签名所需的 int? 参数。

返回值

返回 int。