Skip to contents

Shift a vector with NA padding

Source: R/vShift.R
vShift.Rd

Shifts a vector to the left or right by k positions. Vacated positions are filled with NA.

Usage

vShift(x, k = 1L)

Arguments

x

a vector.

k

integer. Number of positions to shift. Positive values shift to the right, negative values to the left.

Value

a vector of the same length as x, shifted with NA padding.

Details

Unlike vRot(), this function does not wrap elements around. Elements shifted beyond the vector bounds are discarded.

See also

Other vector.reshape: setLength(), trim(), vRot()

Examples

vShift(1:5, 2)
#> [1] NA NA  1  2  3
# NA NA 1 2 3

vShift(1:5, -2)
#> [1]  3  4  5 NA NA
# 3 4 5 NA NA

vShift(1:5, 10)
#> [1] NA NA NA NA NA
# NA NA NA NA NA