|
5152 | 5152 | } |
5153 | 5153 |
|
5154 | 5154 | /** |
5155 | | - * Gets the appropriate "iteratee" function. If the `_.iteratee` method is |
5156 | | - * customized this function returns the custom method, otherwise it returns |
5157 | | - * `baseIteratee`. If arguments are provided, the chosen function is invoked |
5158 | | - * with them and its result is returned. |
| 5155 | + * Gets the appropriate "iteratee" function. If `_.iteratee` is customized, |
| 5156 | + * this function returns the custom method, otherwise it returns `baseIteratee`. |
| 5157 | + * If arguments are provided, the chosen function is invoked with them and |
| 5158 | + * its result is returned. |
5159 | 5159 | * |
5160 | 5160 | * @private |
5161 | 5161 | * @param {*} [value] The value to convert to an iteratee. |
|
6410 | 6410 | /** |
6411 | 6411 | * Gets the index at which the first occurrence of `value` is found in `array` |
6412 | 6412 | * using [`SameValueZero`](http://ecma-international.org/ecma-262/6.0/#sec-samevaluezero) |
6413 | | - * for equality comparisons. If `fromIndex` is negative, it's used as the offset |
6414 | | - * from the end of `array`. |
| 6413 | + * for equality comparisons. If `fromIndex` is negative, it's used as the |
| 6414 | + * offset from the end of `array`. |
6415 | 6415 | * |
6416 | 6416 | * @static |
6417 | 6417 | * @memberOf _ |
|
8380 | 8380 | }); |
8381 | 8381 |
|
8382 | 8382 | /** |
8383 | | - * Checks if `value` is in `collection`. If `collection` is a string it's |
| 8383 | + * Checks if `value` is in `collection`. If `collection` is a string, it's |
8384 | 8384 | * checked for a substring of `value`, otherwise |
8385 | 8385 | * [`SameValueZero`](http://ecma-international.org/ecma-262/6.0/#sec-samevaluezero) |
8386 | 8386 | * is used for equality comparisons. If `fromIndex` is negative, it's used as |
|
8425 | 8425 | /** |
8426 | 8426 | * Invokes the method at `path` of each element in `collection`, returning |
8427 | 8427 | * an array of the results of each invoked method. Any additional arguments |
8428 | | - * are provided to each invoked method. If `methodName` is a function it's |
8429 | | - * invoked for, and `this` bound to, each element in `collection`. |
| 8428 | + * are provided to each invoked method. If `methodName` is a function, it's |
| 8429 | + * invoked for and `this` bound to, each element in `collection`. |
8430 | 8430 | * |
8431 | 8431 | * @static |
8432 | 8432 | * @memberOf _ |
|
8627 | 8627 | * Reduces `collection` to a value which is the accumulated result of running |
8628 | 8628 | * each element in `collection` thru `iteratee`, where each successive |
8629 | 8629 | * invocation is supplied the return value of the previous. If `accumulator` |
8630 | | - * is not given the first element of `collection` is used as the initial |
| 8630 | + * is not given, the first element of `collection` is used as the initial |
8631 | 8631 | * value. The iteratee is invoked with four arguments: |
8632 | 8632 | * (accumulator, value, index|key, collection). |
8633 | 8633 | * |
|
9492 | 9492 |
|
9493 | 9493 | /** |
9494 | 9494 | * Creates a function that memoizes the result of `func`. If `resolver` is |
9495 | | - * provided it determines the cache key for storing the result based on the |
| 9495 | + * provided, it determines the cache key for storing the result based on the |
9496 | 9496 | * arguments provided to the memoized function. By default, the first argument |
9497 | 9497 | * provided to the memoized function is used as the map cache key. The `func` |
9498 | 9498 | * is invoked with the `this` binding of the memoized function. |
|
10039 | 10039 |
|
10040 | 10040 | /** |
10041 | 10041 | * This method is like `_.clone` except that it accepts `customizer` which |
10042 | | - * is invoked to produce the cloned value. If `customizer` returns `undefined` |
| 10042 | + * is invoked to produce the cloned value. If `customizer` returns `undefined`, |
10043 | 10043 | * cloning is handled by the method instead. The `customizer` is invoked with |
10044 | 10044 | * up to four arguments; (value [, index|key, object, stack]). |
10045 | 10045 | * |
|
10518 | 10518 |
|
10519 | 10519 | /** |
10520 | 10520 | * This method is like `_.isEqual` except that it accepts `customizer` which |
10521 | | - * is invoked to compare values. If `customizer` returns `undefined` comparisons |
| 10521 | + * is invoked to compare values. If `customizer` returns `undefined`, comparisons |
10522 | 10522 | * are handled by the method instead. The `customizer` is invoked with up to |
10523 | 10523 | * six arguments: (objValue, othValue [, index|key, object, other, stack]). |
10524 | 10524 | * |
|
10811 | 10811 |
|
10812 | 10812 | /** |
10813 | 10813 | * This method is like `_.isMatch` except that it accepts `customizer` which |
10814 | | - * is invoked to compare values. If `customizer` returns `undefined` comparisons |
| 10814 | + * is invoked to compare values. If `customizer` returns `undefined`, comparisons |
10815 | 10815 | * are handled by the method instead. The `customizer` is invoked with five |
10816 | 10816 | * arguments: (objValue, srcValue, index|key, object, source). |
10817 | 10817 | * |
|
11622 | 11622 | /** |
11623 | 11623 | * This method is like `_.assignIn` except that it accepts `customizer` |
11624 | 11624 | * which is invoked to produce the assigned values. If `customizer` returns |
11625 | | - * `undefined` assignment is handled by the method instead. The `customizer` |
| 11625 | + * `undefined`, assignment is handled by the method instead. The `customizer` |
11626 | 11626 | * is invoked with five arguments: (objValue, srcValue, key, object, source). |
11627 | 11627 | * |
11628 | 11628 | * **Note:** This method mutates `object`. |
|
11654 | 11654 | /** |
11655 | 11655 | * This method is like `_.assign` except that it accepts `customizer` |
11656 | 11656 | * which is invoked to produce the assigned values. If `customizer` returns |
11657 | | - * `undefined` assignment is handled by the method instead. The `customizer` |
| 11657 | + * `undefined`, assignment is handled by the method instead. The `customizer` |
11658 | 11658 | * is invoked with five arguments: (objValue, srcValue, key, object, source). |
11659 | 11659 | * |
11660 | 11660 | * **Note:** This method mutates `object`. |
|
11709 | 11709 |
|
11710 | 11710 | /** |
11711 | 11711 | * Creates an object that inherits from the `prototype` object. If a |
11712 | | - * `properties` object is given its own enumerable string keyed properties |
| 11712 | + * `properties` object is given, its own enumerable string keyed properties |
11713 | 11713 | * are assigned to the created object. |
11714 | 11714 | * |
11715 | 11715 | * @static |
|
12053 | 12053 |
|
12054 | 12054 | /** |
12055 | 12055 | * Gets the value at `path` of `object`. If the resolved value is |
12056 | | - * `undefined` the `defaultValue` is used in its place. |
| 12056 | + * `undefined`, the `defaultValue` is used in its place. |
12057 | 12057 | * |
12058 | 12058 | * @static |
12059 | 12059 | * @memberOf _ |
|
12417 | 12417 | /** |
12418 | 12418 | * This method is like `_.merge` except that it accepts `customizer` which |
12419 | 12419 | * is invoked to produce the merged values of the destination and source |
12420 | | - * properties. If `customizer` returns `undefined` merging is handled by the |
| 12420 | + * properties. If `customizer` returns `undefined`, merging is handled by the |
12421 | 12421 | * method instead. The `customizer` is invoked with seven arguments: |
12422 | 12422 | * (objValue, srcValue, key, object, source, stack). |
12423 | 12423 | * |
|
12609 | 12609 | } |
12610 | 12610 |
|
12611 | 12611 | /** |
12612 | | - * Sets the value at `path` of `object`. If a portion of `path` doesn't exist |
| 12612 | + * Sets the value at `path` of `object`. If a portion of `path` doesn't exist, |
12613 | 12613 | * it's created. Arrays are created for missing index properties while objects |
12614 | 12614 | * are created for all other missing properties. Use `_.setWith` to customize |
12615 | 12615 | * `path` creation. |
|
12962 | 12962 |
|
12963 | 12963 | /** |
12964 | 12964 | * Checks if `n` is between `start` and up to but not including, `end`. If |
12965 | | - * `end` is not specified it's set to `start` with `start` then set to `0`. |
| 12965 | + * `end` is not specified, it's set to `start` with `start` then set to `0`. |
12966 | 12966 | * If `start` is greater than `end` the params are swapped to support |
12967 | 12967 | * negative ranges. |
12968 | 12968 | * |
|
13619 | 13619 | * in "interpolate" delimiters, HTML-escape interpolated data properties in |
13620 | 13620 | * "escape" delimiters, and execute JavaScript in "evaluate" delimiters. Data |
13621 | 13621 | * properties may be accessed as free variables in the template. If a setting |
13622 | | - * object is given it takes precedence over `_.templateSettings` values. |
| 13622 | + * object is given, it takes precedence over `_.templateSettings` values. |
13623 | 13623 | * |
13624 | 13624 | * **Note:** In the development build `_.template` utilizes |
13625 | 13625 | * [sourceURLs](http://www.html5rocks.com/en/tutorials/developertools/sourcemaps/#toc-sourceurl) |
|
14414 | 14414 |
|
14415 | 14415 | /** |
14416 | 14416 | * Creates a function that invokes `func` with the arguments of the created |
14417 | | - * function. If `func` is a property name the created function returns the |
14418 | | - * property value for a given element. If `func` is an array or object the |
| 14417 | + * function. If `func` is a property name, the created function returns the |
| 14418 | + * property value for a given element. If `func` is an array or object, the |
14419 | 14419 | * created function returns `true` for elements that contain the equivalent |
14420 | 14420 | * source properties, otherwise it returns `false`. |
14421 | 14421 | * |
|
14575 | 14575 |
|
14576 | 14576 | /** |
14577 | 14577 | * Adds all own enumerable string keyed function properties of a source |
14578 | | - * object to the destination object. If `object` is a function then methods |
| 14578 | + * object to the destination object. If `object` is a function, then methods |
14579 | 14579 | * are added to its prototype as well. |
14580 | 14580 | * |
14581 | 14581 | * **Note:** Use `_.runInContext` to create a pristine `lodash` function to |
|
14832 | 14832 | /** |
14833 | 14833 | * Creates an array of numbers (positive and/or negative) progressing from |
14834 | 14834 | * `start` up to, but not including, `end`. A step of `-1` is used if a negative |
14835 | | - * `start` is specified without an `end` or `step`. If `end` is not specified |
| 14835 | + * `start` is specified without an `end` or `step`. If `end` is not specified, |
14836 | 14836 | * it's set to `start` with `start` then set to `0`. |
14837 | 14837 | * |
14838 | 14838 | * **Note:** JavaScript follows the IEEE-754 standard for resolving |
|
14979 | 14979 | } |
14980 | 14980 |
|
14981 | 14981 | /** |
14982 | | - * Generates a unique ID. If `prefix` is given the ID is appended to it. |
| 14982 | + * Generates a unique ID. If `prefix` is given, the ID is appended to it. |
14983 | 14983 | * |
14984 | 14984 | * @static |
14985 | 14985 | * @since 0.1.0 |
|
15087 | 15087 | var floor = createRound('floor'); |
15088 | 15088 |
|
15089 | 15089 | /** |
15090 | | - * Computes the maximum value of `array`. If `array` is empty or falsey |
| 15090 | + * Computes the maximum value of `array`. If `array` is empty or falsey, |
15091 | 15091 | * `undefined` is returned. |
15092 | 15092 | * |
15093 | 15093 | * @static |
|
15187 | 15187 | } |
15188 | 15188 |
|
15189 | 15189 | /** |
15190 | | - * Computes the minimum value of `array`. If `array` is empty or falsey |
| 15190 | + * Computes the minimum value of `array`. If `array` is empty or falsey, |
15191 | 15191 | * `undefined` is returned. |
15192 | 15192 | * |
15193 | 15193 | * @static |
|
0 commit comments