str_pad

str_pad(string $string, int $length, [string $pad_string], [int $pad_type]): string
```php

Retorna el string `string`, completado a la derecha, a la izquierda o en ambos lados, con el string `pad_string` hasta que alcance el tamaño de `length`.

## Parámetros

`string`  
El string de entrada.

`length`  
La longitud deseada del string final completado. Si el valor de `length` es negativo, menor que, o igual al tamaño actual del string `string`, `string` se retorna sin cambios.

`pad_string`  
> [!NOTE]
> El argumento `pad_string` puede ser truncado si el número de caracteres de completado no es múltiplo del tamaño de `pad_string`.

`pad_type`  
El argumento opcional `pad_type` puede ser una de las constantes siguientes: `STR_PAD_RIGHT`, `STR_PAD_LEFT`, o `STR_PAD_BOTH`. Si `pad_type` no es especificado, toma el valor por omisión de `STR_PAD_RIGHT`.

## Valores devueltos

Retorna el string completado.

## Ejemplos

Ejemplo con `str_pad`