pad

为字符串添加前导或尾随字符

全页折叠

语法

newStr = pad(str)
newStr = pad(str,numberOfCharacters)
newStr = pad(str,side)
newStr = pad(str,numberOfCharacters,side)
newStr = pad(___,padCharacter)

说明

newStr = pad(str) 在 str 中各字符串的末尾添加空白字符，但最长的字符串除外。

  • 如果 str 是包含多个元素的字符串数组或字符向量元胞数组，则 pad 会添加空白字符。newStr 中所有字符串的长度都与 str 中最长的元素相同。

  • 如果 str 是字符向量，或者是具有一个元素的字符串数组或字符向量元胞数组，则 pad 会原样返回 str。

示例

newStr = pad(str,numberOfCharacters) 添加空白字符，使 newStr 中的字符串具有 numberOfCharacters 指定的长度。如果 str 中的任何字符串的字符数超过 numberOfCharacters，则 pad 不会修改它们。

示例

newStr = pad(str,side) 在 side 指定的一侧添加空格字符。side 参量可以是 'left'、'right' 或 'both'。

示例

newStr = pad(str,numberOfCharacters,side) 在 side 指定的一侧添加空格字符，使其达到 numberOfCharacters 所指定的长度。

newStr = pad(___,padCharacter) 使用 padCharacter 指定的字符（而不是空白字符）来填充字符串。您可以使用上述语法中的任何输入参量。

如果 str 只包含一段文本，则 pad(str,padCharacter) 返回未更改的 str。

示例

示例

全部折叠

打开实时脚本

创建一个字符串数组。 

str = ["Mercury","Gemini","Apollo";
       "Skylab","Skylab B","ISS"]
str = 2×3 string
    "Mercury"    "Gemini"      "Apollo"
    "Skylab"     "Skylab B"    "ISS"

用空白字符填充 str 的元素。

newStr = pad(str)
newStr = 2×3 string
    "Mercury "    "Gemini  "    "Apollo  "
    "Skylab  "    "Skylab B"    "ISS     "
打开实时脚本

创建一个字符串数组。 

str = ["Mercury","Gemini","Apollo";
       "Skylab","Skylab B","ISS"]
str = 2×3 string
    "Mercury"    "Gemini"      "Apollo"
    "Skylab"     "Skylab B"    "ISS"

指定长度，使得即便是最长的字符串也要使用空格填充。

newStr = pad(str,12)
newStr = 2×3 string
    "Mercury     "    "Gemini      "    "Apollo      "
    "Skylab      "    "Skylab B    "    "ISS         "
打开实时脚本

创建一个字符串数组。 

str = ["Mary";"Elizabeth";"James"]
str = 3×1 string
    "Mary"
    "Elizabeth"
    "James"

填充字符串左侧。

newStr = pad(str,'left')
newStr = 3×1 string
    "     Mary"
    "Elizabeth"
    "    James"

在两侧填充。

newStr = pad(str,'both')
newStr = 3×1 string
    "  Mary   "
    "Elizabeth"
    "  James  "
打开实时脚本

创建一个表示数字的字符串数组，并用前导零（而不是空格字符）填充字符串。

A = [69.45 31.71 95.36 3.44 7.82];
A = A';
str = string(A)
str = 5×1 string
    "69.45"
    "31.71"
    "95.36"
    "3.44"
    "7.82"


newStr = pad(str,7,'left','0')
newStr = 5×1 string
    "0069.45"
    "0031.71"
    "0095.36"
    "0003.44"
    "0007.82"

输入参数

全部折叠

输入文本，指定为字符串数组、字符向量或字符向量元胞数组。

数据类型: string | char | cell

输出字符串中的字符总数，指定为正整数。

数据类型: double | single | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

要填充的字符串侧，指定为 'left'、'right' 或 'both'。默认行为是在字符串右侧进行填充。

数据类型: char | string

要填充的字符，指定为一个字符或包含一个字符的字符串。

数据类型: char | string

输出参量

全部折叠

输出文本，以字符串数组、字符向量或字符向量元胞数组形式返回。str 和 newStr 是相同的数据类型。

数据类型: string | char | cell

扩展功能

全部展开

版本历史记录

在 R2016b 中推出

另请参阅

| | | | |

主题