Convert an R Object to a Character String or Test for a... (original) (raw)
| toString {base} | R Documentation |
|---|
Description
is.string(x) is checking if x is a “string”, i.e., a[character](../../base/help/character.html) vector of length(x) == 1.
toString() is a helper function for [format](../../base/help/format.html) to produce a single character string describing an R object.
Usage
is.string(x)
toString(x, ...)
## Default S3 method:
toString(x, width = NULL, collapse=", ", ...)
Arguments
| x | the R object to be converted. |
|---|---|
| width | Suggestion for the maximum field width. Values ofNULL or 0 indicate no maximum. The minimum value accepted is 6 and smaller values are taken as 6. |
| collapse | passed to paste(x, *) when concatenating elements. |
| ... | optional arguments passed to or from methods. |
Details
toString is a generic function for which methods can be written: only the default method is described here. Most methods should honor thewidth argument to specify the maximum display width (as measured by [nchar](../../base/help/nchar.html)(type = "width")) of the result.
The default method first converts x to character and then concatenates the elements separated by collapse, by default, ", ". If width is supplied and is not NULL, the default method returns the first width - 4 characters of the result with.... appended, if the full result would use more thanwidth characters.
Value
is.string() returns TRUE or FALSE.
toString(.) returns a ‘string’, i.e., a[character](../../base/help/character.html) vector of length 1.
Author(s)
Robert Gentleman
See Also
[format](../../base/help/format.html)
Examples
x <- c("a", "b", "aaaaaaaaaaa")
toString(x)
toString(x, width = 8)
is.string(x) # FALSE : a character vector of length 3
is.string(x[1]) # TRUE
is.string("") # TRUE
is.string(NA_character_) # TRUE
is.string(character(0)) # FALSE
stopifnot(!is.string(x), !is.string(character()), is.string("abc"), is.string(x[1]))
[Package _base_ version 4.6.0 Index]