Documentación offline PHP master

mb_str_pad

master Ver versión oficial en línea Licencia CC-BY-3.0Descargado el 2026-08-02

En esta página

mb_str_pad

Rellena una cadena multibyte hasta una cierta longitud con otra cadena multibyte

Descripción#

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

Esta función devuelve el `string` rellenado por la izquierda, la derecha o ambos lados hasta la longitud de relleno especificada, donde la longitud se mide en puntos de código Unicode. Si el argumento opcional `pad_string` no se proporciona, el `string` se rellena con espacios, de lo contrario se rellena con caracteres de `pad_string` hasta el límite.

## Parámetros

`string`  
La cadena de entrada.

`length`  
Si el valor de `length` es negativo, inferior o igual a la longitud de la cadena de entrada, no se realiza ningún relleno y `string` será devuelto.

`pad_string`  
> [!NOTE]
> El `pad_string` puede ser truncado si el número requerido de caracteres de relleno no puede ser dividido equitativamente por la longitud del `pad_string`.

`pad_type`  
El argumento opcional `pad_type` puede ser `STR_PAD_RIGHT`, `STR_PAD_LEFT`, o `STR_PAD_BOTH`. Por omisión `STR_PAD_RIGHT`.

`encoding`  
El parámetro `encoding` es la codificación de caracteres. Si se omite o es `null`, se utilizará el valor de la codificación de caracteres interna.

## Valores devueltos

Devuelve la cadena rellenada.

## Ejemplos

Ejemplo de `mb_str_pad`

```php