Home

# Library goog.functions

Function Summary
| `and((Function|null|undefined) var_args) ⇒ !Function` 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).
| `compose((Function|null|undefined) var_args) ⇒ !Function` Creates the composition of the functions passed in. For example, (goog.functions.compose(f, g))(a) is equivalent to f(g(a)).
| `constant(<Any Type> retValue) ⇒ !Function` Creates a function that always returns the same value.
| `create(!Function constructor, <Any Type> 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.
| `error(string message) ⇒ !Function` Creates a function that always throws an error with the given message.
| `identity(<Any Type> opt_returnValue, <Any Type> var_args) ⇒ <Any Type>` A simple function that returns the first argument of whatever is passed into it.
| `lock(?Function f) ⇒ !Function` Given a function, create a function that silently discards all additional arguments.
| `not(!Function f) ⇒ !Function` Creates a function that returns the Boolean opposite of a provided function. For example, (goog.functions.not(f))(x) is equivalent to !f(x).
| `or((Function|null|undefined) var_args) ⇒ !Function` 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).
| `sequence((Function|null|undefined) 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).
| `withReturnValue(?Function f, <Any Type> retValue) ⇒ !Function` Given a function, create a new function that swallows its return value and replaces it with a new one.