Skip to contents

Concatenate x to a string with quoted elements.

Source: R/paste_quoted.R
paste_quoted.Rd

Concatenate a vector or factor to a string with quoted elements.

Usage

paste_quoted(x)

Arguments

x

Vector or factor to be converted to a character string.

Value

A character string consisting of the elements of x surrounded by single quotes, separated by commas. See details on handling of some special values.

Details

paste_quoted() returns NULL as "'NULL'", other zero-length objects as "'<class>(0)'" (e.g., "'logical(0)'"), "" as '""', and non-logical NAs as "'NA_<class>_'" (e.g., "'NA_real_'"; for factors this is "'NA_character_'").

Notes

An error occurs if multiple arguments are provided because then x probably was accidentally not combined. For example, the call paste_quoted("a", "b") will return the error unused argument ("b"). The probably intended call is paste_quoted(c("a", "b")), returning "'a', 'b'".

See also

toString() which can be used instead of paste(x, collapse = ", ") sQuote() paste0() progutils::unpaste_unquote() for the approximate opposite of paste_quoted()

Examples

paste_quoted(c(3, 4)) # "'3', '4'"
#> [1] "'3', '4'"
paste_quoted(NULL) # "'NULL'"
#> [1] "'NULL'"
paste_quoted(c(a = 3, b = 4)) # "'3', '4'" # Warns about dropping names.
#> Warning: 'x' has names, these will be discarded.
#> Use progutils::vect_to_char() instead of  paste_quoted() to preserve names of numeric 'x'.
#> [1] "'3', '4'"