Documentation

PassOptions

PassOptions[function,ops]⟹out

returns a sequence of all the options for function. Values specified in ops take precedence over default values, illegal values are defaulted, and duplicate options are deleted from the end.

PassOptions[function,receivingFunction,ops]⟹out

returns a sequence of all the options for receivingFunction. Values specified in ops take precedence over default values, defaults for function take precendence over defaults for 'receivingFucntion', illegal values are defaulted with respect to receivingFunction, and duplicate options are deleted from the end.

Details

Input

Output

Examples

Basic Examples (2)

Pad given options with unspecified defaults for given function:

Filter out options that are unknown to receiving function, and pad with unspecified defaults for receiving function:

Additional Examples (5)

Options can also be specified as a list:

Specify options as a list for single function case:

A function's default options:

Filters and pads options if given functions have no Usage rules, but cannot default values:

Converts strings to symbols when the receiving function has Options defined as symbols not strings:

Messages (2)

Pattern (2)

Illegal values are defaulted with respect to the receiving function:

Given one function, illegal values default with respect to that: