> ## 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 中修剪、填充、对齐和换行字符串值中空白的格式化器。

## center(integer\_width\[, character])

返回属性值，使其在第一个参数指定宽度的字符串中居中。填充使用第二个参数指定的 *fillchar* 完成。

* **width**：输出字符串的总宽度。
* **character**：可选的用于填充的字符。默认值为空格。

## expandtabs(\[integer\_width])

将属性值中的所有制表符替换为空格。如果未给出参数指定的制表符大小，则使用默认的 8 个字符制表符大小。

* **width**：可选的制表符宽度。默认值为 8 个字符。

## just(integer\_width\[, character])

返回属性值，使其在第一个参数指定长度的字符串中左对齐。填充使用第二个参数指定的 *fillchar* 完成。

* **width**：输出字符串的总宽度。
* **character**：可选的用于填充的字符。默认值为空格。

## ljust(integer\_width\[, character])

返回属性值，使其在第一个参数指定长度的字符串中左对齐。填充使用第二个参数指定的 *fillchar* 完成。

* **width**：输出字符串的总宽度。
* **character**：可选的用于填充的字符。默认值为空格。

## nowhitespace()

删除属性值所表示字符串中的空白。

## rjust(integer\_width\[, character])

返回右对齐的属性值，使其位于第二个参数指定长度的字符串中。填充使用第一个参数指定的 *fillchar* 完成。

* **width**：输出字符串的总宽度。
* **character**：可选的用于填充的字符。默认值为空格。

## trim()

删除输入字符串中的前导和尾随空白。

### 示例

```xml theme={null}
<arc:set attr="uglyString" value="    here is some data.  " />
<arc:set attr="prettyString" value="[uglyString | trim()]" />
```

## trimend()

删除属性的尾随空白。

## trimstart()

删除属性的前导空白。

## wordwrap(\[integer\_width]\[, break]\[, cut]\[, wrapexp])

在遵循单词边界的同时，将字符串换行到指定宽度。

* **width**：换行后字符串的最大行长度。
* **break**：用于断开字符串的字符。默认值为 *CRLF*（例如 `rn`）。
* **cut**：可选布尔值，指定是在指定宽度处换行还是在指定宽度之前换行。默认值为 `false`。
* **wrapexp**：一个正则表达式，表示断开字符串时要替换的字符。默认值为空格（此默认值适用于由空格分隔的单词组成的字符串）。若要不遵循单词边界而断开字符串，请将此参数设置为空字符串：` `
