throwEvent: Throw a History Event to a Specified Frame
In zeehio/msProcess: Protein Mass Spectra Processing

Description Usage Arguments Value See Also Examples

Throws a history event with a specified name to a specified frame in S-PLUS (or environment in R). Typically, this function will be issued within a caller with the expectation that the thrown history will be added to by the callee(s). The history can then be caught by the caller using the catchHistory function.

1	throwEvent(x, histname="event.history", envir=msNewEnv())

`x`	a character string defining the event.
`envir`	the `frame` in S-PLUS (or `environment` in R) designated for the processing and storage of pipeline history data. Default: `msNewEnv()`.
`histname`	a character string defining the name of the history variable stored in the specified frame. Default: `"event.history"`.

a list named histname containing the following objects is written to the specified frame.

`name`	A character string defining the name of the event.
`history`	The actual history object.
`recorded`	A vector of chacter strings maintaining a record of all processes that have been recorded for the event.

Typically, these list objects will not be accessed directly by the user. Rather, this information is updated and retrieved via the throwEvent and catchEvent function.

catchEvent, assignEvent, isProcessRecorded, eventHistory.

## throw an event 
envir <- msGlobalEnv()
throwEvent("Wimbledon 2005", envir=envir)

## assign data to the thrown event 
record  <- list(Men="Roger Federer", Women="Venus Williams")
assignEvent(record)

## catch event 
catchEvent(NULL)