Mirrors/lodash
1
0
Fork 0
mirror of https://github.com/whoisclebs/lodash.git synced 2026-01-31 15:27:50 +00:00
Code Issues Packages Projects Releases Wiki Activity

Cleanup doc note on lazy evaluation. [ci skip]

Browse Source
This commit is contained in:
John-David Dalton
2016-01-02 10:21:36 -06:00
parent 9d3a298895
commit 167fad9649
1 changed files with 8 additions and 9 deletions
Download Patch File Download Diff File Expand all files Collapse all files

17
lodash.js
View File

@@ -1386,17 +1386,16 @@
* Explicit chaining, which must be unwrapped with `_#value` in all cases,
* may be enabled using `_.chain`.
*
* The execution of chained methods is lazy, that is, execution is deferred
* until `_#value` is implicitly or explicitly called.
* The execution of chained methods is lazy, that is, it's deferred until
* `_#value` is implicitly or explicitly called.
*
* Lazy evaluation allows several methods to support shortcut fusion. Shortcut
* fusion is an optimization strategy which merge iteratee calls; this can help
* to avoid the creation of intermediate data structures and greatly reduce the
* number of iteratee executions. Sections of a chain sequence may qualify for
* shortcut fusion if the section is applied to an array of at least two hundred
* elements and any iteratees or predicates accept only one argument. The
* heuristic for whether a section qualifies for shortcut fusion is subject
* to change.
* fusion is an optimization to merge iteratee calls; this avoids the creation
* of intermediate arrays and can greatly reduce the number of iteratee executions.
* Sections of a chain sequence qualify for shortcut fusion if the section is
* applied to an array of at least two hundred elements and any iteratees
* accept only one argument. The heuristic for whether a section qualifies
* for shortcut fusion is subject to change.
*
* Chaining is supported in custom builds as long as the `_#value` method is
* directly or indirectly included in the build.