docs(identity): add example

Closes #14528
2016-04-27 19:53:29 -07:00
parent 85a53ea9cd
commit 8337b9b2d4
1 changed files with 15 additions and 5 deletions
@@ -466,12 +466,22 @@ noop.$inject = [];
 * functional style.
 *
   ```js
-     function transformer(transformationFn, value) {
-       return (transformationFn || angular.identity)(value);
-     };
+   function transformer(transformationFn, value) {
+     return (transformationFn || angular.identity)(value);
+   };
+
+   // E.g.
+   function getResult(fn, input) {
+     return (fn || angular.identity)(input);
+   };
+
+   getResult(function(n) { return n * 2; }, 21);   // returns 42
+   getResult(null, 21);                            // returns 21
+   getResult(undefined, 21);                       // returns 21
   ```
-  * @param {*} value to be returned.
-  * @returns {*} the value passed in.
+ *
+ * @param {*} value to be returned.
+ * @returns {*} the value passed in.
 */
 function identity($) {return $;}
 identity.$inject = [];