R.utils (version 2.1.0)

Arguments$getCharacters: Coerces to a character vector and validates

Description

Coerces to a character vector and validates.

Usage

## Static method (use this):
## Arguments$getCharacters(s, length=NULL, trim=FALSE, nchar=NULL, useNames=TRUE,
##   asGString=getOption("Arguments$getCharacters/args/asGString", TRUE), .name=NULL,
##   ...)

## Don't use the below: ## S3 method for class 'Arguments': getCharacters(static, s, length=NULL, trim=FALSE, nchar=NULL, useNames=TRUE, asGString=getOption("Arguments$getCharacters/args/asGString", TRUE), .name=NULL, ...)

Arguments

s
nchar
A numeric vector of length one or two. If one, the maximum number of characters ("length") in s. If two, the minimum and maximum
useNames
If TRUE, the 'names' attribute is preserved, otherwise it is dropped.
asGString
If TRUE, each string is treated as a GString.
.name
A character string for name used in error messages.
...
Not used.

Value

  • Returns a character vector, if it is valid. Otherwise an exception is thrown.

Missing values

If s contains missing values, and nchar is not NULL, then an exception is thrown.

See Also

For more information see Arguments.