oce (version 1.5-0)

vectorShow: Show some values from a vector

Description

This is similar to str(), but it shows data at the first and last of the vector, which can be quite helpful in debugging.

Usage

vectorShow(v, msg = "", postscript = "", digits = 5, n = 2L, showNA = FALSE)

Arguments

v

the vector.

msg

optional character value indicating a message to show, introducing the vector. If not provided, then a message is created from v. If msg is a non-empty string, then that string is pasted together with a colon (unless msg already contains a colon), before pasting a summary of data values.

postscript

optional character value indicating an optional message to append at the end of the return value.

digits

for numerical values of v, this is the number of digits to use, in formatting the numbers with format(); otherwise, digits is ignored.

n

number of elements to show at start and end. If n is negative, then all the elements are shown.

showNA

logical value indicating whether to show the number of NA values. This is done only if the output contains ellipses, meaning that some values are skipped, because if all values are shown, it will be perfectly obvious whether there are any NA values.

Value

A string ending in a newline character, suitable for display with cat() or oceDebug().

Examples

# NOT RUN {
vectorShow(pi)
vectorShow(volcano)
knot2mps <- 0.5144444
vectorShow(knot2mps, postscript="knots per m/s")
vectorShow("January", msg="The first month is")

# }