erase {datastructures}R Documentation

Erase an entry from a map

Description

Erase a vector of key-value pair from a map object.

Usage

erase(obj, key, value)

## S4 method for signature 'map,vector,missing'
erase(obj, key)

## S4 method for signature 'bimap,missing,vector'
erase(obj, value)

## S4 method for signature 'multimap,vector,vector'
erase(obj, key, value)

## S4 method for signature 'multimap,vector,list'
erase(obj, key, value)

## S4 method for signature 'multimap,vector,ANY'
erase(obj, key, value)

Arguments

obj

the object to pop an element from

key

a vector of keys that should be removed

value

optionally a list of values needs to be supplied for some data structures such as multimaps if a single key-value pair should removed. If not provided removes all key-value pairs with a specific key.

Value

returns obj with removed values

Examples


 # erases keys from a hashmap or bimap
 h_map <- hashmap()
 h_map[letters] <- rnorm(length(letters))
 h_map <- erase(h_map, "a")
 h_map <- erase(h_map, letters[2:5])

 # erases keys from a multimap
 m_map <- multimap()
 m_map[c("a", "a", "a", "b", "b", "c")] <- rep(1:2, 3)
 m_map <- erase(m_map, "a")
 m_map <- erase(m_map, "b", 1)


[Package datastructures version 0.2.8 Index]