---
title: std.strpad
summary: null
url: >-
  https://www.fastly.com/documentation/reference/vcl/functions/strings/std-strpad
---

```
STRING std.strpad(STRING s, INTEGER width, STRING pad)
```

**Available in:** all subroutines

Constructs a string containing the input string `s`, padded out 
with `pad` to produce a string of the given `width`. The padding string `pad` 
is repeated as necessary, and cut short when `width` is reached.

Note that `width` is given in bytes, and this function will cut short paddings 
with multi-byte encodings.

Negative `width` left-justifies `s` by placing padding to the right. Positive 
`width` right-justifies `s` by placing padding to the left. If `width` is less 
than or equal to the length of `s`, then no padding is performed.

If `pad` is the empty string, then no padding is performed, and the unmodified 
string `s` is returned.

## Examples

```vcl
set var.s = std.strpad("abc", -10, "-="); # produces "abc-=-=-=-"
set var.s = std.strpad("abc",  10, "-="); # produces "-=-=-=-abc"
```

Repeating a string:

```vcl
declare local var.s STRING;
declare local var.n INTEGER;
set var.n = std.strlen("abcd");
set var.n *= 3;
set var.s = std.strpad("", var.n, "abcd"); # repeat "abcd" three times
```