gdata (version 2.19.0)

case: Map elements of a vector according to the provided 'cases'

Description

Map elements of a vector according to the provided 'cases'. This function is useful for mapping discrete values to factor labels and is the vector equivalent to the switch function.

Usage

case(x, ..., default = NA)

Value

A factor variables with each element of x mapped into the corresponding level of specified in the mapping.

Arguments

x

Vector to be converted

...

Map of alternatives, specified as "name"=value

default

Value to be assigned to elements of x not matching any of the alternatives. Defaults to NA.

Author

Gregory R. Warnes

Details

This function is to switch what ifelse is to if, and is a convenience wrapper for factor.

See Also

factor, switch, ifelse

Examples

## default = NA
case( c(1,1,4,3), "a"=1, "b"=2, "c"=3)

## default = "foo"
case( c(1,1,4,3), "a"=1, "b"=2, "c"=3, default="foo" )