Pad

Pads an array with a given value at the edges and optionally between elements.

Usage

nv_pad(x, value, low, high, interior = NULL)

Arguments

x

(arrayish)
The array to pad. Can be any data type; value is brought to it.

value

(arrayish)
Scalar value to use for padding. It is brought to x's data type: an R value is built at it when its category can reach it (0L serves an integer and a float x alike, 0 only a float one), and a value that already has a data type is converted unless that would narrow it – an f64 padding value for an f32 x is an error rather than a silent narrowing.

low

(integer())
Amount of padding to add at the start of each axis.

high

(integer())
Amount of padding to add at the end of each axis.

interior

(integer() | NULL)
Amount of padding to add between elements in each axis. If NULL (default), no interior padding is applied.

Value

(arrayish)
Has x's data type. Each axis grows by low + high, plus interior between every pair of elements; negative edge padding trims.

See also

prim_pad() for the underlying primitive.

Examples

# two zeros in front, one behind
x <- nv_array(c(1, 2, 3))
nv_pad(x, nv_scalar(0), low = 2L, high = 1L)
#> AnvlArray
#>  0
#>  0
#>  1
#>  2
#>  3
#>  0
#> [ CPUf32{6} ]