Learn R Programming

statnet.common (version 4.10.0)

handle.controls: Handle standard control.*() function semantics.

Description

This function takes the arguments of its caller (whose name should be passed explicitly), plus any ... arguments and produces a control list based on the standard semantics of control.*() functions, including handling deprecated arguments, identifying undefined arguments, and handling arguments that should be passed through match.arg().

Usage

handle.controls(myname, ...)

Value

a list with formal arguments of the calling function.

Arguments

myname

the name of the calling function.

...

the ... argument of the control function, if present.

Details

The function behaves based on the information it acquires from the calling function. Specifically,

  • The values of formal arguments (except ..., if present) are taken from the environment of the calling function and stored in the list.

  • If the calling function has a ... argument and defines an old.controls variable in its environment, then it remaps the names in ... to their new names based on old.controls. In addition, if the value is a list with two elements, action and message, the standard deprecation message will have message appended to it and then be called with action().

  • If the calling function has a match.arg.pars in its environment, the arguments in that list are processed through match.arg().