Lodash 中文文檔 (v3.10.1) - “Math” 方法

tianren124 發(fā)布于2019-08-19 17:23 / 2168人閱讀

摘要：中文文檔方法方法將兩個數(shù)相加。如果提供了迭代器函數(shù)，那么其將被作用于中的每個值以來生成值排序的標(biāo)準(zhǔn)。如果提供的是對象，那么將創(chuàng)建風(fēng)格的回調(diào)函數(shù)，并在匹配給定對象的屬性的元素時返回，否則返回。

Lodash 中文文檔 (v3.10.1) - “Math” 方法

Translated by PeckZeg
Original Docs: Lodash v3.10.1 Docs

“Math” 方法 _.add(augend, addend)

將兩個數(shù)相加。

參數(shù)

augend (number) : 待求和的第一個數(shù)值

addend (number) : 待求和的第二個數(shù)值

返回
(number) : 返回兩數(shù)的和

示例

_.add(6, 4);
// → 10

_.ceil(n, [precision=0])

根據(jù) precision 對 number 向上取整。

參數(shù)

n (number) : 待向上取整的數(shù)值

[precision=0] (number) : 向上取整的精度

(number) : 返回向上取整后的值

示例

_.ceil(4.006);
// → 5

_.ceil(6.004, 2);
// → 6.01

_.ceil(6040, -2);
// → 6100

_.floor(n, [precision=0])

根據(jù) precision 對 number 向下取整。

參數(shù)

n (number) : 待向下取整的數(shù)值

[precision=0] (number) : 向下取整的精度

(number) : 返回向下取整后的數(shù)值

示例

_.floor(4.006);
// → 4

_.floor(0.046, 2);
// → 0.04

_.floor(4060, -2);
// → 4000

_.max(collection, [iteratee], [thisArg])

獲取 collection 中的最大值。如果 collection 為空或是假值，則會返回 -Infinity。如果提供了迭代器函數(shù)，那么其將被作用于 collection 中的每個值以來生成值排序的標(biāo)準(zhǔn)。iteratee 將綁定 thisArg 并在執(zhí)行時傳入三個參數(shù)：value, index, collection。

如果提供的是屬性名，那么 predicate 將創(chuàng)建 _.property 風(fēng)格的回調(diào)函數(shù)，并返回給定元素的屬性的值。

如果值還提供了 thisArg，那么 predicate 將創(chuàng)建 _.matchesProperty 風(fēng)格的回調(diào)，并在元素含有匹配的屬性值的時候返回 true，否則返回 false。

如果提供的是對象，那么 predicate 將創(chuàng)建 _.matches 風(fēng)格的回調(diào)函數(shù)，并在匹配給定對象的屬性的元素時返回 true，否則返回 false。

參數(shù)

collection (Array|Object|string) : 待迭代的集合

[iteratee] (Function|Object|string) : 每次迭代執(zhí)行的函數(shù)

[thisArg] (*) : iteratee 綁定的 this

(*) : 返回最大值

示例

_.max([4, 2, 8, 6]);
// → 8

_.max([]);
// → -Infinity

var users = [
  { "user": "barney", "age": 36 },
  { "user": "fred",   "age": 40 }
];

_.max(users, function(chr) {
  return chr.age;
});
// → { "user": "fred", "age": 40 }

// 使用 `_.property` 回調(diào)函數(shù)簡稱
_.max(users, "age");
// → { "user": "fred", "age": 40 }

_.min(collection, [iteratee], [thisArg])

獲取 collection 中的最小值。如果 collection 為空或是假值，則會返回 -Infinity。如果提供了迭代器函數(shù)，那么其將被作用于 collection 中的每個值以來生成值排序的標(biāo)準(zhǔn)。iteratee 將綁定 thisArg 并在執(zhí)行時傳入三個參數(shù)：value, index, collection。

如果提供的是屬性名，那么 predicate 將創(chuàng)建 _.property 風(fēng)格的回調(diào)函數(shù)，并返回給定元素的屬性的值。

參數(shù)

collection (Array|Object|string) : 待迭代的集合

[iteratee] (Function|Object|string) : 每次迭代執(zhí)行的函數(shù)

[thisArg] (*) : iteratee 綁定的 this

(*) : 返回最小值

示例

_.min([4, 2, 8, 6]);
// → 2

_.min([]);
// → Infinity

var users = [
  { "user": "barney", "age": 36 },
  { "user": "fred",   "age": 40 }
];

_.min(users, function(chr) {
  return chr.age;
});
// → { "user": "barney", "age": 36 }

// using the `_.property` callback shorthand
_.min(users, "age");
// → { "user": "barney", "age": 36 }

_.round(n, [precision=0])

按 precision 四舍五入 n。

參數(shù)

n (number) : 待計算的數(shù)值

[precision=0] (number) : 四舍五入的精度

返回
(number) : 返回四舍五入后的數(shù)值

示例

_.round(4.006);
// → 4

_.round(4.006, 2);
// → 4.01

_.round(4060, -2);
// → 4100

_.sum(collection, [iteratee], [thisArg])

Gets the sum of the values in collection.

獲取 collection 的值的和

參數(shù)

collection (Array|Object|string) : 待迭代的集合

[iteratee] (Function|Object|string) : 每次迭代執(zhí)行的函數(shù)

[thisArg] (*) : iteratee 綁定的 this

(number) : 返回計算的和

示例

_.sum([4, 6]);
// → 10

_.sum({ "a": 4, "b": 6 });
// → 10

var objects = [
  { "n": 4 },
  { "n": 6 }
];

_.sum(objects, function(object) {
  return object.n;
});
// → 10

// 使用 `_.property` 回調(diào)函數(shù)簡稱
_.sum(objects, "n");
// → 10