> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kasoftware.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 陣列格式化器

> ArcScript 中用於處理陣列屬性的格式化器，可跨多個陣列元素傳回聚合值或搜尋值。

export const siteNameShort = "知行之橋";

以下格式化器期望陣列屬性作為輸入。陣列屬性是專案上分配有多個值的單個屬性。ArcScript 中的陣列屬性在屬性末尾用井號 (`#`) 表示（例如 `tmp.myarrayitem#`）。有關詳細資訊，請參閱[選擇屬性值](../operations/operations)。

<Note>
  * 將陣列屬性傳遞給這些格式化器時，不需要 `#` 符號。
  * 某些格式化器的可選參數周圍的方括號不是必需的；它們僅用於表示該參數是可選的。
</Note>

## arrayaverage(\[integer\_rounding\_mode]\[decimal\_places])

傳回屬性陣列元素的平均值。

* **rounding\_mode**：指定可能丟棄精度的數值運算的舍入行為。可接受的值包括：`ToEven`、`AwayFromZero`、`ToZero`、`ToNegativeInfinity`、`ToPositiveInfinity`。預設舍入策略取決於作業系統。.NET 使用 <a href="https://learn.microsoft.com/en-us/dotnet/api/system.midpointrounding?view=net-6.0" target="_blank">ToEven</a>，Java 使用 <a href="https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/math/RoundingMode.html#HALF_EVEN" target="_blank">Half Even</a>。

還可以指定全域 `RoundingMode` 環境變數，並將其中一個 `rounding_mode` 值作為其值。這樣做時，只要格式化器中未明確指定 `rounding_mode`，{siteNameShort} 就會使用該舍入模式。更具體地說，{siteNameShort} 會按以下順序檢查值：

1. `rounding_mode` 輸入
2. `RoundingMode` 環境變數
3. 如上所述，由作業系統確定的預設值

## arrayfind(substring)

傳回在屬性陣列中找到對應字串的索引。索引從 1 開始。

* **searchstring**：在原始值中搜尋的字串。

## count(substring)

傳回屬性值中第一個參數指定的子字串的出現次數。

* **substring**：要在屬性值中搜尋的子字串。

## endswith(substring\[, iftrue]\[, iffalse])

確定屬性值是否以指定參數結尾。如果屬性以該值結尾，則傳回 *true*（或 *iftrue*）；否則傳回 *false*（或 *iffalse*）。

* **substring**：預期出現在結尾處的字串。
* **iftrue**：如果屬性值以參數值結尾，則傳回的可選值。
* **iffalse**：如果屬性值不以參數值結尾，則傳回的可選值。

## implode(\[separator])

將多個值組合為一個由分隔符號分隔的字串。

* **separator**：可選的分隔符號。

## join(\[separator])

將多個值連線為一個由分隔符號分隔的字串。

* **separator**：可選的分隔符號。

## match(pattern\[, index]\[, option])

在屬性值所表示的字串中搜尋 *pattern* 參數提供的規則運算式。

* **pattern**：要匹配的規則運算式模式。
* **index**：要傳回的匹配項的可選編號索引。預設值為 `0`。
* **option**：可選的逗號分隔規則運算式選項清單。常用選項包括 IgnoreCase、Multiline、Singleline 和 IgnorePatternWhitespace。

## print(\[delim])

傳回一個字串，其中屬性的所有值使用指定分隔符號連線在一起。

* **delim**：用於分隔值的可選分隔符號。預設值為逗號。