R: Pad a string.

str_pad {stringr} | R Documentation

## Pad a string.

### Description

Vectorised over `string`, `width` and `pad`.

### Usage

    str_pad(string, width, side = c("left", "right", "both"), pad = " ")

### Arguments

`string` | A character vector.
`width` | Minimum width of padded strings.
`side` | Side on which padding character is added (left, right or both).
`pad` | Single padding character (default is a space).

### Value

A character vector.

### See Also

`str_trim()` to remove whitespace; `str_trunc()` to decrease the maximum width of a string.

### Examples

    rbind(
      str_pad("hadley", 30, "left"),
      str_pad("hadley", 30, "right"),
      str_pad("hadley", 30, "both")
    )

    # All arguments are vectorised except side
    str_pad(c("a", "abc", "abcdef"), 10)
    str_pad("a", c(5, 10, 20))
    str_pad("a", 10, pad = c("-", "_", " "))

    # Longer strings are returned unchanged
    str_pad("hadley", 3)

[Package stringr version 1.3.1 Index]