Namespace goog.functions
code »Global Functions
code »goog.functions.FALSE ( ) ⇒ boolean
Always returns false.
boolean
code »goog.functions.NULL ( ) ⇒ null
Always returns NULL.
null
code »goog.functions.TRUE ( ) ⇒ boolean
Always returns true.
boolean
code »goog.functions.and ( var_args ) ⇒ function(?): boolean
Creates a function that returns true if each of its components evaluates
to true. The components are evaluated in order, and the evaluation will be
short-circuited as soon as a function returns false.
For example, (goog.functions.and(f, g))(x) is equivalent to f(x) && g(x).
function(?): boolean
Parameters |
---|
|
Returns |
|
Gives a wrapper function that caches the return value of a parameterless
function when first called.
When called for the first time, the given function is called and its
return value is cached (thus this is only appropriate for idempotent
functions). Subsequent calls will return the cached return value. This
allows the evaluation of expensive functions to be delayed until first used.
To cache the return values of functions with parameters, see goog.memoize.
Parameters |
---|
|
Returns |
|
Creates the composition of the functions passed in.
For example, (goog.functions.compose(f, g))(a) is equivalent to f(g(a)).
Parameters |
---|
|
Returns |
|
Creates a function that always returns the same value.
Parameters |
---|
|
Returns |
|
code »goog.functions.create ( constructor, var_args ) ⇒ !Object
Generic factory function to construct an object given the constructor
and the arguments. Intended to be bound to create object factories.
Callers should cast the result to the appropriate type for proper type
checking by the compiler.
!Object
Parameters |
---|
|
Returns |
constructor . |
code »goog.functions.error ( message ) ⇒ !Function
Creates a function that always throws an error with the given message.
!Function
Parameters |
---|
|
Returns |
|
code »goog.functions.fail ( err ) ⇒ !Function
Creates a function that throws the given object.
!Function
Parameters |
---|
|
Returns |
|
A simple function that returns the first argument of whatever is passed
into it.
Parameters |
---|
|
Returns |
|
code »goog.functions.lock ( f, opt_numArgs ) ⇒ !Function
Given a function, create a function that keeps opt_numArgs arguments and
silently discards all additional arguments.
!Function
code »goog.functions.not ( f ) ⇒ function(?): boolean
Creates a function that returns the Boolean opposite of a provided function.
For example, (goog.functions.not(f))(x) is equivalent to !f(x).
function(?): boolean
Parameters |
---|
|
Returns |
|
code »goog.functions.nth ( n ) ⇒ !Function
Creates a function that returns its nth argument.
!Function
Parameters |
---|
|
Returns |
|
code »goog.functions.or ( var_args ) ⇒ function(?): boolean
Creates a function that returns true if any of its components evaluates
to true. The components are evaluated in order, and the evaluation will be
short-circuited as soon as a function returns true.
For example, (goog.functions.or(f, g))(x) is equivalent to f(x) || g(x).
function(?): boolean
Parameters |
---|
|
Returns |
|
code »goog.functions.sequence ( var_args ) ⇒ !Function
Creates a function that calls the functions passed in in sequence, and
returns the value of the last function. For example,
(goog.functions.sequence(f, g))(x) is equivalent to f(x),g(x).
!Function
Parameters |
---|
|
Returns |
|
Given a function, create a new function that swallows its return value
and replaces it with a new one.
Parameters |
---|
|
Returns |
|