# LPAD

Utiliza una cadena de relleno proporcionada para rellenar una cadena por la izquierda hasta un tamaño determinado.

## Sintaxis

```
LPAD(STRING, SIZE, PADSTRING)
```

## Argumentos

#### STRING

Tipo: `string`

La cadena que se va a rellenar.

#### SIZE

Tipo: `bigint`

Un entero no negativo que especifica la longitud de la cadena resultante.

#### PADSTRING

Tipo: `string`

La cadena que se usará para el relleno. No debe estar vacío.

## Devuelve

Tipo: `string`

`STRING` rellenado por la izquierda hasta `SIZE` con `PADSTRING`.

Si `SIZE` es menor que la longitud de `STRING`, el resultado se trunca a `SIZE` caracteres.

***

## Ejemplos

| STRING | SIZE | PADSTRING | Resultado |
| --- | --- | --- | --- |
| Call me Ishmael. Some years ago | 7 |  | Call me |
| drizzly November | 16 | . | drizzly November |
| right | 1 |  | r |
| what | 9 | ?! | ?!?!?what |
| `null` | 9 | `''` | `null` |
| hi | 5 | five | fivhi |
| hi | 10 | five | fivefivehi |