colorSpec (version 1.5-0)

metadata: metadata of a colorSpec object

Description

Retrieve or set the metadata of a colorSpec object.

Usage

# S3 method for colorSpec
metadata(x, ...)
# S3 method for colorSpec
metadata(x, add=FALSE ) <- value

Value

metadata(x) with no additional arguments returns the complete named list of metadata. If arguments are present, then only those metadata items are returned.

Arguments

x

a colorSpec R object

...

optional names of metadata to return

value

a named list. If add is FALSE, value replaces any existing metadata. If add is TRUE, value is appended to the existing list of metadata. If a name already exists, its value is updated using modifyList(). Unnamed items in value are ignored.

add

if add=FALSE, any existing metadata is discarded. If add=TRUE then existing metadata is preserved, using modifyList().

Details

The metadata list is stored as attr(x,'metadata'). After construction this list is empty.

See Also

extradata, modifyList

Examples

if (FALSE) {
# get list of *all* metadata
metadata(x)

# get just the file 'path'
metadata( x, 'path' )

# set the 'date'
metadata( x ) = list( date="2016-04-01" )
}