Element Merging

Merges an object by the names of its elements. Inserting elements in value into x that do not exists in x and replacing elements in x that exists in value with value elements if protect is false.

consolidate(x, value, protect, ...)
# Default S3 method
consolidate(x, value, protect=FALSE, ...)

consolidate(x, protect, ...) <- value

Arguments

x

named list or vector

value

named list or vector

protect

logical; should elements in x be kept instead of elements in value?

...

currently does nothing; included if ever want to make generic.

Author

Charles Dupont

See also

names

Examples

x <- 1:5
names(x) <- LETTERS[x]

y <- 6:10
names(y) <- LETTERS[y-2]

x                  # c(A=1,B=2,C=3,D=4,E=5)
#> A B C D E 
#> 1 2 3 4 5 
y                  # c(D=6,E=7,F=8,G=9,H=10)
#>  D  E  F  G  H 
#>  6  7  8  9 10 

consolidate(x, y)      # c(A=1,B=2,C=3,D=6,E=7,F=8,G=9,H=10)
#>  A  B  C  D  E  F  G  H 
#>  1  2  3  6  7  8  9 10 
consolidate(x, y, protect=TRUE)      # c(A=1,B=2,C=3,D=4,E=5,F=8,G=9,H=10)
#>  A  B  C  D  E  F  G  H 
#>  1  2  3  4  5  8  9 10