Lodash 中文文档 (v3.10.1) – “Math” 要领

Translated by PeckZeg
Original Docs: Lodash v3.10.1 Docs

“Math” 要领

_.add(augend, addend)

将两个数相加。

参数

1. augend (number) : 待乞降的第一个数值

2. addend (number) : 待乞降的第二个数值

返回
(number) : 返回两数的和

示例

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

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

依据 precision 对 number 向上取整。

参数

1. n (number) : 待向上取整的数值

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

返回

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

示例

_.ceil(4.006);
// → 5

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

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

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

依据 precision 对 number 向下取整。

参数

1. n (number) : 待向下取整的数值

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

返回

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

示例

_.floor(4.006);
// → 4

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

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

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

猎取 collection 中的最大值。假如 collection 为空或是假值，则会返回 -Infinity。假如供应了迭代器函数，那末其将被作用于 collection 中的每一个值以来天生值排序的规范。iteratee 将绑定 thisArg 并在实行时传入三个参数：value, index, collection。

假如供应的是属性名，那末 predicate 将建立 _.property 作风的回调函数，并返回给定元素的属性的值。

假如值还供应了 thisArg，那末 predicate 将建立 _.matchesProperty 作风的回调，并在元素含有婚配的属性值的时刻返回 true，不然返回 false。

假如供应的是对象，那末 predicate 将建立 _.matches 作风的回调函数，并在婚配给定对象的属性的元素时返回 true，不然返回 false。

参数

1. collection (Array|Object|string) : 待迭代的鸠合

2. [iteratee] (Function|Object|string) : 每次迭代实行的函数

3. [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` 回调函数简称
_.max(users, 'age');
// → { 'user': 'fred', 'age': 40 }

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

猎取 collection 中的最小值。假如 collection 为空或是假值，则会返回 -Infinity。假如供应了迭代器函数，那末其将被作用于 collection 中的每一个值以来天生值排序的规范。iteratee 将绑定 thisArg 并在实行时传入三个参数：value, index, collection。

假如供应的是属性名，那末 predicate 将建立 _.property 作风的回调函数，并返回给定元素的属性的值。

假如值还供应了 thisArg，那末 predicate 将建立 _.matchesProperty 作风的回调，并在元素含有婚配的属性值的时刻返回 true，不然返回 false。

假如供应的是对象，那末 predicate 将建立 _.matches 作风的回调函数，并在婚配给定对象的属性的元素时返回 true，不然返回 false。

参数

1. collection (Array|Object|string) : 待迭代的鸠合

2. [iteratee] (Function|Object|string) : 每次迭代实行的函数

3. [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。

参数

1. n (number) : 待盘算的数值

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

返回
(number) : 返回四舍五入后的数值

示例

_.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 的值的和

参数

1. collection (Array|Object|string) : 待迭代的鸠合

2. [iteratee] (Function|Object|string) : 每次迭代实行的函数

3. [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` 回调函数简称
_.sum(objects, 'n');
// → 10