Become an expert in R — Interactive courses, Cheat Sheets, certificates and more!
Get Started for Free

update.list

Update the elements of a list


Description

Function to update the elements of a list to contain all of the named elements of a new list, overwriting elements with the same name, and (optionally) copying unnamed elements.

Usage

## S3 method for class 'list'
update(object,
       new,
       unnamed=FALSE,
       ...)

Arguments

object

Object to be updated.

new

List or dataframe containing new elements.

unnamed

Logical. If TRUE, unnamed elements of new will be appended to object.

...

optional method arguments (ignored)

Value

A new list constructed from the elements of object by merging the elements of old and new with named items of new replacing the corresponding elements of old. Unnamed elements of new will be appened unless unnamed=FALSE.

Note

This method can be called directly, or as via the S3 base method for update.

Author(s)

Gregory R. Warnes greg@warnes.net

See Also

Examples

old <- list(a=1,b="red",c=1.37)
new <- list(b="green",c=2.4)

update(old, new)
update.list(old,new)  # equivalent

older <- list(a=0, b="orange", 4, 5, 6)
newer <- list(b="purple", 7, 8, 9)
update(older, newer)               # ignores unnamed elements of newer
update(older, newer, unnamed=TRUE) # appends unnamed elements of newer

gdata

Various R Programming Tools for Data Manipulation

v2.18.0
GPL-2
Authors
Gregory R. Warnes, Ben Bolker, Gregor Gorjanc, Gabor Grothendieck, Ales Korosec, Thomas Lumley, Don MacQueen, Arni Magnusson, Jim Rogers, and others
Initial release
2017-06-05

We don't support your browser anymore

Please choose more modern alternatives, such as Google Chrome or Mozilla Firefox.