# string.padding 库模块帮助文档

## string 成员列表 <a id="string" href="#string">&#x23;</a>

### string.padding() <a id="string.padding" href="#string.padding">&#x23;</a>
[返回对象:stringPaddingObject](#stringPaddingObject)

### string.padding(文本,最大显示宽度,空白字符) <a id="string.padding" href="#string.padding">&#x23;</a>
参数 @1 指定需要填充与对齐的文本。  
参数 @2 必须指定最大显示宽度。  
空白字符默认为空格。

### string.padding(最大显示宽度,空白字符) <a id="string.padding" href="#string.padding">&#x23;</a>
参数 @1 必须指定最大显示宽度。  
可选用参数 @2 指定空白字符，默认为空格。

## string.padding 成员列表 <a id="string.padding" href="#string.padding">&#x23;</a>

用于填充字符串指指定宽度。  
用于创建文本化表格的 string.textTable 库内部用到了 string.padding 库。

### string.padding.len() <a id="string.padding.len" href="#string.padding.len">&#x23;</a>
计算字符串的显示宽度。  
ASCII 字符长度计为1，非 ASCII 字符长度计为 2。

## stringPaddingObject 成员列表 <a id="stringPaddingObject" href="#stringPaddingObject">&#x23;</a>

### stringPaddingObject.center() <a id="stringPaddingObject.center" href="#stringPaddingObject.center">&#x23;</a>
在字符串两侧填充空格并居中对齐并返回填充对齐后的新字符串。  

可指定多个字符串参数，每个字符串参数都会增加一个对应的返回值（字符串）。  
如果参数 @1 未指定输入字符串（ null 值 ），  
则默认取 string.padding 构造参数指定的字符串。

### stringPaddingObject.len() <a id="stringPaddingObject.len" href="#stringPaddingObject.len">&#x23;</a>
计算字符串的显示宽度。  
ASCII 字符长度计为1，非 ASCII 字符长度计为 2。

### stringPaddingObject.ljust() <a id="stringPaddingObject.ljust" href="#stringPaddingObject.ljust">&#x23;</a>
在字符串右侧填充空格并左对齐并返回填充对齐后的新字符串。  

可指定多个字符串参数，每个字符串参数都会增加一个对应的返回值（字符串）。  
如果参数 @1 未指定输入字符串（ null 值 ），  
则默认取 string.padding 构造参数指定的字符串。

### stringPaddingObject.rjust() <a id="stringPaddingObject.rjust" href="#stringPaddingObject.rjust">&#x23;</a>
在字符串左侧填充空格并右对齐并返回填充对齐后的新字符串。  

可指定多个字符串参数，每个字符串参数都会增加一个对应的返回值（字符串）。  
如果参数 @1 未指定输入字符串（ null 值 ），  
则默认取 string.padding 构造参数指定的字符串。

### stringPaddingObject.wrap() <a id="stringPaddingObject.wrap" href="#stringPaddingObject.wrap">&#x23;</a>
按行拆分字符串并返回一个数组，清除每行首尾多余的空白字符。  
如果文本超出最大显示宽度则自动换行。  

可选用参数 @1 指定输入字符串。  
如果参数 @1 未指定输入字符串（ null 值 ），  
则默认取 string.padding 构造参数指定的字符串。
