R: Add items from one vector to another one with or without...

addItems {svMisc}

R Documentation

Add items from one vector to another one with or without replacement

Description

The function takes the (named) items of one vector and place them in a second vector if these names do not exist yet there, or replace corresponding content otherwise.

Usage

addItems(x, y, use.names = TRUE, replace = TRUE)
addActions(obj = ".svActions", text = NULL, code = NULL, state = NULL,
	options = NULL, replace = TRUE)
addIcons(obj = ".svIcons", icons, replace = TRUE)
addMethods(methods)

Arguments

`x`	the vector to add items to.
`y`	the vector of which we want to inject missing items in 'x'.
`use.names`	use names of items to determine which one is unique, otherwise, the selection is done on the items themselves.
`replace`	do we replace existing items in 'x'?
`obj`	the name of the object in `SciViews:TempEnv` to manipulate.
`text`	the text of actions to add (label on first line, tip on other lines).
`code`	the R code of actions to add.
`state`	the default (strating) state of an action, as a succession of letters: \"c\" = checked, \"u\" = unchecked (default); \"d\" = disabled, \"e\" = enabled (default); \"h\" = hidden, \"v\" = visible (default). Default values are facultative. Ex: `udv` means: unchecked - disabled - visible and it equals to simply `d`.
`options`	a character vector with other options to pass to the graphical toolkit for this action.
`icons`	a named character vector matching names of actions/panels with the URL or file name of icon resources accessible by the GUI client.
`methods`	the methods to add to `getOption("svGUI.methods")`. This information is used to compute a list of possible methods for a given object, for instance, in the context menu of an object explorer (see `objMenu()`).

Author(s)

Philippe Grosjean <phgrosjean@sciviews.org>

Examples

## I have a vector v1 with this:
v1 <- c(a = "some v1 text", b = "another v1 text")
## I want to add items whose name is missing in v1 from v2
v2 <- c(a = "v2 text", c = "the missign item")
addItems(v1, v2, replace = FALSE)
## Not the same as
addItems(v1, v2, replace = TRUE)
## This yield different result (names not used and lost!)
addItems(v1, v2, use.names = FALSE)

## This is useful to add actions, icons, descriptions, shortcuts or methods
## TODO: examples and use for functions addActions(), addIcons() and
## addMethods()