Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / PHP

str_pad()

Preenche até um comprimento mínimo em bytes à esquerda, direita ou ambos os lados.

Versão: PHP 8.4; repository runtime, production runtime not attested

Sintaxe

str_pad(string $string, int $length, string $pad_string = " ", int $pad_type = STR_PAD_RIGHT): string

Preenche até um comprimento mínimo em bytes à esquerda, direita ou ambos os lados. Pode cortar um caráter multibyte do enchimento. Num enchimento bilateral ímpar o byte adicional vai à direita. Um enchimento vazio gera ValueError apenas se for preciso acrescentar bytes. Caso contrário devolve a cadeia original.

Assinatura

str_pad(string $string, int $length, string $pad_string = " ", int $pad_type = STR_PAD_RIGHT): string

Saída do exemplo

[".X..","long","c3"]

Exemplos

<?php
echo json_encode([str_pad("X",4,".",STR_PAD_BOTH),str_pad("long",2,""),bin2hex(str_pad("",1,"\u{00E9}"))]);

Resultado

[".X..","long","c3"]

Fontes