| Excerpt |
|---|
Create a new function by wrapping an existing function in another existing function... |
Syntax
The parameters to newFn are passed to innerFn. The return value of innerFn is passed as the sole parameter to outerFn (the wrapper) and the return value of outerFn is then passed to the calling script...
| Code Block | ||||||
|---|---|---|---|---|---|---|
| ||||||
var newFn = outerFn.wraps(innerFn); result = newFn(args...); |
Parameters / Functions
| Parameter / Function | Type | Mandatory | Description | API Version |
|---|---|---|---|---|
| innerFn | Function |  | The inner function that will be called first with the arguments passed in to newFn | 1.0 |
| outerFn | Function | | The outer function that will be called second with a single argument that is the return value of innerFn.
| 1.0 |
| args... | Variant |  | When calling newFn you can optionally specify one or more arguments that will be passed to innerFn | 1.0 |
outerFn should require only a single parameter as it's not possible for innerFn to return multiple arguments.Return value
| Value | Type | Description | Util.js version |
|---|---|---|---|
| newFn | Function | A new function based on the composition of innerFn and outerFn | 1.0 |
| <result> | Variant | The return value of the new function is derived as follows:
| 1.0 |
Example
| Code Block | ||||||||
|---|---|---|---|---|---|---|---|---|
| ||||||||
var roundedSqRoot = Math.round.wraps(Math.sqrt); roundedSqRoot(28); // 5 // Here's why: // 1. Math.sqrt(528) → 5.291502622129181 // 2. Math.round(5.291502622129181) → 5 // 3. Return value of Math.round then passed to calling script |
| Div | ||||||
|---|---|---|---|---|---|---|
| ||||||
Availability
Requires:
|
| Div | ||||
|---|---|---|---|---|
| ||||
ContentsJump to:
|
| Div | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||
Function ManipulationTopics:
|
| Div | ||
|---|---|---|
| ||
See AlsoRelated pages:
|