pad

Acrescenta espaços no início ou no fim de um texto.

Categoria: Language Fundamentals > Data Types

Sintaxe

newStr = pad(str)

Preenche cada elemento à direita até o comprimento do maior.

newStr = pad(str, n)

Preenche até pelo menos n caracteres.

newStr = pad(str, side)

Preenche no lado indicado: 'left', 'right' (padrão) ou 'both'.

newStr = pad(str, n, side)

Combina os dois.

Descrição

pad só aumenta o texto; nunca o trunca. Sem o argumento de comprimento, deixa todos os elementos de um string array com a mesma largura, o que ajuda a alinhar a saída.

Argumentos de entrada

str
String array, vetor de caracteres ou cell array de vetores de caracteres.
n
Comprimento desejado em caracteres.
side
'left', 'right' ou 'both'.

Argumentos de saída

newStr
Texto do mesmo tipo de str. Elementos já longos o bastante ficam inalterados.

Exemplo

pad("abc", 6) + "|"
pad("abc", 6, 'left') + "|"
pad(["a", "bbb"]) + "|"
Saída
ans = "abc   |"
ans = "   abc|"
ans = 1×2 string array

    "a  |"    "bbb|"

Veja também

strtrim strjust blanks extractBefore sprintf