# padStart

Source: https://taxilang.org/docs/language/stdlib/padStart

**Full name:** `taxi.stdlib.padStart`

## Signature

```taxi
declare extension function padStart(input: String, length: Int, padWith: String):String
```

## Description

Pads the string to the specified total `length` by prepending `padWith` characters at the start.

`padWith` should be a single character — if multiple characters are passed, only the first is used.

```taxi
find { order: Order } as {
   paddedId: String = order.id.padStart(8, '0')
}
```

## Examples

Zero-pads a short string to the target length from the left.

Query:

```taxi
find {
   padded: String = padStart('42', 6, '0')
}
```

Result:

```json
{
  "padded": "000042"
}
```
