API Host ScriptArray

ScriptArray

用于宿主输入、输出和 JSON 风格数据的动态数组对象。

Dynamic array object used for host input/output and JSON-like data.

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

Namespace: AuroraScript.Runtime.Types. Kind: class.

返回 .NET Host API 参考

用途

ScriptArray 是公开宿主类型。通过下方签名选择调用方式；对运行时对象、生命周期和异常，应由宿主在边界处明确处理。

Dynamic array object used for host input/output and JSON-like data.

简单示例

下面是 ScriptArray 的最小使用方式。

A minimal use of ScriptArray.

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

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

成员

Constructor

签名

• ScriptArray()
• ScriptArray(int capacity)
• ScriptArray(ScriptArray array)
• ScriptArray(List<ScriptObject> list)
• ScriptArray(Span<ScriptDatum> array)
• ScriptArray(ScriptDatum[] array)
• ScriptArray(ScriptObject[] array)

创建 ScriptArray 实例。

Use the member according to its public signature.

Parameters:

• capacity
  初始预留容量。

  Initial reserved capacity.

• array
  按签名提供的 ScriptArray 参数。

  The ScriptArray parameter required by the signature.

• list
  按签名提供的 List<ScriptObject> 参数。

  The List<ScriptObject> parameter required by the signature.

Returns

新建的 ScriptArray 实例。

A new ScriptArray instance.

调用示意

以下示例展示调用形状；将占位实例和参数替换为宿主中的实际值。

The example shows the call shape; replace placeholder instances and arguments with actual host values.

var value = new ScriptArray(/* 参数 */);

int Length

读取 Length 属性。

Use the member according to its public signature.

Parameters:

• 无。

  None.

Returns

返回 int。

Returns int.

调用示意

以下示例展示调用形状；将占位实例和参数替换为宿主中的实际值。

The example shows the call shape; replace placeholder instances and arguments with actual host values.

ScriptArray value = /* 从宿主 API 获取实例 */;
var current = value.Length;

GetElement

签名

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

调用 GetElement 完成其公开操作。

Use the member according to its public signature.

Parameters:

• index
  要访问、移除或检查的零基索引。

  Zero-based index to access, remove, or inspect.

• scriptDatum
  要读取或写入的脚本值。

  Script value to read or write.

Returns

返回值取决于所选重载；请查看签名。

Return value depends on the selected overload; see the signatures.

调用示意

以下示例展示调用形状；将占位实例和参数替换为宿主中的实际值。

The example shows the call shape; replace placeholder instances and arguments with actual host values.

ScriptArray value = /* 从宿主 API 获取实例 */;
var result = value.GetElement(/* index */);

void SetElement(int index, in ScriptDatum datum)

调用 SetElement 完成其公开操作。

Use the member according to its public signature.

Parameters:

• index
  要访问、移除或检查的零基索引。

  Zero-based index to access, remove, or inspect.

• datum
  要读取或写入的脚本值。

  Script value to read or write.

Returns

无。

None.

调用示意

以下示例展示调用形状；将占位实例和参数替换为宿主中的实际值。

The example shows the call shape; replace placeholder instances and arguments with actual host values.

ScriptArray value = /* 从宿主 API 获取实例 */;
value.SetElement(/* index */, /* datum */);

void Push(ScriptDatum datum)

调用 Push 完成其公开操作。

Use the member according to its public signature.

Parameters:

• datum
  要读取或写入的脚本值。

  Script value to read or write.

Returns

无。

None.

调用示意

以下示例展示调用形状；将占位实例和参数替换为宿主中的实际值。

The example shows the call shape; replace placeholder instances and arguments with actual host values.

ScriptArray value = /* 从宿主 API 获取实例 */;
value.Push(/* datum */);

void Remove(int index)

调用 Remove 完成其公开操作。

Use the member according to its public signature.

Parameters:

• index
  要访问、移除或检查的零基索引。

  Zero-based index to access, remove, or inspect.

Returns

无。

None.

调用示意

以下示例展示调用形状；将占位实例和参数替换为宿主中的实际值。

The example shows the call shape; replace placeholder instances and arguments with actual host values.

ScriptArray value = /* 从宿主 API 获取实例 */;
value.Remove(/* index */);

Span<ScriptDatum> Values()

调用 Values 完成其公开操作。

Use the member according to its public signature.

Parameters:

• 无。

  None.

Returns

返回 Span<ScriptDatum>。

Returns Span<ScriptDatum>.

调用示意

以下示例展示调用形状；将占位实例和参数替换为宿主中的实际值。

The example shows the call shape; replace placeholder instances and arguments with actual host values.

ScriptArray value = /* 从宿主 API 获取实例 */;
var result = value.Values();

ScriptDatum[] ToDatumArray()

调用 ToDatumArray 完成其公开操作。

Use the member according to its public signature.

Parameters:

• 无。

  None.

Returns

返回 ScriptDatum[]。

Returns ScriptDatum[].

调用示意

以下示例展示调用形状；将占位实例和参数替换为宿主中的实际值。

The example shows the call shape; replace placeholder instances and arguments with actual host values.

ScriptArray value = /* 从宿主 API 获取实例 */;
var result = value.ToDatumArray();

bool Has(in ScriptDatum element)

调用 Has 完成其公开操作。

Use the member according to its public signature.

Parameters:

• element
  按签名提供的 ScriptDatum 参数。

  The ScriptDatum parameter required by the signature.

Returns

返回 bool。

Returns bool.

调用示意

以下示例展示调用形状；将占位实例和参数替换为宿主中的实际值。

The example shows the call shape; replace placeholder instances and arguments with actual host values.

ScriptArray value = /* 从宿主 API 获取实例 */;
var result = value.Has(/* element */);

int IndexOf(in ScriptDatum searchElement, int? fromIndex)

调用 IndexOf 完成其公开操作。

Use the member according to its public signature.

Parameters:

• searchElement
  按签名提供的 ScriptDatum 参数。

  The ScriptDatum parameter required by the signature.

• fromIndex
  按签名提供的 int? 参数。

  The int? parameter required by the signature.

Returns

返回 int。

Returns int.

调用示意

以下示例展示调用形状；将占位实例和参数替换为宿主中的实际值。

The example shows the call shape; replace placeholder instances and arguments with actual host values.

ScriptArray value = /* 从宿主 API 获取实例 */;
var result = value.IndexOf(/* searchElement */, /* fromIndex */);

int LastIndexOf(in ScriptDatum searchElement, int? fromIndex)

调用 LastIndexOf 完成其公开操作。

Use the member according to its public signature.

Parameters:

• searchElement
  按签名提供的 ScriptDatum 参数。

  The ScriptDatum parameter required by the signature.

• fromIndex
  按签名提供的 int? 参数。

  The int? parameter required by the signature.

Returns

返回 int。

Returns int.

调用示意

以下示例展示调用形状；将占位实例和参数替换为宿主中的实际值。

The example shows the call shape; replace placeholder instances and arguments with actual host values.

ScriptArray value = /* 从宿主 API 获取实例 */;
var result = value.LastIndexOf(/* searchElement */, /* fromIndex */);