From f3858aa4ae0333ceaa31043f3c3a0f6034abf955 Mon Sep 17 00:00:00 2001 From: think2011 <452125301@qq.com> Date: Sun, 24 Jan 2016 00:49:01 +0800 Subject: [PATCH] publish --- VERSION.html | 2 +- add.html | 2 +- all.html | 618 ++++++++++++++++++++--------------------- assign.html | 2 +- assignIn.html | 2 +- assignInWith.html | 2 +- assignWith.html | 2 +- at.html | 2 +- attempt.html | 12 +- bind.html | 4 +- bindAll.html | 11 +- bindKey.html | 2 +- camelCase.html | 2 +- capitalize.html | 2 +- ceil.html | 2 +- clamp.html | 2 +- clone.html | 2 +- cloneDeep.html | 2 +- cloneDeepWith.html | 2 +- cloneWith.html | 2 +- cond.html | 18 +- conforms.html | 12 +- constant.html | 8 +- create.html | 2 +- curry.html | 2 +- curryRight.html | 2 +- debounce.html | 2 +- deburr.html | 2 +- defaults.html | 2 +- defaultsDeep.html | 2 +- defer.html | 2 +- delay.html | 2 +- endsWith.html | 2 +- eq.html | 2 +- escape.html | 2 +- escapeRegExp.html | 2 +- findKey.html | 2 +- findLastKey.html | 2 +- flip.html | 2 +- floor.html | 2 +- flow.html | 12 +- flowRight.html | 9 +- forIn.html | 2 +- forInRight.html | 2 +- forOwn.html | 2 +- forOwnRight.html | 2 +- functions.html | 2 +- functionsIn.html | 2 +- get.html | 2 +- gt.html | 2 +- gte.html | 2 +- has.html | 2 +- hasIn.html | 2 +- identity.html | 8 +- inRange.html | 2 +- invert.html | 2 +- invoke.html | 2 +- isArguments.html | 2 +- isArray.html | 2 +- isArrayLike.html | 2 +- isArrayLikeObject.html | 2 +- isBoolean.html | 2 +- isDate.html | 2 +- isElement.html | 2 +- isEmpty.html | 2 +- isEqual.html | 2 +- isEqualWith.html | 2 +- isError.html | 2 +- isFinite.html | 2 +- isFunction.html | 2 +- isInteger.html | 2 +- isLength.html | 2 +- isMatch.html | 2 +- isMatchWith.html | 2 +- isNaN.html | 2 +- isNative.html | 2 +- isNil.html | 2 +- isNull.html | 2 +- isNumber.html | 2 +- isObject.html | 2 +- isObjectLike.html | 2 +- isPlainObject.html | 2 +- isRegExp.html | 2 +- isSafeInteger.html | 2 +- isString.html | 2 +- isSymbol.html | 2 +- isTypedArray.html | 2 +- isUndefined.html | 2 +- iteratee.html | 16 +- js/lodash-zh.js | 275 +++++++++--------- kebabCase.html | 2 +- keys.html | 2 +- keysIn.html | 2 +- lowerCase.html | 2 +- lowerFirst.html | 2 +- lt.html | 2 +- lte.html | 2 +- mapKeys.html | 2 +- mapValues.html | 2 +- matches.html | 13 +- matchesProperty.html | 15 +- max.html | 2 +- maxBy.html | 2 +- mean.html | 2 +- memoize.html | 2 +- merge.html | 2 +- mergeWith.html | 2 +- method.html | 12 +- methodOf.html | 12 +- min.html | 2 +- minBy.html | 2 +- mixin.html | 16 +- negate.html | 2 +- noConflict.html | 7 +- noop.html | 5 +- nthArg.html | 8 +- omit.html | 2 +- omitBy.html | 2 +- once.html | 2 +- over.html | 9 +- overArgs.html | 2 +- overEvery.html | 9 +- overSome.html | 9 +- pad.html | 2 +- padEnd.html | 2 +- padStart.html | 2 +- pages.json | 360 ++++++++++++------------ parseInt.html | 2 +- partial.html | 8 +- partialRight.html | 6 +- pick.html | 2 +- pickBy.html | 2 +- property.html | 8 +- propertyOf.html | 8 +- random.html | 2 +- range.html | 22 +- rangeRight.html | 14 +- rearg.html | 2 +- repeat.html | 2 +- replace.html | 2 +- rest.html | 2 +- result.html | 2 +- round.html | 2 +- set.html | 2 +- setWith.html | 2 +- snakeCase.html | 2 +- split.html | 2 +- spread.html | 2 +- startCase.html | 2 +- startsWith.html | 2 +- subtract.html | 2 +- sum.html | 2 +- sumBy.html | 2 +- template.html | 2 +- throttle.html | 2 +- times.html | 10 +- toArray.html | 2 +- toInteger.html | 2 +- toLength.html | 2 +- toLower.html | 2 +- toNumber.html | 2 +- toPairs.html | 2 +- toPairsIn.html | 2 +- toPath.html | 8 +- toPlainObject.html | 2 +- toSafeInteger.html | 2 +- toString.html | 2 +- toUpper.html | 2 +- transform.html | 2 +- trim.html | 2 +- trimEnd.html | 2 +- trimStart.html | 2 +- truncate.html | 2 +- unary.html | 2 +- unescape.html | 2 +- uniqueId.html | 9 +- unset.html | 2 +- upperCase.html | 2 +- upperFirst.html | 2 +- values.html | 2 +- valuesIn.html | 2 +- words.html | 2 +- wrap.html | 2 +- 183 files changed, 902 insertions(+), 969 deletions(-) diff --git a/VERSION.html b/VERSION.html index dda1e1d..63a58fa 100644 --- a/VERSION.html +++ b/VERSION.html @@ -392,7 +392,7 @@
-

VERSION source

+

VERSION source

_.VERSION

(string): 语义化版本号

diff --git a/add.html b/add.html index e74ab7c..41aeb25 100644 --- a/add.html +++ b/add.html @@ -392,7 +392,7 @@
-

add source npm

+

add source npm

_.add(augend, addend)

相加两个数

diff --git a/all.html b/all.html index adf42c1..faf4a36 100644 --- a/all.html +++ b/all.html @@ -6051,13 +6051,11 @@

示例

})();
-

bind source npm

+

bind source npm

_.bind(func, thisArg, [partials])

创建一个函数 func,这个函数的 this 会被绑定在 thisArg。 并且任何附加在 _.bind 的参数会被传入到这个绑定函数上。 -
-
这个 _.bind.placeholder 的值,默认是以 _ 作为附加部分参数的占位符。

@@ -6120,7 +6118,7 @@

示例

})();
-

bindKey source npm

+

bindKey source npm

_.bindKey(object, key, [partials])

创建一个函数。 @@ -6200,7 +6198,7 @@

示例

})();
-

curry source npm

+

curry source npm

_.curry(func, [arity=func.length])

创建一个函数,该函数接收一个或多个 func 的参数。 @@ -6273,7 +6271,7 @@

示例

})();
-

curryRight source npm

+

curryRight source npm

_.curryRight(func, [arity=func.length])

这个方法类似 _.curry。 @@ -6344,7 +6342,7 @@

示例

})();
-

debounce source npm

+

debounce source npm

_.debounce(func, [wait=0], [options])

创建一个防抖动函数。 @@ -6428,7 +6426,7 @@

示例

})();
-

defer source npm

+

defer source npm

_.defer(func, [args])

延迟调用 func 直到当前堆栈清理完毕。 @@ -6479,7 +6477,7 @@

示例

})();
-

delay source npm

+

delay source npm

_.delay(func, wait, [args])

延迟 wait 毫秒后调用 func。 @@ -6532,7 +6530,7 @@

示例

})();
-

flip source npm

+

flip source npm

_.flip(func)

创建一个翻转接收参数的 func 函数。

@@ -6582,7 +6580,7 @@

示例

})();
-

memoize source npm

+

memoize source npm

_.memoize(func, [resolver])

创建一个会缓存 func 结果的函数。 @@ -6658,7 +6656,7 @@

示例

})();
-

negate source npm

+

negate source npm

_.negate(predicate)

创建一个对 func 结果 取反的函数。 @@ -6709,7 +6707,7 @@

示例

})();
-

once source npm

+

once source npm

_.once(func)

创建一个只能调用一次的函数。 @@ -6759,7 +6757,7 @@

示例

})();
-

overArgs source npm

+

overArgs source npm

_.overArgs(func, [transforms])

创建一个函数,调用时func 参数会先一对一的改变。

@@ -6822,17 +6820,13 @@

示例

})();
-

partial source npm

+

partial source npm

_.partial(func, [partials])

创建一个函数。 该函数调用 func,并传入预设的参数。 这个方法类似 _.bind,除了它不会绑定 this。 -
-
-
-
-这个 .partial.placeholder 的值,默认是以 作为附加部分参数的占位符。 +这个 _.partial.placeholder 的值,默认是以 _ 作为附加部分参数的占位符。

注意: 这个方法不会设置 "length" 到函数上。

@@ -6890,14 +6884,10 @@

示例

})();
-

partialRight source npm

+

partialRight source npm

_.partialRight(func, [partials])

这个函数类似 _.partial,除了它是从右到左预设参数的。 -
-
-
-
这个 .partialRight.placeholder 的值,默认是以 作为附加部分参数的占位符。

@@ -6956,7 +6946,7 @@

示例

})();
-

rearg source npm

+

rearg source npm

_.rearg(func, indexes)

创建一个调用 func 的函数。 @@ -7010,7 +7000,7 @@

示例

})();
-

rest source npm

+

rest source npm

_.rest(func, [start=func.length-1])

创建一个调用 func 的函数。 @@ -7067,7 +7057,7 @@

示例

})();
-

spread source npm

+

spread source npm

_.spread(func)

创建一个调用 func 的函数。 this 绑定到这个函数上。 @@ -7132,7 +7122,7 @@

示例

})();
-

throttle source npm

+

throttle source npm

_.throttle(func, [wait=0], [options])

创建一个节流函数,在 wait 秒内最多执行 func 一次的函数。 @@ -7202,7 +7192,7 @@

示例

})();
-

unary source npm

+

unary source npm

_.unary(func)

创建一个最多接受一个参数的函数,忽略多余的参数。

@@ -7248,7 +7238,7 @@

示例

})();
-

wrap source npm

+

wrap source npm

_.wrap(value, wrapper)

创建一个函数。提供的 value 包装在 wrapper 函数的第一个参数里。 @@ -7302,7 +7292,7 @@

示例

})();
-

clone source npm

+

clone source npm

_.clone(value)

创建一个 value 的浅拷贝。 @@ -7363,7 +7353,7 @@

示例

})();
-

cloneDeep source npm

+

cloneDeep source npm

_.cloneDeep(value)

这个方法类似 _.clone,除了它会递归拷贝 value

@@ -7415,7 +7405,7 @@

示例

})();
-

cloneDeepWith source npm

+

cloneDeepWith source npm

_.cloneDeepWith(value, [customizer])

这个方法类似 _.cloneWith,除了它会递归拷贝 value

@@ -7475,7 +7465,7 @@

示例

})();
-

cloneWith source npm

+

cloneWith source npm

_.cloneWith(value, [customizer])

这个方法类似 _.clone,除了它接受一个 customizer 定制返回的拷贝值。 @@ -7537,7 +7527,7 @@

示例

})();
-

eq source npm

+

eq source npm

_.eq(value, other)

执行 SameValueZero 比较两者的值确定它们是否相等。

@@ -7600,7 +7590,7 @@

示例

})();
-

gt source npm

+

gt source npm

_.gt(value, other)

检查 value 是否大于 other

@@ -7654,7 +7644,7 @@

示例

})();
-

gte source npm

+

gte source npm

_.gte(value, other)

检查 value 是否大于等于 other

@@ -7708,7 +7698,7 @@

示例

})();
-

isArguments source npm

+

isArguments source npm

_.isArguments(value)

检查 value 是否是 类 arguments 对象。

@@ -7757,7 +7747,7 @@

示例

})();
-

isArray source npm

+

isArray source npm

_.isArray(value)

检查 value 是否是 Array 类对象。

@@ -7812,7 +7802,7 @@

示例

})();
-

isArrayLike source npm

+

isArrayLike source npm

_.isArrayLike(value)

检查 value 是否是类数组。 @@ -7868,7 +7858,7 @@

示例

})();
-

isArrayLikeObject source npm

+

isArrayLikeObject source npm

_.isArrayLikeObject(value)

这个方法类似 _.isArrayLike,除了它还检查值是否是个对象。

@@ -7923,7 +7913,7 @@

示例

})();
-

isBoolean source npm

+

isBoolean source npm

_.isBoolean(value)

检查 value 是否是原始 boolean 类型或者对象。

@@ -7972,7 +7962,7 @@

示例

})();
-

isDate source npm

+

isDate source npm

_.isDate(value)

检查 value 是否是 Date 类型

@@ -8021,7 +8011,7 @@

示例

})();
-

isElement source npm

+

isElement source npm

_.isElement(value)

检查 value 是否是可能是 DOM 元素

@@ -8070,7 +8060,7 @@

示例

})();
-

isEmpty source npm

+

isEmpty source npm

_.isEmpty(value)

检查 value 是否为空。 @@ -8129,7 +8119,7 @@

示例

})();
-

isEqual source npm

+

isEqual source npm

_.isEqual(value, other)

执行深比较来决定两者的值是否相等。 @@ -8189,7 +8179,7 @@

示例

})();
-

isEqualWith source npm

+

isEqualWith source npm

_.isEqualWith(value, other, [customizer])

这个方法类似 _.isEqual。 @@ -8254,7 +8244,7 @@

示例

})();
-

isError source npm

+

isError source npm

_.isError(value)

检查 value 是否是 Error, EvalError, RangeError, ReferenceError, @@ -8304,7 +8294,7 @@

示例

})();
-

isFinite source npm

+

isFinite source npm

_.isFinite(value)

检查 value 是否是原始 finite number。 @@ -8362,7 +8352,7 @@

示例

})();
-

isFunction source npm

+

isFunction source npm

_.isFunction(value)

检查 value 是否是 Function 对象。

@@ -8411,7 +8401,7 @@

示例

})();
-

isInteger source npm

+

isInteger source npm

_.isInteger(value)

检查 value 是否是整数。 @@ -8469,7 +8459,7 @@

示例

})();
-

isLength source npm

+

isLength source npm

_.isLength(value)

检查 value 是否是有效长度 @@ -8527,7 +8517,7 @@

示例

})();
-

isMatch source npm

+

isMatch source npm

_.isMatch(object, source)

执行一个深比较来确定object 是否包含有 source 的属性值。 @@ -8583,7 +8573,7 @@

示例

})();
-

isMatchWith source npm

+

isMatchWith source npm

_.isMatchWith(object, source, [customizer])

这个方法类似 _.isMatch。 @@ -8648,7 +8638,7 @@

示例

})();
-

isNaN source npm

+

isNaN source npm

_.isNaN(value)

检查 value 是否是 NaN. @@ -8707,7 +8697,7 @@

示例

})();
-

isNative source npm

+

isNative source npm

_.isNative(value)

检查 value 是否是原生函数

@@ -8756,7 +8746,7 @@

示例

})();
-

isNil source npm

+

isNil source npm

_.isNil(value)

检查 value 是否是 null 或者 undefined

@@ -8808,7 +8798,7 @@

示例

})();
-

isNull source npm

+

isNull source npm

_.isNull(value)

检查 value 是否是 null.

@@ -8857,7 +8847,7 @@

示例

})();
-

isNumber source npm

+

isNumber source npm

_.isNumber(value)

检查 value 是否是原始数值型 或者 对象。 @@ -8915,7 +8905,7 @@

示例

})();
-

isObject source npm

+

isObject source npm

_.isObject(value)

检查 value 是否是 Objectlanguage type。 @@ -8971,7 +8961,7 @@

示例

})();
-

isObjectLike source npm

+

isObjectLike source npm

_.isObjectLike(value)

检查 value 是否是 类对象。 @@ -9027,7 +9017,7 @@

示例

})();
-

isPlainObject source npm

+

isPlainObject source npm

_.isPlainObject(value)

检查 value 是否是普通对象。 @@ -9087,7 +9077,7 @@

示例

})();
-

isRegExp source npm

+

isRegExp source npm

_.isRegExp(value)

检查 value 是否是 RegExp 对象

@@ -9136,7 +9126,7 @@

示例

})();
-

isSafeInteger source npm

+

isSafeInteger source npm

_.isSafeInteger(value)

检查 value 是否是安全整数。 @@ -9195,7 +9185,7 @@

示例

})();
-

isString source npm

+

isString source npm

_.isString(value)

检查 value 是否是原始字符串或者对象。

@@ -9244,7 +9234,7 @@

示例

})();
-

isSymbol source npm

+

isSymbol source npm

_.isSymbol(value)

检查 value 是否是原始 Symbol 或者对象。

@@ -9293,7 +9283,7 @@

示例

})();
-

isTypedArray source npm

+

isTypedArray source npm

_.isTypedArray(value)

检查 value 是否是TypedArray。

@@ -9342,7 +9332,7 @@

示例

})();
-

isUndefined source npm

+

isUndefined source npm

_.isUndefined(value)

检查 value 是否是 undefined.

@@ -9391,7 +9381,7 @@

示例

})();
-

lt source npm

+

lt source npm

_.lt(value, other)

检查 value 是否是 小于 other

@@ -9445,7 +9435,7 @@

示例

})();
-

lte source npm

+

lte source npm

_.lte(value, other)

检查 value 是否是 小于等于 other.

@@ -9499,7 +9489,7 @@

示例

})();
-

toArray source npm

+

toArray source npm

_.toArray(value)

转换 value 为数组

@@ -9547,7 +9537,7 @@

示例

})();
-

toInteger source npm

+

toInteger source npm

_.toInteger(value)

转换 value 为整数 @@ -9605,7 +9595,7 @@

示例

})();
-

toLength source npm

+

toLength source npm

_.toLength(value)

转换 value 为用作类数组对象的长度整数。 @@ -9663,7 +9653,7 @@

示例

})();
-

toNumber source npm

+

toNumber source npm

_.toNumber(value)

转换 value 为数值

@@ -9718,7 +9708,7 @@

示例

})();
-

toPlainObject source npm

+

toPlainObject source npm

_.toPlainObject(value)

转换 value 为普通对象。 @@ -9774,7 +9764,7 @@

示例

})();
-

toSafeInteger source npm

+

toSafeInteger source npm

_.toSafeInteger(value)

转换 value 为安全整数。 @@ -9830,7 +9820,7 @@

示例

})();
-

toString source npm

+

toString source npm

_.toString(value)

如果 value 不是字符串,将其转换为字符串。 @@ -9883,7 +9873,7 @@

示例

})();
-

add source npm

+

add source npm

_.add(augend, addend)

相加两个数

@@ -9931,7 +9921,7 @@

示例

})();
-

ceil source npm

+

ceil source npm

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

根据 precision 向上舍入 number

@@ -9985,7 +9975,7 @@

示例

})();
-

floor source npm

+

floor source npm

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

根据 precision 向下保留 number

@@ -10039,7 +10029,7 @@

示例

})();
-

max source npm

+

max source npm

_.max(array)

计算 array 中最大的值。 @@ -10089,7 +10079,7 @@

示例

})();
-

maxBy source npm

+

maxBy source npm

_.maxBy(array, [iteratee=_.identity])

这个方法类似 _.max @@ -10148,7 +10138,7 @@

示例

})();
-

mean source npm

+

mean source npm

_.mean(array)

计算 array 的平均值。

@@ -10194,7 +10184,7 @@

示例

})();
-

min source npm

+

min source npm

_.min(array)

计算 array 中最小的值。 如果 array 是 空的或者假值将会返回 undefined。

@@ -10243,7 +10233,7 @@

示例

})();
-

minBy source npm

+

minBy source npm

_.minBy(array, [iteratee=_.identity])

这个方法类似 _.min。 @@ -10301,7 +10291,7 @@

示例

})();
-

round source npm

+

round source npm

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

根据 precision 四舍五入 number。

@@ -10355,7 +10345,7 @@

示例

})();
-

subtract source npm

+

subtract source npm

_.subtract(minuend, subtrahend)

两双相减

@@ -10403,7 +10393,7 @@

示例

})();
-

sum source npm

+

sum source npm

_.sum(array)

计算 array 中值的总和

@@ -10449,7 +10439,7 @@

示例

})();
-

sumBy source npm

+

sumBy source npm

_.sumBy(array, [iteratee=_.identity])

这个方法类似 _.sum。 @@ -10579,7 +10569,7 @@

返回值 (number)

})();
-

clamp source npm

+

clamp source npm

_.clamp(number, [min], max)

返回限制在 minmax 之间的值

@@ -10632,7 +10622,7 @@

示例

})();
-

inRange source npm

+

inRange source npm

_.inRange(number, [start=0], end)

检查 n 是否在 startend 之间,但不包括 end。 @@ -10702,7 +10692,7 @@

示例

})();
-

random source npm

+

random source npm

_.random([min=0], [max=1], [floating])

产生一个包括 minmax 之间的数。 @@ -10766,7 +10756,7 @@

示例

})();
-

assign source npm

+

assign source npm

_.assign(object, [sources])

分配来源对象的可枚举属性到目标对象上。 @@ -10830,7 +10820,7 @@

示例

})();
-

assignIn extend source npm

+

assignIn extend source npm

_.assignIn(object, [sources])

这个方法类似 _.assign。 @@ -10893,7 +10883,7 @@

示例

})();
-

assignInWith extendWith source npm

+

assignInWith extendWith source npm

_.assignInWith(object, sources, [customizer])

这个方法类似 _.assignIn。 @@ -10954,7 +10944,7 @@

示例

})();
-

assignWith source npm

+

assignWith source npm

_.assignWith(object, sources, [customizer])

这个方法类似 _.assign。 @@ -11015,7 +11005,7 @@

示例

})();
-

at source npm

+

at source npm

_.at(object, [paths])

根据 object 的路径获取值为数组。

@@ -11068,7 +11058,7 @@

示例

})();
-

create source npm

+

create source npm

_.create(prototype, [properties])

创建一个继承 prototype 的对象。 @@ -11134,7 +11124,7 @@

示例

})();
-

defaults source npm

+

defaults source npm

_.defaults(object, [sources])

分配来源对象的可枚举属性到目标对象所有解析为 undefined 的属性上。 @@ -11187,7 +11177,7 @@

示例

})();
-

defaultsDeep source npm

+

defaultsDeep source npm

_.defaultsDeep(object, [sources])

这个方法类似 _.defaults,除了它会递归分配默认属性。 @@ -11238,7 +11228,7 @@

示例

})();
-

findKey source npm

+

findKey source npm

_.findKey(object, [predicate=_.identity])

这个方法类似 _.find。 @@ -11305,7 +11295,7 @@

示例

})();
-

findLastKey source npm

+

findLastKey source npm

_.findLastKey(object, [predicate=_.identity])

这个方法类似 _.findKey。 @@ -11372,7 +11362,7 @@

示例

})();
-

forIn source npm

+

forIn source npm

_.forIn(object, [iteratee=_.identity])

使用 iteratee 遍历对象的自身和继承的可枚举属性。 @@ -11431,7 +11421,7 @@

示例

})();
-

forInRight source npm

+

forInRight source npm

_.forInRight(object, [iteratee=_.identity])

这个方法类似 _.forIn。 @@ -11489,7 +11479,7 @@

示例

})();
-

forOwn source npm

+

forOwn source npm

_.forOwn(object, [iteratee=_.identity])

使用 iteratee 遍历自身的可枚举属性。 @@ -11547,7 +11537,7 @@

示例

})();
-

forOwnRight source npm

+

forOwnRight source npm

_.forOwnRight(object, [iteratee=_.identity])

这个方法类似 _.forOwn。 除了它是反方向开始遍历的。

@@ -11604,7 +11594,7 @@

示例

})();
-

functions source npm

+

functions source npm

_.functions(object)

返回一个 function 对象自身可枚举属性名的数组。

@@ -11657,7 +11647,7 @@

示例

})();
-

functionsIn source npm

+

functionsIn source npm

_.functionsIn(object)

返回一个 function 对象自身和继承的可枚举属性名的数组。

@@ -11710,7 +11700,7 @@

示例

})();
-

get source npm

+

get source npm

_.get(object, path, [defaultValue])

根据对象路径获取值。 @@ -11769,7 +11759,7 @@

示例

})();
-

has source npm

+

has source npm

_.has(object, path)

检查 path 是否是对象的直接属性。

@@ -11829,7 +11819,7 @@

示例

})();
-

hasIn source npm

+

hasIn source npm

_.hasIn(object, path)

检查 path 是否是对象的直接 或者 继承属性。

@@ -11888,7 +11878,7 @@

示例

})();
-

invert source npm

+

invert source npm

_.invert(object, [multiVal])

创建一个键值倒置的对象。 @@ -11944,7 +11934,7 @@

示例

})();
-

invoke source npm

+

invoke source npm

_.invoke(object, path, [args])

调用对象路径的方法

@@ -11996,7 +11986,7 @@

示例

})();
-

keys source npm

+

keys source npm

_.keys(object)

创建 object 自身可枚举属性名为一个数组。 @@ -12057,7 +12047,7 @@

示例

})();
-

keysIn source npm

+

keysIn source npm

_.keysIn(object)

创建 object 自身 或 继承的可枚举属性名为一个数组。 @@ -12113,7 +12103,7 @@

示例

})();
-

mapKeys source npm

+

mapKeys source npm

_.mapKeys(object, [iteratee=_.identity])

反向版 _.mapValues。 @@ -12164,7 +12154,7 @@

示例

})();
-

mapValues source npm

+

mapValues source npm

_.mapValues(object, [iteratee=_.identity])

创建一个对象,对象的key相同,值是通过 iteratee 产生的。 @@ -12222,7 +12212,7 @@

示例

})();
-

merge source npm

+

merge source npm

_.merge(object, [sources])

递归合并来源对象的自身和继承的可枚举属性到目标对象。 @@ -12284,7 +12274,7 @@

示例

})();
-

mergeWith source npm

+

mergeWith source npm

_.mergeWith(object, sources, customizer)

这个方法类似 _.merge。 @@ -12352,7 +12342,7 @@

示例

})();
-

omit source npm

+

omit source npm

_.omit(object, [props])

反向版 _.pick。 @@ -12403,7 +12393,7 @@

示例

})();
-

omitBy source npm

+

omitBy source npm

_.omitBy(object, [predicate=_.identity])

反向版 _.pickBy。 @@ -12454,7 +12444,7 @@

示例

})();
-

pick source npm

+

pick source npm

_.pick(object, [props])

创建一个从 object 中选中的属性的对象。

@@ -12504,7 +12494,7 @@

示例

})();
-

pickBy source npm

+

pickBy source npm

_.pickBy(object, [predicate=_.identity])

创建一个从 object 中经 predicate 判断为真值的属性为对象。 @@ -12555,7 +12545,7 @@

示例

})();
-

result source npm

+

result source npm

_.result(object, path, [defaultValue])

这个方法类似 _.get。 @@ -12617,7 +12607,7 @@

示例

})();
-

set source npm

+

set source npm

_.set(object, path, value)

设置值到对象对应的属性路径上,如果没有则创建这部分路径。 @@ -12676,7 +12666,7 @@

示例

})();
-

setWith source npm

+

setWith source npm

_.setWith(object, path, value, [customizer])

这个方法类似 _.set。 @@ -12731,7 +12721,7 @@

示例

})();
-

toPairs source npm

+

toPairs source npm

_.toPairs(object)

创建一个对象自身可枚举属性的键值对数组。

@@ -12784,7 +12774,7 @@

示例

})();
-

toPairsIn source npm

+

toPairsIn source npm

_.toPairsIn(object)

创建一个对象自身和继承的可枚举属性的键值对数组。

@@ -12837,7 +12827,7 @@

示例

})();
-

transform source npm

+

transform source npm

_.transform(object, [iteratee=_.identity], [accumulator])

_.reduce 的代替方法。 @@ -12899,7 +12889,7 @@

示例

})();
-

unset source npm

+

unset source npm

_.unset(object, path)

移除对象路径的属性。

@@ -12957,7 +12947,7 @@

示例

})();
-

values source npm

+

values source npm

_.values(object)

创建 object 自身可枚举属性的值为数组 @@ -13016,7 +13006,7 @@

示例

})();
-

valuesIn source npm

+

valuesIn source npm

_.valuesIn(object)

创建 object 自身和继承的可枚举属性的值为数组 @@ -13271,7 +13261,7 @@

示例

})();
-

VERSION source

+

VERSION source

_.VERSION

(string): 语义化版本号

@@ -13304,7 +13294,7 @@

示例

})();
-

camelCase source npm

+

camelCase source npm

_.camelCase([string=''])

转换字符串为 驼峰写法

@@ -13356,7 +13346,7 @@

示例

})();
-

capitalize source npm

+

capitalize source npm

_.capitalize([string=''])

转换字符串首字母为大写,剩下为小写。

@@ -13402,7 +13392,7 @@

示例

})();
-

deburr source npm

+

deburr source npm

_.deburr([string=''])

转换 latin-1 supplementary letters#Character_table) 为基本拉丁字母,并删除变音符

@@ -13448,7 +13438,7 @@

示例

})();
-

endsWith source npm

+

endsWith source npm

_.endsWith([string=''], [target], [position=string.length])

检查给定的字符是否是字符串的结尾

@@ -13504,7 +13494,7 @@

示例

})();
-

escape source npm

+

escape source npm

_.escape([string=''])

转义字符 "&", "<", ">", '"', "'", 以及 "`" 为HTML实体字符。 @@ -13569,7 +13559,7 @@

示例

})();
-

escapeRegExp source npm

+

escapeRegExp source npm

_.escapeRegExp([string=''])

转义RegExp 中特殊的字符 "^", "$", "\", ".", "*", "+", @@ -13616,7 +13606,7 @@

示例

})();
-

kebabCase source npm

+

kebabCase source npm

_.kebabCase([string=''])

转换字符串为 kebab case

@@ -13668,7 +13658,7 @@

示例

})();
-

lowerCase source npm

+

lowerCase source npm

_.lowerCase([string=''])

以空格分开单词并转换为小写。

@@ -13720,7 +13710,7 @@

示例

})();
-

lowerFirst source npm

+

lowerFirst source npm

_.lowerFirst([string=''])

转换首字母为小写。

@@ -13769,7 +13759,7 @@

示例

})();
-

pad source npm

+

pad source npm

_.pad([string=''], [length=0], [chars=' '])

如果字符串长度小于 length 则从左到右填充字符。 @@ -13826,7 +13816,7 @@

示例

})();
-

padEnd source npm

+

padEnd source npm

_.padEnd([string=''], [length=0], [chars=' '])

如果字符串长度小于 length 则在右侧填充字符。 如果超出长度则截断超出的部分。

@@ -13882,7 +13872,7 @@

示例

})();
-

padStart source npm

+

padStart source npm

_.padStart([string=''], [length=0], [chars=' '])

如果字符串长度小于 length 则在左侧填充字符。 如果超出长度则截断超出的部分。

@@ -13938,7 +13928,7 @@

示例

})();
-

parseInt source npm

+

parseInt source npm

_.parseInt(string, [radix])

以指定的基数转换字符串为整数。 @@ -13994,7 +13984,7 @@

示例

})();
-

repeat source npm

+

repeat source npm

_.repeat([string=''], [n=0])

重复 N 次字符串

@@ -14048,7 +14038,7 @@

示例

})();
-

replace source npm

+

replace source npm

_.replace([string=''], pattern, 要替换的内容)

替换字符串中匹配的内容为给定的内容 @@ -14100,7 +14090,7 @@

示例

})();
-

snakeCase source npm

+

snakeCase source npm

_.snakeCase([string=''])

转换字符串为 snake case

@@ -14152,7 +14142,7 @@

示例

})();
-

split source npm

+

split source npm

_.split([string=''], [separator], [limit])

separator 拆分字符串 @@ -14205,7 +14195,7 @@

示例

})();
-

startCase source npm

+

startCase source npm

_.startCase([string=''])

转换字符串为 start case

@@ -14257,7 +14247,7 @@

示例

})();
-

startsWith source npm

+

startsWith source npm

_.startsWith([string=''], [target], [position=0])

检查字符串是否以 target 开头。

@@ -14313,7 +14303,7 @@

示例

})();
-

template source npm

+

template source npm

_.template([string=''], [options])

创建一个预编译模板方法,可以插入数据到模板中 "interpolate" 分隔符相应的位置。 @@ -14451,7 +14441,7 @@

示例

})();
-

toLower source npm

+

toLower source npm

_.toLower([string=''])

转换整体的字符串为小写

@@ -14503,7 +14493,7 @@

示例

})();
-

toUpper source npm

+

toUpper source npm

_.toUpper([string=''])

转换整体的字符串为大写

@@ -14555,7 +14545,7 @@

示例

})();
-

trim source npm

+

trim source npm

_.trim([string=''], [chars=whitespace])

从字符串中移除前面和后面的空白 或 指定的字符。

@@ -14609,7 +14599,7 @@

示例

})();
-

trimEnd source npm

+

trimEnd source npm

_.trimEnd([string=''], [chars=whitespace])

移除字符串后面的空白 或 指定的字符。

@@ -14660,7 +14650,7 @@

示例

})();
-

trimStart source npm

+

trimStart source npm

_.trimStart([string=''], [chars=whitespace])

移除字符串中前面的空白 或 指定的字符。

@@ -14711,7 +14701,7 @@

示例

})();
-

truncate source npm

+

truncate source npm

_.truncate([string=''], [options])

截断字符串,如果字符串超出了限定的最大值。 @@ -14783,7 +14773,7 @@

示例

})();
-

unescape source npm

+

unescape source npm

_.unescape([string=''])

反向版 _.escape。 @@ -14834,7 +14824,7 @@

示例

})();
-

upperCase source npm

+

upperCase source npm

_.upperCase([string=''])

转换字符串为空格分割的大写单词

@@ -14886,7 +14876,7 @@

示例

})();
-

upperFirst source npm

+

upperFirst source npm

_.upperFirst([string=''])

转换首字母为大写。

@@ -14935,7 +14925,7 @@

示例

})();
-

words source npm

+

words source npm

_.words([string=''], [pattern])

拆分字符串中的词为数组

@@ -14986,23 +14976,23 @@

示例

})();
-

attempt source npm

+

attempt source npm

_.attempt(func)
-

Attempts to invoke func, returning either the result or the caught error -object. Any additional arguments are provided to func when it's invoked.

+

尝试调用函数,返回结果 或者 错误对象。 +任何附加的参数都会在调用时传给函数。

参数

    -
  1. func (Function)

    The function to attempt.

    +
  2. func (Function)

    要调用的函数

返回值 (*)

-

Returns the func result or error object.

+

返回函数结果或者错误对象

示例

-
// avoid throwing errors for invalid selectors
+    
// 避免因为错误的选择器而抛出
 var elements = _.attempt(function(selector) {
   return document.querySelectorAll(selector);
 }, '>_>');
@@ -15039,21 +15029,20 @@ 

示例

})();
-

bindAll source npm

+

bindAll source npm

_.bindAll(object, methodNames)
-

Binds methods of an object to the object itself, overwriting the existing -method. +

绑定对象的方法到对象本身,覆盖已存在的方法。

-注意: This method doesn't set the "length" property of bound functions.

+注意: 这个方法不会设置 "length" 属性到约束的函数。

参数

    -
  1. object (Object)

    The object to bind and assign the bound methods to.

    +
  2. object (Object)

    要绑定的对象

  3. -
  4. methodNames (...(string|string[])

    The object method names to bind, specified individually or in arrays.

    +
  5. methodNames (...(string|string[])

    要绑定的方法名 单独指定或指定在数组中。

返回值 (Object)

@@ -15099,22 +15088,20 @@

示例

})();
-

cond source npm

+

cond source npm

_.cond(pairs)
-

Creates a function that iterates over pairs invoking the corresponding -function of the first predicate to return truthy. The predicate-function -pairs are invoked with the this binding and arguments of the created -function.

+

创建一个函数。 +这个函数会遍历 pairs,并执行最先返回真值对应的函数,并绑定 this 及传入创建函数的参数。

参数

    -
  1. pairs (Array)

    The predicate-function pairs.

    +
  2. pairs (Array)

    判断函数对

返回值 (Function)

-

Returns the new function.

+

返回新的函数

示例

var func = _.cond([
@@ -15124,13 +15111,13 @@ 

示例

]) func({ 'a': 1, 'b': 2 }); -// => 'matches A' +// => 输出:'matches A' func({ 'a': 0, 'b': 1 }); -// => 'matches B' +// => 输出:'matches B' func({ 'a': '1', 'b': '2' }); -// => 'no match' +// => 输出:'no match'
@@ -15160,21 +15147,21 @@

示例

})();
-

conforms source npm

+

conforms source npm

_.conforms(source)
-

Creates a function that invokes the predicate properties of source with -the corresponding property values of a given object, returning true if -all predicates return truthy否则返回 false

+

创建一个函数。 +这个函数会调用 source 的属性名对应的 predicate 与传入对象相对应属性名的值进行 predicate 处理。 +如果都符合返回 true,否则返回 false

参数

    -
  1. source (Object)

    The object of property predicates to conform to.

    +
  2. source (Object)

    包含 predicates 属性值的对象

返回值 (Function)

-

Returns the new function.

+

返回新的函数

示例

var users = [
@@ -15213,19 +15200,19 @@ 

示例

})();
-

constant source npm

+

constant source npm

_.constant(value)
-

Creates a function that returns value.

+

创建一个返回 value 的函数

参数

    -
  1. value (*)

    The value to return from the new function.

    +
  2. value (*)

    要返回的值

返回值 (Function)

-

Returns the new function.

+

返回新的函数

示例

var object = { 'user': 'fred' };
@@ -15262,21 +15249,21 @@ 

示例

})();
-

flow source npm

+

flow source npm

_.flow([funcs])
-

Creates a function that returns the result of invoking the provided -functions with the this binding of the created function, where each -successive invocation is supplied the return value of the previous.

+

创建一个函数。 +返回的结果是调用提供函数的结果,this 会绑定到创建函数。 +每一个连续调用,传入的参数都是前一个函数返回的结果。

参数

    -
  1. [funcs] (...(Function|Function[])

    Functions to invoke.

    +
  2. [funcs] (...(Function|Function[])

    要调用的函数

返回值 (Function)

-

Returns the new function.

+

返回新的函数

示例

function square(n) {
@@ -15315,20 +15302,19 @@ 

示例

})();
-

flowRight source npm

+

flowRight source npm

_.flowRight([funcs])
-

这个方法类似 _.flow except that it creates a function that -invokes the provided functions from right to left.

+

这个方法类似 _.flow,除了它调用函数的顺序是从右往左的。

参数

    -
  1. [funcs] (...(Function|Function[])

    Functions to invoke.

    +
  2. [funcs] (...(Function|Function[])

    要调用的函数

返回值 (Function)

-

Returns the new function.

+

返回新的函数

示例

function square(n) {
@@ -15367,19 +15353,19 @@ 

示例

})();
-

identity source npm

+

identity source npm

_.identity(value)
-

This method returns the first argument provided to it.

+

这个方法返回首个提供的参数

参数

    -
  1. value (*)

    Any value.

    +
  2. value (*)

    任何值

返回值 (*)

-

Returns value.

+

返回 value

示例

var object = { 'user': 'fred' };
@@ -15415,22 +15401,22 @@ 

示例

})();
-

iteratee source npm

+

iteratee source npm

_.iteratee([func=_.identity])
-

创建一个调用 func 的函数。 with the arguments of the created -function. If func is a property name the created callback returns the -property value for a given element. If func is an object the created -callback returns true for elements that contain the equivalent object properties, otherwise it returns false.

+

创建一个调用 func 的函数。 +如果 func 是一个属性名,传入包含这个属性名的对象,回调返回对应属性名的值。 +如果 func 是一个对象,传入的元素有相同的对象属性,回调返回 true。 +其他情况返回 false

参数

    -
  1. [func=_.identity] (*)

    The value to convert to a callback.

    +
  2. [func=_.identity] (*)

    转换成 callback 的值

返回值 (Function)

-

Returns the callback.

+

返回 callback.

示例

var users = [
@@ -15438,7 +15424,7 @@ 

示例

{ 'user': 'fred', 'age': 40 } ]; -// wrap to create custom callback shorthands +// 使用 wrap 创建一个自定义回调速写 _.iteratee = _.wrap(_.iteratee, function(callback, func, thisArg) { var match = /^(.+?)__([gl]t)(.+)$/.exec(func); if (!match) { @@ -15482,24 +15468,23 @@

示例

})();
-

matches source npm

+

matches source npm

_.matches(source)
-

Creates a function that performs a deep partial comparison between a given -object and source, returning true if the given object has equivalent -property values否则返回 false +

创建一个深比较的方法来比较给定的对象和 source 对象。 +如果给定的对象拥有相同的属性值返回 true,否则返回 false

-注意: This method supports comparing the same values as _.isEqual.

+注意: 这个方法支持以 _.isEqual 的方式比较相同的值。

参数

    -
  1. source (Object)

    The object of property values to match.

    +
  2. source (Object)

    要匹配的源对象

返回值 (Function)

-

Returns the new function.

+

返回新的函数

示例

var users = [
@@ -15538,26 +15523,25 @@ 

示例

})();
-

matchesProperty source npm

+

matchesProperty source npm

_.matchesProperty(path, srcValue)
-

Creates a function that performs a deep partial comparison between the -value at path of a given object to srcValue, returning true if the -object value is equivalent否则返回 false +

创建一个深比较的方法来比较给定对象的 path 的值是否是 srcValue。 +如果是返回 true,否则返回 false

-注意: This method supports comparing the same values as _.isEqual.

+注意: 这个方法支持以 _.isEqual 的方式比较相同的值。

参数

    -
  1. path (Array|string)

    The path of the property to get.

    +
  2. path (Array|string)

    给定对象的属性路径名

  3. -
  4. srcValue (*)

    The value to match.

    +
  5. srcValue (*)

    要匹配的值

返回值 (Function)

-

Returns the new function.

+

返回新的函数

示例

var users = [
@@ -15596,22 +15580,22 @@ 

示例

})();
-

method source npm

+

method source npm

_.method(path, [args])
-

Creates a function that invokes the method at path of a given object. -Any additional arguments are provided to the invoked method.

+

创建一个调用给定对象 path 上的函数。 +任何附加的参数都会传入这个调用函数中。

参数

    -
  1. path (Array|string)

    The path of the method to invoke.

    +
  2. path (Array|string)

    调用函数所在对象的路径

  3. -
  4. [args] (...*)

    The arguments to invoke the method with.

    +
  5. [args] (...*)

    传递给调用函数的参数

返回值 (Function)

-

Returns the new function.

+

返回新的函数

示例

var objects = [
@@ -15653,23 +15637,23 @@ 

示例

})();
-

methodOf source npm

+

methodOf source npm

_.methodOf(object, [args])
-

The opposite of _.method; this method creates a function that invokes -the method at a given path of object. Any additional arguments are -provided to the invoked method.

+

反向版 _.method。 +这个创建一个函数调用给定 objectpath 上的方法, +任何附加的参数都会传入这个调用函数中。

参数

  1. object (Object)

    要检索的对象

  2. -
  3. [args] (...*)

    The arguments to invoke the method with.

    +
  4. [args] (...*)

    传递给调用函数的参数

返回值 (Function)

-

Returns the new function.

+

返回新的函数

示例

var array = _.times(3, _.constant),
@@ -15709,27 +15693,25 @@ 

示例

})();
-

mixin source npm

+

mixin source npm

_.mixin([object=lodash], source, [options])
-

Adds all own enumerable function properties of a source object to the -destination object. If object is a function then methods are added to -its prototype as well. +

添加来源对象自身的所有可枚举函数属性到目标对象。 +如果 object 是个函数,那么函数方法将被添加到原型链上。

-注意: Use _.runInContext to create a pristine lodash function to -avoid conflicts caused by modifying the original.

+注意: 使用 _.runInContext 来创建原始的 lodash 函数来避免修改造成的冲突。

参数

  1. [object=lodash] (Function|Object)

    目标对象

  2. -
  3. source (Object)

    The object of functions to add.

    +
  4. source (Object)

    来源对象

  5. -
  6. [options] (Object)

    The options object.

    +
  7. [options] (Object)

    选项对象

  8. -
  9. [options.chain=true] (boolean)

    Specify whether the functions added are chainable.

    +
  10. [options.chain=true] (boolean)

    是否开启链式操作

返回值 (Function|Object)

@@ -15781,15 +15763,14 @@

示例

})();
-

noConflict source npm

+

noConflict source npm

_.noConflict()
-

Reverts the _ variable to its previous value and returns a reference to -the lodash function.

+

释放 _ 为原来的值,并返回一个 lodash 的引用

返回值 (Function)

-

Returns the lodash function.

+

返回 lodash 函数

示例

var lodash = _.noConflict();
@@ -15822,11 +15803,10 @@ 

示例

})();
-

noop source npm

+

noop source npm

_.noop()
-

A no-operation function that returns undefined regardless of the -arguments it receives.

+

无论传递什么参数,都返回 undefined

示例

@@ -15863,19 +15843,19 @@

示例

})();
-

nthArg source npm

+

nthArg source npm

_.nthArg([n=0])
-

Creates a function that returns its nth argument.

+

创建一个返回第 N 个参数的函数。

参数

    -
  1. [n=0] (number)

    The index of the argument to return.

    +
  2. [n=0] (number)

    要返回参数的索引

返回值 (Function)

-

Returns the new function.

+

返回新的函数

示例

var func = _.nthArg(1);
@@ -15911,20 +15891,19 @@ 

示例

})();
-

over source npm

+

over source npm

_.over(iteratees)
-

Creates a function that invokes iteratees with the arguments provided -to the created function and returns their results.

+

创建一个传入提供的参数的函数并调用 iteratees 返回结果的函数。

参数

    -
  1. iteratees (...(Function|Function[])

    The iteratees to invoke.

    +
  2. iteratees (...(Function|Function[])

    要调用的 iteratees

返回值 (Function)

-

Returns the new function.

+

返回新的函数

示例

var func = _.over(Math.max, Math.min);
@@ -15960,20 +15939,19 @@ 

示例

})();
-

overEvery source npm

+

overEvery source npm

_.overEvery(predicates)
-

Creates a function that checks if all of the predicates return -truthy when invoked with the arguments provided to the created function.

+

创建一个传入提供的参数的函数并调用 iteratees 判断是否 全部 都为真值的函数。

参数

    -
  1. predicates (...(Function|Function[])

    The predicates to check.

    +
  2. predicates (...(Function|Function[])

    要调用的 predicates

返回值 (Function)

-

Returns the new function.

+

返回新的函数

示例

var func = _.overEvery(Boolean, isFinite);
@@ -16015,20 +15993,19 @@ 

示例

})();
-

overSome source npm

+

overSome source npm

_.overSome(predicates)
-

Creates a function that checks if any of the predicates return -truthy when invoked with the arguments provided to the created function.

+

创建一个传入提供的参数的函数并调用 iteratees 判断是否 存在 有真值的函数。

参数

    -
  1. predicates (...(Function|Function[])

    The predicates to check.

    +
  2. predicates (...(Function|Function[])

    要调用的 predicates

返回值 (Function)

-

Returns the new function.

+

返回新的函数

示例

var func = _.overSome(Boolean, isFinite);
@@ -16070,19 +16047,19 @@ 

示例

})();
-

property source npm

+

property source npm

_.property(path)
-

Creates a function that returns the value at path of a given object.

+

创建一个返回给定对象的 path 的值的函数。

参数

    -
  1. path (Array|string)

    The path of the property to get.

    +
  2. path (Array|string)

    要得到值的属性路径

返回值 (Function)

-

Returns the new function.

+

返回新的函数

示例

var objects = [
@@ -16124,11 +16101,11 @@ 

示例

})();
-

propertyOf source npm

+

propertyOf source npm

_.propertyOf(object)
-

The opposite of _.property; this method creates a function that returns -the value at a given path of object.

+

反向版 _.property。 +这个方法创建的函数返回给定 path 在对象上的值。

参数

@@ -16137,7 +16114,7 @@

参数

返回值 (Function)

-

Returns the new function.

+

返回新的函数

示例

var array = [0, 1, 2],
@@ -16177,31 +16154,29 @@ 

示例

})();
-

range source npm

+

range source npm

_.range([start=0], end, [step=1])
-

Creates an array of numbers (positive and/or negative) progressing from -start up to, but not including, end. A step of -1 is used if a negative -start is specified without an end or step. If end is not specified -it's set to start with start then set to 0. If end is less than -start a zero-length range is created unless a negative step is specified. +

创建一个包含从 startend,但不包含 end 本身范围数字的数组。 +如果 start 是负数,而 endstep 没有指定,那么 step-1 为开始。 +如果 end 没有指定,start 设置为 0。 +如果 end 小于 start,会创建一个空数组,除非指定了 step

-注意: JavaScript follows the IEEE-754 standard for resolving -floating-point values which can produce unexpected results.

+注意: JavaScript 遵循 IEEE-754 标准处理无法预料的浮点数结果。

参数

    -
  1. [start=0] (number)

    The start of the range.

    +
  2. [start=0] (number)

    开始的范围

  3. -
  4. end (number)

    The end of the range.

    +
  5. end (number)

    结束的范围

  6. -
  7. [step=1] (number)

    The value to increment or decrement by.

    +
  8. [step=1] (number)

    范围的增量 或者 减量

返回值 (Array)

-

Returns the new array of numbers.

+

返回范围内数字组成的新数组

示例

_.range(4);
@@ -16253,24 +16228,24 @@ 

示例

})();
-

rangeRight source npm

+

rangeRight source npm

_.rangeRight([start=0], end, [step=1])
-

这个方法类似 _.range except that it populates values in -descending order.

+

这个方法类似 _.range, +除了它是降序生成值的。

参数

    -
  1. [start=0] (number)

    The start of the range.

    +
  2. [start=0] (number)

    开始的范围

  3. -
  4. end (number)

    The end of the range.

    +
  5. end (number)

    结束的范围

  6. -
  7. [step=1] (number)

    The value to increment or decrement by.

    +
  8. [step=1] (number)

    范围的增量 或者 减量

返回值 (Array)

-

Returns the new array of numbers.

+

返回范围内数字组成的新数组

示例

_.rangeRight(4);
@@ -16390,22 +16365,22 @@ 

示例

})();
-

times source npm

+

times source npm

_.times(n, [iteratee=_.identity])
-

Invokes the iteratee function n times, returning an array of the results -of each invocation. The iteratee is invoked with one argument; (index).

+

调用 iteratee N 次,每次调用返回的结果存入到数组中。 +iteratee 会传入1个参数:(index)。

参数

    -
  1. n (number)

    The number of times to invoke iteratee.

    +
  2. n (number)

    要调用 iteratee 的次数

  3. [iteratee=_.identity] (Function)

    这个函数会处理每一个元素

返回值 (Array)

-

Returns the array of results.

+

返回调用结果的数组

示例

_.times(3, String);
@@ -16442,19 +16417,19 @@ 

示例

})();
-

toPath source npm

+

toPath source npm

_.toPath(value)
-

Converts value to a property path array.

+

创建 value 为属性路径的数组

参数

    -
  1. value (*)

    The value to convert.

    +
  2. value (*)

    要转换的值

返回值 (Array)

-

Returns the new property path array.

+

返回包含属性路径的数组

示例

_.toPath('a.b.c');
@@ -16500,19 +16475,20 @@ 

示例

})();
-

uniqueId source npm

+

uniqueId source npm

_.uniqueId([prefix])
-

Generates a unique ID. If prefix is provided the ID is appended to it.

+

创建唯一ID。 +如果提供了 prefix,会被添加到ID前缀上。

参数

    -
  1. [prefix] (string)

    The value to prefix the ID with.

    +
  2. [prefix] (string)

    要添加到ID前缀的值

返回值 (string)

-

Returns the unique ID.

+

返回唯一ID

示例

_.uniqueId('contact_');
diff --git a/assign.html b/assign.html
index d0091d0..3884437 100644
--- a/assign.html
+++ b/assign.html
@@ -392,7 +392,7 @@
 
 
-

assign source npm

+

assign source npm

_.assign(object, [sources])

分配来源对象的可枚举属性到目标对象上。 diff --git a/assignIn.html b/assignIn.html index bf6e6a2..e74e4b4 100644 --- a/assignIn.html +++ b/assignIn.html @@ -392,7 +392,7 @@

-

assignIn extend source npm

+

assignIn extend source npm

_.assignIn(object, [sources])

这个方法类似 _.assign。 diff --git a/assignInWith.html b/assignInWith.html index f6ef88f..5388134 100644 --- a/assignInWith.html +++ b/assignInWith.html @@ -392,7 +392,7 @@

-

assignInWith extendWith source npm

+

assignInWith extendWith source npm

_.assignInWith(object, sources, [customizer])

这个方法类似 _.assignIn。 diff --git a/assignWith.html b/assignWith.html index 002f427..26d581e 100644 --- a/assignWith.html +++ b/assignWith.html @@ -392,7 +392,7 @@

-

assignWith source npm

+

assignWith source npm

_.assignWith(object, sources, [customizer])

这个方法类似 _.assign。 diff --git a/at.html b/at.html index 08fbb14..eeb578c 100644 --- a/at.html +++ b/at.html @@ -392,7 +392,7 @@

-

at source npm

+

at source npm

_.at(object, [paths])

根据 object 的路径获取值为数组。

diff --git a/attempt.html b/attempt.html index cf98ada..8e10f46 100644 --- a/attempt.html +++ b/attempt.html @@ -392,23 +392,23 @@
-

attempt source npm

+

attempt source npm

_.attempt(func)
-

Attempts to invoke func, returning either the result or the caught error -object. Any additional arguments are provided to func when it's invoked.

+

尝试调用函数,返回结果 或者 错误对象。 +任何附加的参数都会在调用时传给函数。

参数

    -
  1. func (Function)

    The function to attempt.

    +
  2. func (Function)

    要调用的函数

返回值 (*)

-

Returns the func result or error object.

+

返回函数结果或者错误对象

示例

-
// avoid throwing errors for invalid selectors
+    
// 避免因为错误的选择器而抛出
 var elements = _.attempt(function(selector) {
   return document.querySelectorAll(selector);
 }, '>_>');
diff --git a/bind.html b/bind.html
index 2869d06..2cfdaba 100644
--- a/bind.html
+++ b/bind.html
@@ -392,13 +392,11 @@
 
 
-

bind source npm

+

bind source npm

_.bind(func, thisArg, [partials])

创建一个函数 func,这个函数的 this 会被绑定在 thisArg。 并且任何附加在 _.bind 的参数会被传入到这个绑定函数上。 -
-
这个 _.bind.placeholder 的值,默认是以 _ 作为附加部分参数的占位符。

diff --git a/bindAll.html b/bindAll.html index ee8d76c..d96b555 100644 --- a/bindAll.html +++ b/bindAll.html @@ -392,21 +392,20 @@

-

bindAll source npm

+

bindAll source npm

_.bindAll(object, methodNames)
-

Binds methods of an object to the object itself, overwriting the existing -method. +

绑定对象的方法到对象本身,覆盖已存在的方法。

-注意: This method doesn't set the "length" property of bound functions.

+注意: 这个方法不会设置 "length" 属性到约束的函数。

参数

    -
  1. object (Object)

    The object to bind and assign the bound methods to.

    +
  2. object (Object)

    要绑定的对象

  3. -
  4. methodNames (...(string|string[])

    The object method names to bind, specified individually or in arrays.

    +
  5. methodNames (...(string|string[])

    要绑定的方法名 单独指定或指定在数组中。

返回值 (Object)

diff --git a/bindKey.html b/bindKey.html index d3307d6..16a87c3 100644 --- a/bindKey.html +++ b/bindKey.html @@ -392,7 +392,7 @@
-

bindKey source npm

+

bindKey source npm

_.bindKey(object, key, [partials])

创建一个函数。 diff --git a/camelCase.html b/camelCase.html index 1997436..005a818 100644 --- a/camelCase.html +++ b/camelCase.html @@ -392,7 +392,7 @@

-

camelCase source npm

+

camelCase source npm

_.camelCase([string=''])

转换字符串为 驼峰写法

diff --git a/capitalize.html b/capitalize.html index 196394c..a783d64 100644 --- a/capitalize.html +++ b/capitalize.html @@ -392,7 +392,7 @@
-

capitalize source npm

+

capitalize source npm

_.capitalize([string=''])

转换字符串首字母为大写,剩下为小写。

diff --git a/ceil.html b/ceil.html index 874c2d4..7dc1d79 100644 --- a/ceil.html +++ b/ceil.html @@ -392,7 +392,7 @@
-

ceil source npm

+

ceil source npm

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

根据 precision 向上舍入 number

diff --git a/clamp.html b/clamp.html index d7ad471..5eef167 100644 --- a/clamp.html +++ b/clamp.html @@ -392,7 +392,7 @@
-

clamp source npm

+

clamp source npm

_.clamp(number, [min], max)

返回限制在 minmax 之间的值

diff --git a/clone.html b/clone.html index 58ef76a..faee6fc 100644 --- a/clone.html +++ b/clone.html @@ -392,7 +392,7 @@
-

clone source npm

+

clone source npm

_.clone(value)

创建一个 value 的浅拷贝。 diff --git a/cloneDeep.html b/cloneDeep.html index 68ec2e3..5ae5f1c 100644 --- a/cloneDeep.html +++ b/cloneDeep.html @@ -392,7 +392,7 @@

-

cloneDeep source npm

+

cloneDeep source npm

_.cloneDeep(value)

这个方法类似 _.clone,除了它会递归拷贝 value

diff --git a/cloneDeepWith.html b/cloneDeepWith.html index 5c38b94..493cadb 100644 --- a/cloneDeepWith.html +++ b/cloneDeepWith.html @@ -392,7 +392,7 @@
-

cloneDeepWith source npm

+

cloneDeepWith source npm

_.cloneDeepWith(value, [customizer])

这个方法类似 _.cloneWith,除了它会递归拷贝 value

diff --git a/cloneWith.html b/cloneWith.html index 437f832..d24b5c3 100644 --- a/cloneWith.html +++ b/cloneWith.html @@ -392,7 +392,7 @@
-

cloneWith source npm

+

cloneWith source npm

_.cloneWith(value, [customizer])

这个方法类似 _.clone,除了它接受一个 customizer 定制返回的拷贝值。 diff --git a/cond.html b/cond.html index aa0ff1e..f42f19a 100644 --- a/cond.html +++ b/cond.html @@ -392,22 +392,20 @@

-

cond source npm

+

cond source npm

_.cond(pairs)
-

Creates a function that iterates over pairs invoking the corresponding -function of the first predicate to return truthy. The predicate-function -pairs are invoked with the this binding and arguments of the created -function.

+

创建一个函数。 +这个函数会遍历 pairs,并执行最先返回真值对应的函数,并绑定 this 及传入创建函数的参数。

参数

    -
  1. pairs (Array)

    The predicate-function pairs.

    +
  2. pairs (Array)

    判断函数对

返回值 (Function)

-

Returns the new function.

+

返回新的函数

示例

var func = _.cond([
@@ -417,13 +415,13 @@ 

示例

]) func({ 'a': 1, 'b': 2 }); -// => 'matches A' +// => 输出:'matches A' func({ 'a': 0, 'b': 1 }); -// => 'matches B' +// => 输出:'matches B' func({ 'a': '1', 'b': '2' }); -// => 'no match' +// => 输出:'no match'
diff --git a/conforms.html b/conforms.html index 25b2671..e877ffa 100644 --- a/conforms.html +++ b/conforms.html @@ -392,21 +392,21 @@
-

conforms source npm

+

conforms source npm

_.conforms(source)
-

Creates a function that invokes the predicate properties of source with -the corresponding property values of a given object, returning true if -all predicates return truthy否则返回 false

+

创建一个函数。 +这个函数会调用 source 的属性名对应的 predicate 与传入对象相对应属性名的值进行 predicate 处理。 +如果都符合返回 true,否则返回 false

参数

    -
  1. source (Object)

    The object of property predicates to conform to.

    +
  2. source (Object)

    包含 predicates 属性值的对象

返回值 (Function)

-

Returns the new function.

+

返回新的函数

示例

var users = [
diff --git a/constant.html b/constant.html
index da495f9..d3a5567 100644
--- a/constant.html
+++ b/constant.html
@@ -392,19 +392,19 @@
 
 
-

constant source npm

+

constant source npm

_.constant(value)
-

Creates a function that returns value.

+

创建一个返回 value 的函数

参数

    -
  1. value (*)

    The value to return from the new function.

    +
  2. value (*)

    要返回的值

返回值 (Function)

-

Returns the new function.

+

返回新的函数

示例

var object = { 'user': 'fred' };
diff --git a/create.html b/create.html
index 91711ec..c4a4e26 100644
--- a/create.html
+++ b/create.html
@@ -392,7 +392,7 @@
 
 
-

create source npm

+

create source npm

_.create(prototype, [properties])

创建一个继承 prototype 的对象。 diff --git a/curry.html b/curry.html index 3749dc5..1013ef0 100644 --- a/curry.html +++ b/curry.html @@ -392,7 +392,7 @@

-

curry source npm

+

curry source npm

_.curry(func, [arity=func.length])

创建一个函数,该函数接收一个或多个 func 的参数。 diff --git a/curryRight.html b/curryRight.html index fcf4554..ce0704d 100644 --- a/curryRight.html +++ b/curryRight.html @@ -392,7 +392,7 @@

-

curryRight source npm

+

curryRight source npm

_.curryRight(func, [arity=func.length])

这个方法类似 _.curry。 diff --git a/debounce.html b/debounce.html index 5563f82..bb453bd 100644 --- a/debounce.html +++ b/debounce.html @@ -392,7 +392,7 @@

-

debounce source npm

+

debounce source npm

_.debounce(func, [wait=0], [options])

创建一个防抖动函数。 diff --git a/deburr.html b/deburr.html index 6b9a931..9ed2c32 100644 --- a/deburr.html +++ b/deburr.html @@ -392,7 +392,7 @@

-

deburr source npm

+

deburr source npm

_.deburr([string=''])

转换 latin-1 supplementary letters#Character_table) 为基本拉丁字母,并删除变音符

diff --git a/defaults.html b/defaults.html index 66cb3d1..c106a14 100644 --- a/defaults.html +++ b/defaults.html @@ -392,7 +392,7 @@
-

defaults source npm

+

defaults source npm

_.defaults(object, [sources])

分配来源对象的可枚举属性到目标对象所有解析为 undefined 的属性上。 diff --git a/defaultsDeep.html b/defaultsDeep.html index b69f1f8..9b2e5d2 100644 --- a/defaultsDeep.html +++ b/defaultsDeep.html @@ -392,7 +392,7 @@

-

defaultsDeep source npm

+

defaultsDeep source npm

_.defaultsDeep(object, [sources])

这个方法类似 _.defaults,除了它会递归分配默认属性。 diff --git a/defer.html b/defer.html index 2ba6e15..ee9ddb7 100644 --- a/defer.html +++ b/defer.html @@ -392,7 +392,7 @@

-

defer source npm

+

defer source npm

_.defer(func, [args])

延迟调用 func 直到当前堆栈清理完毕。 diff --git a/delay.html b/delay.html index f33bee5..17889e6 100644 --- a/delay.html +++ b/delay.html @@ -392,7 +392,7 @@

-

delay source npm

+

delay source npm

_.delay(func, wait, [args])

延迟 wait 毫秒后调用 func。 diff --git a/endsWith.html b/endsWith.html index cdc9dc0..20c8185 100644 --- a/endsWith.html +++ b/endsWith.html @@ -392,7 +392,7 @@

-

endsWith source npm

+

endsWith source npm

_.endsWith([string=''], [target], [position=string.length])

检查给定的字符是否是字符串的结尾

diff --git a/eq.html b/eq.html index 52e9e53..5d18897 100644 --- a/eq.html +++ b/eq.html @@ -392,7 +392,7 @@
-

eq source npm

+

eq source npm

_.eq(value, other)

执行 SameValueZero 比较两者的值确定它们是否相等。

diff --git a/escape.html b/escape.html index 2a5acb1..8caa7b9 100644 --- a/escape.html +++ b/escape.html @@ -392,7 +392,7 @@
-

escape source npm

+

escape source npm

_.escape([string=''])

转义字符 "&", "<", ">", '"', "'", 以及 "`" 为HTML实体字符。 diff --git a/escapeRegExp.html b/escapeRegExp.html index eddab37..14f8af1 100644 --- a/escapeRegExp.html +++ b/escapeRegExp.html @@ -392,7 +392,7 @@

-

escapeRegExp source npm

+

escapeRegExp source npm

_.escapeRegExp([string=''])

转义RegExp 中特殊的字符 "^", "$", "\", ".", "*", "+", diff --git a/findKey.html b/findKey.html index 618c12c..2d910a2 100644 --- a/findKey.html +++ b/findKey.html @@ -392,7 +392,7 @@

-

findKey source npm

+

findKey source npm

_.findKey(object, [predicate=_.identity])

这个方法类似 _.find。 diff --git a/findLastKey.html b/findLastKey.html index 91273fe..df073bb 100644 --- a/findLastKey.html +++ b/findLastKey.html @@ -392,7 +392,7 @@

-

findLastKey source npm

+

findLastKey source npm

_.findLastKey(object, [predicate=_.identity])

这个方法类似 _.findKey。 diff --git a/flip.html b/flip.html index 8e315a4..3e7c245 100644 --- a/flip.html +++ b/flip.html @@ -392,7 +392,7 @@

-

flip source npm

+

flip source npm

_.flip(func)

创建一个翻转接收参数的 func 函数。

diff --git a/floor.html b/floor.html index 62f262b..763ac7e 100644 --- a/floor.html +++ b/floor.html @@ -392,7 +392,7 @@
-

floor source npm

+

floor source npm

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

根据 precision 向下保留 number

diff --git a/flow.html b/flow.html index 342a6cb..053276b 100644 --- a/flow.html +++ b/flow.html @@ -392,21 +392,21 @@
-

flow source npm

+

flow source npm

_.flow([funcs])
-

Creates a function that returns the result of invoking the provided -functions with the this binding of the created function, where each -successive invocation is supplied the return value of the previous.

+

创建一个函数。 +返回的结果是调用提供函数的结果,this 会绑定到创建函数。 +每一个连续调用,传入的参数都是前一个函数返回的结果。

参数

    -
  1. [funcs] (...(Function|Function[])

    Functions to invoke.

    +
  2. [funcs] (...(Function|Function[])

    要调用的函数

返回值 (Function)

-

Returns the new function.

+

返回新的函数

示例

function square(n) {
diff --git a/flowRight.html b/flowRight.html
index b538702..a8342d5 100644
--- a/flowRight.html
+++ b/flowRight.html
@@ -392,20 +392,19 @@
 
 
-

flowRight source npm

+

flowRight source npm

_.flowRight([funcs])
-

这个方法类似 _.flow except that it creates a function that -invokes the provided functions from right to left.

+

这个方法类似 _.flow,除了它调用函数的顺序是从右往左的。

参数

    -
  1. [funcs] (...(Function|Function[])

    Functions to invoke.

    +
  2. [funcs] (...(Function|Function[])

    要调用的函数

返回值 (Function)

-

Returns the new function.

+

返回新的函数

示例

function square(n) {
diff --git a/forIn.html b/forIn.html
index 57d685c..540f017 100644
--- a/forIn.html
+++ b/forIn.html
@@ -392,7 +392,7 @@
 
 
-

forIn source npm

+

forIn source npm

_.forIn(object, [iteratee=_.identity])

使用 iteratee 遍历对象的自身和继承的可枚举属性。 diff --git a/forInRight.html b/forInRight.html index 2755258..140c3ab 100644 --- a/forInRight.html +++ b/forInRight.html @@ -392,7 +392,7 @@

-

forInRight source npm

+

forInRight source npm

_.forInRight(object, [iteratee=_.identity])

这个方法类似 _.forIn。 diff --git a/forOwn.html b/forOwn.html index da91d8a..42a230e 100644 --- a/forOwn.html +++ b/forOwn.html @@ -392,7 +392,7 @@

-

forOwn source npm

+

forOwn source npm

_.forOwn(object, [iteratee=_.identity])

使用 iteratee 遍历自身的可枚举属性。 diff --git a/forOwnRight.html b/forOwnRight.html index 29147bf..93ce23d 100644 --- a/forOwnRight.html +++ b/forOwnRight.html @@ -392,7 +392,7 @@

-

forOwnRight source npm

+

forOwnRight source npm

_.forOwnRight(object, [iteratee=_.identity])

这个方法类似 _.forOwn。 除了它是反方向开始遍历的。

diff --git a/functions.html b/functions.html index 628d6f5..1644245 100644 --- a/functions.html +++ b/functions.html @@ -392,7 +392,7 @@
-

functions source npm

+

functions source npm

_.functions(object)

返回一个 function 对象自身可枚举属性名的数组。

diff --git a/functionsIn.html b/functionsIn.html index 66b746d..35eb9b6 100644 --- a/functionsIn.html +++ b/functionsIn.html @@ -392,7 +392,7 @@
-

functionsIn source npm

+

functionsIn source npm

_.functionsIn(object)

返回一个 function 对象自身和继承的可枚举属性名的数组。

diff --git a/get.html b/get.html index 2cee6f9..b862721 100644 --- a/get.html +++ b/get.html @@ -392,7 +392,7 @@
-

get source npm

+

get source npm

_.get(object, path, [defaultValue])

根据对象路径获取值。 diff --git a/gt.html b/gt.html index 6343045..30e6711 100644 --- a/gt.html +++ b/gt.html @@ -392,7 +392,7 @@

-

gt source npm

+

gt source npm

_.gt(value, other)

检查 value 是否大于 other

diff --git a/gte.html b/gte.html index bf3e271..15c4279 100644 --- a/gte.html +++ b/gte.html @@ -392,7 +392,7 @@
-

gte source npm

+

gte source npm

_.gte(value, other)

检查 value 是否大于等于 other

diff --git a/has.html b/has.html index d9bcb58..c2f3c48 100644 --- a/has.html +++ b/has.html @@ -392,7 +392,7 @@
-

has source npm

+

has source npm

_.has(object, path)

检查 path 是否是对象的直接属性。

diff --git a/hasIn.html b/hasIn.html index 3477ab7..d60a29f 100644 --- a/hasIn.html +++ b/hasIn.html @@ -392,7 +392,7 @@
-

hasIn source npm

+

hasIn source npm

_.hasIn(object, path)

检查 path 是否是对象的直接 或者 继承属性。

diff --git a/identity.html b/identity.html index 377f9cb..53fe398 100644 --- a/identity.html +++ b/identity.html @@ -392,19 +392,19 @@
-

identity source npm

+

identity source npm

_.identity(value)
-

This method returns the first argument provided to it.

+

这个方法返回首个提供的参数

参数

    -
  1. value (*)

    Any value.

    +
  2. value (*)

    任何值

返回值 (*)

-

Returns value.

+

返回 value

示例

var object = { 'user': 'fred' };
diff --git a/inRange.html b/inRange.html
index b2f3def..28a1796 100644
--- a/inRange.html
+++ b/inRange.html
@@ -392,7 +392,7 @@
 
 
-

inRange source npm

+

inRange source npm

_.inRange(number, [start=0], end)

检查 n 是否在 startend 之间,但不包括 end。 diff --git a/invert.html b/invert.html index a9ff885..9d8f32f 100644 --- a/invert.html +++ b/invert.html @@ -392,7 +392,7 @@

-

invert source npm

+

invert source npm

_.invert(object, [multiVal])

创建一个键值倒置的对象。 diff --git a/invoke.html b/invoke.html index 5709062..8197ec2 100644 --- a/invoke.html +++ b/invoke.html @@ -392,7 +392,7 @@

-

invoke source npm

+

invoke source npm

_.invoke(object, path, [args])

调用对象路径的方法

diff --git a/isArguments.html b/isArguments.html index 70383e3..f65c7b3 100644 --- a/isArguments.html +++ b/isArguments.html @@ -392,7 +392,7 @@
-

isArguments source npm

+

isArguments source npm

_.isArguments(value)

检查 value 是否是 类 arguments 对象。

diff --git a/isArray.html b/isArray.html index 5617935..817e814 100644 --- a/isArray.html +++ b/isArray.html @@ -392,7 +392,7 @@
-

isArray source npm

+

isArray source npm

_.isArray(value)

检查 value 是否是 Array 类对象。

diff --git a/isArrayLike.html b/isArrayLike.html index a186311..21597a6 100644 --- a/isArrayLike.html +++ b/isArrayLike.html @@ -392,7 +392,7 @@
-

isArrayLike source npm

+

isArrayLike source npm

_.isArrayLike(value)

检查 value 是否是类数组。 diff --git a/isArrayLikeObject.html b/isArrayLikeObject.html index 409b45f..9fd8231 100644 --- a/isArrayLikeObject.html +++ b/isArrayLikeObject.html @@ -392,7 +392,7 @@

-

isArrayLikeObject source npm

+

isArrayLikeObject source npm

_.isArrayLikeObject(value)

这个方法类似 _.isArrayLike,除了它还检查值是否是个对象。

diff --git a/isBoolean.html b/isBoolean.html index 0d8ffed..f2c9aa0 100644 --- a/isBoolean.html +++ b/isBoolean.html @@ -392,7 +392,7 @@
-

isBoolean source npm

+

isBoolean source npm

_.isBoolean(value)

检查 value 是否是原始 boolean 类型或者对象。

diff --git a/isDate.html b/isDate.html index 191a7ad..fffc5f4 100644 --- a/isDate.html +++ b/isDate.html @@ -392,7 +392,7 @@
-

isDate source npm

+

isDate source npm

_.isDate(value)

检查 value 是否是 Date 类型

diff --git a/isElement.html b/isElement.html index 820c31e..6814218 100644 --- a/isElement.html +++ b/isElement.html @@ -392,7 +392,7 @@
-

isElement source npm

+

isElement source npm

_.isElement(value)

检查 value 是否是可能是 DOM 元素

diff --git a/isEmpty.html b/isEmpty.html index c92bef3..bc7f41d 100644 --- a/isEmpty.html +++ b/isEmpty.html @@ -392,7 +392,7 @@
-

isEmpty source npm

+

isEmpty source npm

_.isEmpty(value)

检查 value 是否为空。 diff --git a/isEqual.html b/isEqual.html index d37593b..7060570 100644 --- a/isEqual.html +++ b/isEqual.html @@ -392,7 +392,7 @@

-

isEqual source npm

+

isEqual source npm

_.isEqual(value, other)

执行深比较来决定两者的值是否相等。 diff --git a/isEqualWith.html b/isEqualWith.html index 6a666a0..e8f77ef 100644 --- a/isEqualWith.html +++ b/isEqualWith.html @@ -392,7 +392,7 @@

-

isEqualWith source npm

+

isEqualWith source npm

_.isEqualWith(value, other, [customizer])

这个方法类似 _.isEqual。 diff --git a/isError.html b/isError.html index 441b700..195331a 100644 --- a/isError.html +++ b/isError.html @@ -392,7 +392,7 @@

-

isError source npm

+

isError source npm

_.isError(value)

检查 value 是否是 Error, EvalError, RangeError, ReferenceError, diff --git a/isFinite.html b/isFinite.html index 2cbdb9d..8202320 100644 --- a/isFinite.html +++ b/isFinite.html @@ -392,7 +392,7 @@

-

isFinite source npm

+

isFinite source npm

_.isFinite(value)

检查 value 是否是原始 finite number。 diff --git a/isFunction.html b/isFunction.html index df4a725..e22e7ef 100644 --- a/isFunction.html +++ b/isFunction.html @@ -392,7 +392,7 @@

-

isFunction source npm

+

isFunction source npm

_.isFunction(value)

检查 value 是否是 Function 对象。

diff --git a/isInteger.html b/isInteger.html index b3e2620..37e31f7 100644 --- a/isInteger.html +++ b/isInteger.html @@ -392,7 +392,7 @@
-

isInteger source npm

+

isInteger source npm

_.isInteger(value)

检查 value 是否是整数。 diff --git a/isLength.html b/isLength.html index b4887ec..33c253a 100644 --- a/isLength.html +++ b/isLength.html @@ -392,7 +392,7 @@

-

isLength source npm

+

isLength source npm

_.isLength(value)

检查 value 是否是有效长度 diff --git a/isMatch.html b/isMatch.html index 650c4b5..1c35244 100644 --- a/isMatch.html +++ b/isMatch.html @@ -392,7 +392,7 @@

-

isMatch source npm

+

isMatch source npm

_.isMatch(object, source)

执行一个深比较来确定object 是否包含有 source 的属性值。 diff --git a/isMatchWith.html b/isMatchWith.html index 6b91959..57afdff 100644 --- a/isMatchWith.html +++ b/isMatchWith.html @@ -392,7 +392,7 @@

-

isMatchWith source npm

+

isMatchWith source npm

_.isMatchWith(object, source, [customizer])

这个方法类似 _.isMatch。 diff --git a/isNaN.html b/isNaN.html index 9bb6e72..f0175bf 100644 --- a/isNaN.html +++ b/isNaN.html @@ -392,7 +392,7 @@

-

isNaN source npm

+

isNaN source npm

_.isNaN(value)

检查 value 是否是 NaN. diff --git a/isNative.html b/isNative.html index b9a3b1c..b260447 100644 --- a/isNative.html +++ b/isNative.html @@ -392,7 +392,7 @@

-

isNative source npm

+

isNative source npm

_.isNative(value)

检查 value 是否是原生函数

diff --git a/isNil.html b/isNil.html index 9168d14..319a771 100644 --- a/isNil.html +++ b/isNil.html @@ -392,7 +392,7 @@
-

isNil source npm

+

isNil source npm

_.isNil(value)

检查 value 是否是 null 或者 undefined

diff --git a/isNull.html b/isNull.html index bb7d694..1d0344c 100644 --- a/isNull.html +++ b/isNull.html @@ -392,7 +392,7 @@
-

isNull source npm

+

isNull source npm

_.isNull(value)

检查 value 是否是 null.

diff --git a/isNumber.html b/isNumber.html index c9de1e3..7149b08 100644 --- a/isNumber.html +++ b/isNumber.html @@ -392,7 +392,7 @@
-

isNumber source npm

+

isNumber source npm

_.isNumber(value)

检查 value 是否是原始数值型 或者 对象。 diff --git a/isObject.html b/isObject.html index e8eb382..f24ddc8 100644 --- a/isObject.html +++ b/isObject.html @@ -392,7 +392,7 @@

-

isObject source npm

+

isObject source npm

_.isObject(value)

检查 value 是否是 Objectlanguage type。 diff --git a/isObjectLike.html b/isObjectLike.html index c7f7004..a1851c5 100644 --- a/isObjectLike.html +++ b/isObjectLike.html @@ -392,7 +392,7 @@

-

isObjectLike source npm

+

isObjectLike source npm

_.isObjectLike(value)

检查 value 是否是 类对象。 diff --git a/isPlainObject.html b/isPlainObject.html index 5bf0526..0d40f57 100644 --- a/isPlainObject.html +++ b/isPlainObject.html @@ -392,7 +392,7 @@

-

isPlainObject source npm

+

isPlainObject source npm

_.isPlainObject(value)

检查 value 是否是普通对象。 diff --git a/isRegExp.html b/isRegExp.html index c143f45..15111e9 100644 --- a/isRegExp.html +++ b/isRegExp.html @@ -392,7 +392,7 @@

-

isRegExp source npm

+

isRegExp source npm

_.isRegExp(value)

检查 value 是否是 RegExp 对象

diff --git a/isSafeInteger.html b/isSafeInteger.html index dd58bd5..37f385c 100644 --- a/isSafeInteger.html +++ b/isSafeInteger.html @@ -392,7 +392,7 @@
-

isSafeInteger source npm

+

isSafeInteger source npm

_.isSafeInteger(value)

检查 value 是否是安全整数。 diff --git a/isString.html b/isString.html index b9471f5..efbdef7 100644 --- a/isString.html +++ b/isString.html @@ -392,7 +392,7 @@

-

isString source npm

+

isString source npm

_.isString(value)

检查 value 是否是原始字符串或者对象。

diff --git a/isSymbol.html b/isSymbol.html index 539a4d2..8923748 100644 --- a/isSymbol.html +++ b/isSymbol.html @@ -392,7 +392,7 @@
-

isSymbol source npm

+

isSymbol source npm

_.isSymbol(value)

检查 value 是否是原始 Symbol 或者对象。

diff --git a/isTypedArray.html b/isTypedArray.html index 530f2bf..95cc406 100644 --- a/isTypedArray.html +++ b/isTypedArray.html @@ -392,7 +392,7 @@
-

isTypedArray source npm

+

isTypedArray source npm

_.isTypedArray(value)

检查 value 是否是TypedArray。

diff --git a/isUndefined.html b/isUndefined.html index d98528b..05bbf75 100644 --- a/isUndefined.html +++ b/isUndefined.html @@ -392,7 +392,7 @@
-

isUndefined source npm

+

isUndefined source npm

_.isUndefined(value)

检查 value 是否是 undefined.

diff --git a/iteratee.html b/iteratee.html index 7f35676..13ff7c6 100644 --- a/iteratee.html +++ b/iteratee.html @@ -392,22 +392,22 @@
-

iteratee source npm

+

iteratee source npm

_.iteratee([func=_.identity])
-

创建一个调用 func 的函数。 with the arguments of the created -function. If func is a property name the created callback returns the -property value for a given element. If func is an object the created -callback returns true for elements that contain the equivalent object properties, otherwise it returns false.

+

创建一个调用 func 的函数。 +如果 func 是一个属性名,传入包含这个属性名的对象,回调返回对应属性名的值。 +如果 func 是一个对象,传入的元素有相同的对象属性,回调返回 true。 +其他情况返回 false

参数

    -
  1. [func=_.identity] (*)

    The value to convert to a callback.

    +
  2. [func=_.identity] (*)

    转换成 callback 的值

返回值 (Function)

-

Returns the callback.

+

返回 callback.

示例

var users = [
@@ -415,7 +415,7 @@ 

示例

{ 'user': 'fred', 'age': 40 } ]; -// wrap to create custom callback shorthands +// 使用 wrap 创建一个自定义回调速写 _.iteratee = _.wrap(_.iteratee, function(callback, func, thisArg) { var match = /^(.+?)__([gl]t)(.+)$/.exec(func); if (!match) { diff --git a/js/lodash-zh.js b/js/lodash-zh.js index c227ad3..c5e4a03 100644 --- a/js/lodash-zh.js +++ b/js/lodash-zh.js @@ -864,7 +864,7 @@ * * @private * @param {Function} func The function to cap arguments for. - * @returns {Function} Returns the new function. + * @returns {Function} 返回新的函数 */ function baseUnary (func) { return function (value) { @@ -2268,7 +2268,7 @@ * * @private * @param {Object} source The object of property predicates to conform to. - * @returns {Function} Returns the new function. + * @returns {Function} 返回新的函数 */ function baseConforms (source) { var props = keys(source), @@ -2943,7 +2943,7 @@ * * @private * @param {Object} source The object of property values to match. - * @returns {Function} Returns the new function. + * @returns {Function} 返回新的函数 */ function baseMatches (source) { var matchData = getMatchData(source); @@ -2970,7 +2970,7 @@ * @private * @param {string} path The path of the property to get. * @param {*} srcValue The value to match. - * @returns {Function} Returns the new function. + * @returns {Function} 返回新的函数 */ function baseMatchesProperty (path, srcValue) { return function (object) { @@ -3135,7 +3135,7 @@ * * @private * @param {string} key The key of the property to get. - * @returns {Function} Returns the new function. + * @returns {Function} 返回新的函数 */ function baseProperty (key) { return function (object) { @@ -3148,7 +3148,7 @@ * * @private * @param {Array|string} path The path of the property to get. - * @returns {Function} Returns the new function. + * @returns {Function} 返回新的函数 */ function basePropertyDeep (path) { return function (object) { @@ -4012,7 +4012,7 @@ * * @private * @param {string} methodName The name of the `String` case method to use. - * @returns {Function} Returns the new function. + * @returns {Function} 返回新的函数 */ function createCaseFirst (methodName) { return function (string) { @@ -8121,7 +8121,6 @@ /** * 创建一个函数 `func`,这个函数的 `this` 会被绑定在 `thisArg`。 * 并且任何附加在 `_.bind` 的参数会被传入到这个绑定函数上。 - * * 这个 `_.bind.placeholder` 的值,默认是以 `_` 作为附加部分参数的占位符。 * * **注意:** 不同于原生的 Function#bind,这个方法不会设置绑定函数的 length 属性。 @@ -8680,9 +8679,7 @@ * 创建一个函数。 * 该函数调用 func,并传入预设的参数。 * 这个方法类似 `_.bind`,除了它不会绑定 `this`。 - * - * - * 这个 _.partial.placeholder 的值,默认是以 _ 作为附加部分参数的占位符。 + * 这个 `_.partial.placeholder` 的值,默认是以 `_` 作为附加部分参数的占位符。 * * **注意:** 这个方法不会设置 "length" 到函数上。 * @@ -8714,8 +8711,6 @@ /** * 这个函数类似 `_.partial`,除了它是从右到左预设参数的。 - * - * * 这个 _.partialRight.placeholder 的值,默认是以 _ 作为附加部分参数的占位符。 * * **注意:** 这个方法不会设置 "length" 到函数上。 @@ -12625,17 +12620,17 @@ /*------------------------------------------------------------------------*/ /** - * Attempts to invoke `func`, returning either the result or the caught error - * object. Any additional arguments are provided to `func` when it's invoked. + * 尝试调用函数,返回结果 或者 错误对象。 + * 任何附加的参数都会在调用时传给函数。 * * @static * @memberOf _ * @category Utility - * @param {Function} func The function to attempt. - * @returns {*} Returns the `func` result or error object. + * @param {Function} func 要调用的函数 + * @returns {*} 返回函数结果或者错误对象 * @example * - * // avoid throwing errors for invalid selectors + * // 避免因为错误的选择器而抛出 * var elements = _.attempt(function(selector) { * return document.querySelectorAll(selector); * }, '>_>'); @@ -12653,17 +12648,16 @@ }); /** - * Binds methods of an object to the object itself, overwriting the existing - * method. + * 绑定对象的方法到对象本身,覆盖已存在的方法。 * - * **注意:** This method doesn't set the "length" property of bound functions. + * **注意:** 这个方法不会设置 "length" 属性到约束的函数。 * * @static * @memberOf _ * @category Utility - * @param {Object} object The object to bind and assign the bound methods to. - * @param {...(string|string[])} methodNames The object method names to bind, - * specified individually or in arrays. + * @param {Object} object 要绑定的对象 + * @param {...(string|string[])} methodNames 要绑定的方法名 + * 单独指定或指定在数组中。 * @returns {Object} 返回对象 * @example * @@ -12686,16 +12680,14 @@ }); /** - * Creates a function that iterates over `pairs` invoking the corresponding - * function of the first predicate to return truthy. The predicate-function - * pairs are invoked with the `this` binding and arguments of the created - * function. + * 创建一个函数。 + * 这个函数会遍历 `pairs`,并执行最先返回真值对应的函数,并绑定 `this` 及传入创建函数的参数。 * * @static * @memberOf _ * @category Utility - * @param {Array} pairs The predicate-function pairs. - * @returns {Function} Returns the new function. + * @param {Array} pairs 判断函数对 + * @returns {Function} 返回新的函数 * @example * * var func = _.cond([ @@ -12705,13 +12697,13 @@ * ]) * * func({ 'a': 1, 'b': 2 }); - * // => 'matches A' + * // => 输出:'matches A' * * func({ 'a': 0, 'b': 1 }); - * // => 'matches B' + * // => 输出:'matches B' * * func({ 'a': '1', 'b': '2' }); - * // => 'no match' + * // => 输出:'no match' */ function cond (pairs) { var length = pairs ? pairs.length : 0, @@ -12736,15 +12728,15 @@ } /** - * Creates a function that invokes the predicate properties of `source` with - * the corresponding property values of a given object, returning `true` if - * all predicates return truthy否则返回 `false` + * 创建一个函数。 + * 这个函数会调用 `source` 的属性名对应的 `predicate` 与传入对象相对应属性名的值进行 `predicate` 处理。 + * 如果都符合返回 `true`,否则返回 `false` * * @static * @memberOf _ * @category Utility - * @param {Object} source The object of property predicates to conform to. - * @returns {Function} Returns the new function. + * @param {Object} source 包含 predicates 属性值的对象 + * @returns {Function} 返回新的函数 * @example * * var users = [ @@ -12760,13 +12752,13 @@ } /** - * Creates a function that returns `value`. + * 创建一个返回 `value` 的函数 * * @static * @memberOf _ * @category Utility - * @param {*} value The value to return from the new function. - * @returns {Function} Returns the new function. + * @param {*} value 要返回的值 + * @returns {Function} 返回新的函数 * @example * * var object = { 'user': 'fred' }; @@ -12782,15 +12774,15 @@ } /** - * Creates a function that returns the result of invoking the provided - * functions with the `this` binding of the created function, where each - * successive invocation is supplied the return value of the previous. + * 创建一个函数。 + * 返回的结果是调用提供函数的结果,`this` 会绑定到创建函数。 + * 每一个连续调用,传入的参数都是前一个函数返回的结果。 * * @static * @memberOf _ * @category Utility - * @param {...(Function|Function[])} [funcs] Functions to invoke. - * @returns {Function} Returns the new function. + * @param {...(Function|Function[])} [funcs] 要调用的函数 + * @returns {Function} 返回新的函数 * @example * * function square(n) { @@ -12804,14 +12796,13 @@ var flow = createFlow(); /** - * 这个方法类似 `_.flow` except that it creates a function that - * invokes the provided functions from right to left. + * 这个方法类似 `_.flow`,除了它调用函数的顺序是从右往左的。 * * @static * @memberOf _ * @category Utility - * @param {...(Function|Function[])} [funcs] Functions to invoke. - * @returns {Function} Returns the new function. + * @param {...(Function|Function[])} [funcs] 要调用的函数 + * @returns {Function} 返回新的函数 * @example * * function square(n) { @@ -12825,13 +12816,13 @@ var flowRight = createFlow(true); /** - * This method returns the first argument provided to it. + * 这个方法返回首个提供的参数 * * @static * @memberOf _ * @category Utility - * @param {*} value Any value. - * @returns {*} Returns `value`. + * @param {*} value 任何值 + * @returns {*} 返回 value * @example * * var object = { 'user': 'fred' }; @@ -12844,16 +12835,16 @@ } /** - * 创建一个调用 `func` 的函数。 with the arguments of the created - * function. If `func` is a property name the created callback returns the - * property value for a given element. If `func` is an object the created - * callback returns `true` for elements that contain the equivalent object properties, otherwise it returns `false`. - * + * 创建一个调用 `func` 的函数。 + * 如果 `func` 是一个属性名,传入包含这个属性名的对象,回调返回对应属性名的值。 + * 如果 `func` 是一个对象,传入的元素有相同的对象属性,回调返回 `true`。 + * 其他情况返回 `false`。 + * * @static * @memberOf _ * @category Utility - * @param {*} [func=_.identity] The value to convert to a callback. - * @returns {Function} Returns the callback. + * @param {*} [func=_.identity] 转换成 callback 的值 + * @returns {Function} 返回 callback. * @example * * var users = [ @@ -12861,7 +12852,7 @@ * { 'user': 'fred', 'age': 40 } * ]; * - * // wrap to create custom callback shorthands + * // 使用 wrap 创建一个自定义回调速写 * _.iteratee = _.wrap(_.iteratee, function(callback, func, thisArg) { * var match = /^(.+?)__([gl]t)(.+)$/.exec(func); * if (!match) { @@ -12884,17 +12875,17 @@ } /** - * Creates a function that performs a deep partial comparison between a given - * object and `source`, returning `true` if the given object has equivalent - * property values否则返回 `false` * - * **注意:** This method supports comparing the same values as `_.isEqual`. + * 创建一个深比较的方法来比较给定的对象和 `source` 对象。 + * 如果给定的对象拥有相同的属性值返回 `true`,否则返回 `false` + * + * **注意:** 这个方法支持以 `_.isEqual` 的方式比较相同的值。 * * @static * @memberOf _ * @category Utility - * @param {Object} source The object of property values to match. - * @returns {Function} Returns the new function. + * @param {Object} source 要匹配的源对象 + * @returns {Function} 返回新的函数 * @example * * var users = [ @@ -12910,18 +12901,17 @@ } /** - * Creates a function that performs a deep partial comparison between the - * value at `path` of a given object to `srcValue`, returning `true` if the - * object value is equivalent否则返回 `false` + * 创建一个深比较的方法来比较给定对象的 `path` 的值是否是 `srcValue`。 + * 如果是返回 `true`,否则返回 `false` * - * **注意:** This method supports comparing the same values as `_.isEqual`. + * **注意:** 这个方法支持以 `_.isEqual` 的方式比较相同的值。 * * @static * @memberOf _ * @category Utility - * @param {Array|string} path The path of the property to get. - * @param {*} srcValue The value to match. - * @returns {Function} Returns the new function. + * @param {Array|string} path 给定对象的属性路径名 + * @param {*} srcValue 要匹配的值 + * @returns {Function} 返回新的函数 * @example * * var users = [ @@ -12937,15 +12927,15 @@ } /** - * Creates a function that invokes the method at `path` of a given object. - * Any additional arguments are provided to the invoked method. + * 创建一个调用给定对象 `path` 上的函数。 + * 任何附加的参数都会传入这个调用函数中。 * * @static * @memberOf _ * @category Utility - * @param {Array|string} path The path of the method to invoke. - * @param {...*} [args] The arguments to invoke the method with. - * @returns {Function} Returns the new function. + * @param {Array|string} path 调用函数所在对象的路径 + * @param {...*} [args] 传递给调用函数的参数 + * @returns {Function} 返回新的函数 * @example * * var objects = [ @@ -12966,16 +12956,16 @@ }); /** - * The opposite of `_.method`; this method creates a function that invokes - * the method at a given path of `object`. Any additional arguments are - * provided to the invoked method. + * 反向版 `_.method`。 + * 这个创建一个函数调用给定 `object` 的 `path` 上的方法, + * 任何附加的参数都会传入这个调用函数中。 * * @static * @memberOf _ * @category Utility * @param {Object} object 要检索的对象 - * @param {...*} [args] The arguments to invoke the method with. - * @returns {Function} Returns the new function. + * @param {...*} [args] 传递给调用函数的参数 + * @returns {Function} 返回新的函数 * @example * * var array = _.times(3, _.constant), @@ -12994,21 +12984,18 @@ }); /** - * Adds all own enumerable function properties of a source object to the - * destination object. If `object` is a function then methods are added to - * its prototype as well. + * 添加来源对象自身的所有可枚举函数属性到目标对象。 + * 如果 `object` 是个函数,那么函数方法将被添加到原型链上。 * - * **注意:** Use `_.runInContext` to create a pristine `lodash` function to - * avoid conflicts caused by modifying the original. + * **注意:** 使用 `_.runInContext` 来创建原始的 `lodash` 函数来避免修改造成的冲突。 * * @static * @memberOf _ * @category Utility * @param {Function|Object} [object=lodash] 目标对象 - * @param {Object} source The object of functions to add. - * @param {Object} [options] The options object. - * @param {boolean} [options.chain=true] Specify whether the functions added - * are chainable. + * @param {Object} source 来源对象 + * @param {Object} [options] 选项对象 + * @param {boolean} [options.chain=true] 是否开启链式操作 * @returns {Function|Object} 返回对象 * @example * @@ -13065,13 +13052,12 @@ } /** - * Reverts the `_` variable to its previous value and returns a reference to - * the `lodash` function. + * 释放 `_` 为原来的值,并返回一个 `lodash` 的引用 * * @static * @memberOf _ * @category Utility - * @returns {Function} Returns the `lodash` function. + * @returns {Function} 返回 `lodash` 函数 * @example * * var lodash = _.noConflict(); @@ -13082,8 +13068,7 @@ } /** - * A no-operation function that returns `undefined` regardless of the - * arguments it receives. + * 无论传递什么参数,都返回 `undefined`。 * * @static * @memberOf _ @@ -13100,13 +13085,13 @@ } /** - * Creates a function that returns its nth argument. + * 创建一个返回第 N 个参数的函数。 * * @static * @memberOf _ * @category Utility - * @param {number} [n=0] The index of the argument to return. - * @returns {Function} Returns the new function. + * @param {number} [n=0] 要返回参数的索引 + * @returns {Function} 返回新的函数 * @example * * var func = _.nthArg(1); @@ -13122,14 +13107,13 @@ } /** - * Creates a function that invokes `iteratees` with the arguments provided - * to the created function and returns their results. + * 创建一个传入提供的参数的函数并调用 `iteratees` 返回结果的函数。 * * @static * @memberOf _ * @category Utility - * @param {...(Function|Function[])} iteratees The iteratees to invoke. - * @returns {Function} Returns the new function. + * @param {...(Function|Function[])} iteratees 要调用的 iteratees + * @returns {Function} 返回新的函数 * @example * * var func = _.over(Math.max, Math.min); @@ -13140,14 +13124,13 @@ var over = createOver(arrayMap); /** - * Creates a function that checks if **all** of the `predicates` return - * truthy when invoked with the arguments provided to the created function. + * 创建一个传入提供的参数的函数并调用 `iteratees` 判断是否 全部 都为真值的函数。 * * @static * @memberOf _ * @category Utility - * @param {...(Function|Function[])} predicates The predicates to check. - * @returns {Function} Returns the new function. + * @param {...(Function|Function[])} predicates 要调用的 predicates + * @returns {Function} 返回新的函数 * @example * * var func = _.overEvery(Boolean, isFinite); @@ -13164,14 +13147,13 @@ var overEvery = createOver(arrayEvery); /** - * Creates a function that checks if **any** of the `predicates` return - * truthy when invoked with the arguments provided to the created function. + * 创建一个传入提供的参数的函数并调用 `iteratees` 判断是否 存在 有真值的函数。 * * @static * @memberOf _ * @category Utility - * @param {...(Function|Function[])} predicates The predicates to check. - * @returns {Function} Returns the new function. + * @param {...(Function|Function[])} predicates 要调用的 predicates + * @returns {Function} 返回新的函数 * @example * * var func = _.overSome(Boolean, isFinite); @@ -13188,13 +13170,13 @@ var overSome = createOver(arraySome); /** - * Creates a function that returns the value at `path` of a given object. + * 创建一个返回给定对象的 `path` 的值的函数。 * * @static * @memberOf _ * @category Utility - * @param {Array|string} path The path of the property to get. - * @returns {Function} Returns the new function. + * @param {Array|string} path 要得到值的属性路径 + * @returns {Function} 返回新的函数 * @example * * var objects = [ @@ -13213,14 +13195,14 @@ } /** - * The opposite of `_.property`; this method creates a function that returns - * the value at a given path of `object`. - * + * 反向版 `_.property`。 + * 这个方法创建的函数返回给定 path 在对象上的值。 + * * @static * @memberOf _ * @category Utility * @param {Object} object 要检索的对象 - * @returns {Function} Returns the new function. + * @returns {Function} 返回新的函数 * @example * * var array = [0, 1, 2], @@ -13239,22 +13221,20 @@ } /** - * Creates an array of numbers (positive and/or negative) progressing from - * `start` up to, but not including, `end`. A step of `-1` is used if a negative - * `start` is specified without an `end` or `step`. If `end` is not specified - * it's set to `start` with `start` then set to `0`. If `end` is less than - * `start` a zero-length range is created unless a negative `step` is specified. + * 创建一个包含从 `start` 到 `end`,但不包含 `end` 本身范围数字的数组。 + * 如果 `start` 是负数,而 `end` 或 `step` 没有指定,那么 `step` 从 `-1` 为开始。 + * 如果 `end` 没有指定,`start` 设置为 `0`。 + * 如果 `end` 小于 `start`,会创建一个空数组,除非指定了 `step`。 * - * **注意:** JavaScript follows the IEEE-754 standard for resolving - * floating-point values which can produce unexpected results. + * **注意:** JavaScript 遵循 IEEE-754 标准处理无法预料的浮点数结果。 * * @static * @memberOf _ * @category Utility - * @param {number} [start=0] The start of the range. - * @param {number} end The end of the range. - * @param {number} [step=1] The value to increment or decrement by. - * @returns {Array} Returns the new array of numbers. + * @param {number} [start=0] 开始的范围 + * @param {number} end 结束的范围 + * @param {number} [step=1] 范围的增量 或者 减量 + * @returns {Array} 返回范围内数字组成的新数组 * @example * * _.range(4); @@ -13286,16 +13266,16 @@ } /** - * 这个方法类似 `_.range` except that it populates values in - * descending order. + * 这个方法类似 `_.range`, + * 除了它是降序生成值的。 * * @static * @memberOf _ * @category Utility - * @param {number} [start=0] The start of the range. - * @param {number} end The end of the range. - * @param {number} [step=1] The value to increment or decrement by. - * @returns {Array} Returns the new array of numbers. + * @param {number} [start=0] 开始的范围 + * @param {number} end 结束的范围 + * @param {number} [step=1] 范围的增量 或者 减量 + * @returns {Array} 返回范围内数字组成的新数组 * @example * * _.rangeRight(4); @@ -13327,15 +13307,15 @@ } /** - * Invokes the iteratee function `n` times, returning an array of the results - * of each invocation. The iteratee is invoked with one argument; (index). + * 调用 iteratee N 次,每次调用返回的结果存入到数组中。 + * iteratee 会传入1个参数:(index)。 * * @static * @memberOf _ * @category Utility - * @param {number} n The number of times to invoke `iteratee`. + * @param {number} n 要调用 `iteratee` 的次数 * @param {Function} [iteratee=_.identity] 这个函数会处理每一个元素 - * @returns {Array} Returns the array of results. + * @returns {Array} 返回调用结果的数组 * @example * * _.times(3, String); @@ -13363,13 +13343,13 @@ } /** - * Converts `value` to a property path array. + * 创建 `value` 为属性路径的数组 * * @static * @memberOf _ * @category Utility - * @param {*} value The value to convert. - * @returns {Array} Returns the new property path array. + * @param {*} value 要转换的值 + * @returns {Array} 返回包含属性路径的数组 * @example * * _.toPath('a.b.c'); @@ -13392,13 +13372,14 @@ } /** - * Generates a unique ID. If `prefix` is provided the ID is appended to it. + * 创建唯一ID。 + * 如果提供了 `prefix`,会被添加到ID前缀上。 * * @static * @memberOf _ * @category Utility - * @param {string} [prefix] The value to prefix the ID with. - * @returns {string} Returns the unique ID. + * @param {string} [prefix] 要添加到ID前缀的值 + * @returns {string} 返回唯一ID * @example * * _.uniqueId('contact_'); diff --git a/kebabCase.html b/kebabCase.html index cfb7c0f..39fb06a 100644 --- a/kebabCase.html +++ b/kebabCase.html @@ -392,7 +392,7 @@
-

kebabCase source npm

+

kebabCase source npm

_.kebabCase([string=''])

转换字符串为 kebab case

diff --git a/keys.html b/keys.html index 04319c9..cb5b322 100644 --- a/keys.html +++ b/keys.html @@ -392,7 +392,7 @@
-

keys source npm

+

keys source npm

_.keys(object)

创建 object 自身可枚举属性名为一个数组。 diff --git a/keysIn.html b/keysIn.html index ab74c87..efd23b2 100644 --- a/keysIn.html +++ b/keysIn.html @@ -392,7 +392,7 @@

-

keysIn source npm

+

keysIn source npm

_.keysIn(object)

创建 object 自身 或 继承的可枚举属性名为一个数组。 diff --git a/lowerCase.html b/lowerCase.html index 305aa8f..e7e5cbd 100644 --- a/lowerCase.html +++ b/lowerCase.html @@ -392,7 +392,7 @@

-

lowerCase source npm

+

lowerCase source npm

_.lowerCase([string=''])

以空格分开单词并转换为小写。

diff --git a/lowerFirst.html b/lowerFirst.html index d81da40..17c405f 100644 --- a/lowerFirst.html +++ b/lowerFirst.html @@ -392,7 +392,7 @@
-

lowerFirst source npm

+

lowerFirst source npm

_.lowerFirst([string=''])

转换首字母为小写。

diff --git a/lt.html b/lt.html index 719f6b3..1af38dc 100644 --- a/lt.html +++ b/lt.html @@ -392,7 +392,7 @@
-

lt source npm

+

lt source npm

_.lt(value, other)

检查 value 是否是 小于 other

diff --git a/lte.html b/lte.html index 2760477..8ac465d 100644 --- a/lte.html +++ b/lte.html @@ -392,7 +392,7 @@
-

lte source npm

+

lte source npm

_.lte(value, other)

检查 value 是否是 小于等于 other.

diff --git a/mapKeys.html b/mapKeys.html index ed6e6c1..ccd2a78 100644 --- a/mapKeys.html +++ b/mapKeys.html @@ -392,7 +392,7 @@
-

mapKeys source npm

+

mapKeys source npm

_.mapKeys(object, [iteratee=_.identity])

反向版 _.mapValues。 diff --git a/mapValues.html b/mapValues.html index 985a422..fe29962 100644 --- a/mapValues.html +++ b/mapValues.html @@ -392,7 +392,7 @@

-

mapValues source npm

+

mapValues source npm

_.mapValues(object, [iteratee=_.identity])

创建一个对象,对象的key相同,值是通过 iteratee 产生的。 diff --git a/matches.html b/matches.html index 42d2ac5..abbb4db 100644 --- a/matches.html +++ b/matches.html @@ -392,24 +392,23 @@

-

matches source npm

+

matches source npm

_.matches(source)
-

Creates a function that performs a deep partial comparison between a given -object and source, returning true if the given object has equivalent -property values否则返回 false +

创建一个深比较的方法来比较给定的对象和 source 对象。 +如果给定的对象拥有相同的属性值返回 true,否则返回 false

-注意: This method supports comparing the same values as _.isEqual.

+注意: 这个方法支持以 _.isEqual 的方式比较相同的值。

参数

    -
  1. source (Object)

    The object of property values to match.

    +
  2. source (Object)

    要匹配的源对象

返回值 (Function)

-

Returns the new function.

+

返回新的函数

示例

var users = [
diff --git a/matchesProperty.html b/matchesProperty.html
index 73bf904..db3dd65 100644
--- a/matchesProperty.html
+++ b/matchesProperty.html
@@ -392,26 +392,25 @@
 
 
-

matchesProperty source npm

+

matchesProperty source npm

_.matchesProperty(path, srcValue)
-

Creates a function that performs a deep partial comparison between the -value at path of a given object to srcValue, returning true if the -object value is equivalent否则返回 false +

创建一个深比较的方法来比较给定对象的 path 的值是否是 srcValue。 +如果是返回 true,否则返回 false

-注意: This method supports comparing the same values as _.isEqual.

+注意: 这个方法支持以 _.isEqual 的方式比较相同的值。

参数

    -
  1. path (Array|string)

    The path of the property to get.

    +
  2. path (Array|string)

    给定对象的属性路径名

  3. -
  4. srcValue (*)

    The value to match.

    +
  5. srcValue (*)

    要匹配的值

返回值 (Function)

-

Returns the new function.

+

返回新的函数

示例

var users = [
diff --git a/max.html b/max.html
index 325014b..50f0db3 100644
--- a/max.html
+++ b/max.html
@@ -392,7 +392,7 @@
 
 
-

max source npm

+

max source npm

_.max(array)

计算 array 中最大的值。 diff --git a/maxBy.html b/maxBy.html index f150cff..6522359 100644 --- a/maxBy.html +++ b/maxBy.html @@ -392,7 +392,7 @@

-

maxBy source npm

+

maxBy source npm

_.maxBy(array, [iteratee=_.identity])

这个方法类似 _.max diff --git a/mean.html b/mean.html index af5665d..b7744d1 100644 --- a/mean.html +++ b/mean.html @@ -392,7 +392,7 @@

-

mean source npm

+

mean source npm

_.mean(array)

计算 array 的平均值。

diff --git a/memoize.html b/memoize.html index 15fc7fa..1d757bb 100644 --- a/memoize.html +++ b/memoize.html @@ -392,7 +392,7 @@
-

memoize source npm

+

memoize source npm

_.memoize(func, [resolver])

创建一个会缓存 func 结果的函数。 diff --git a/merge.html b/merge.html index f0a141d..b7f1381 100644 --- a/merge.html +++ b/merge.html @@ -392,7 +392,7 @@

-

merge source npm

+

merge source npm

_.merge(object, [sources])

递归合并来源对象的自身和继承的可枚举属性到目标对象。 diff --git a/mergeWith.html b/mergeWith.html index 2474944..3144376 100644 --- a/mergeWith.html +++ b/mergeWith.html @@ -392,7 +392,7 @@

-

mergeWith source npm

+

mergeWith source npm

_.mergeWith(object, sources, customizer)

这个方法类似 _.merge。 diff --git a/method.html b/method.html index 5b37785..5eff40b 100644 --- a/method.html +++ b/method.html @@ -392,22 +392,22 @@

-

method source npm

+

method source npm

_.method(path, [args])
-

Creates a function that invokes the method at path of a given object. -Any additional arguments are provided to the invoked method.

+

创建一个调用给定对象 path 上的函数。 +任何附加的参数都会传入这个调用函数中。

参数

    -
  1. path (Array|string)

    The path of the method to invoke.

    +
  2. path (Array|string)

    调用函数所在对象的路径

  3. -
  4. [args] (...*)

    The arguments to invoke the method with.

    +
  5. [args] (...*)

    传递给调用函数的参数

返回值 (Function)

-

Returns the new function.

+

返回新的函数

示例

var objects = [
diff --git a/methodOf.html b/methodOf.html
index d1476ce..6896cbc 100644
--- a/methodOf.html
+++ b/methodOf.html
@@ -392,23 +392,23 @@
 
 
-

methodOf source npm

+

methodOf source npm

_.methodOf(object, [args])
-

The opposite of _.method; this method creates a function that invokes -the method at a given path of object. Any additional arguments are -provided to the invoked method.

+

反向版 _.method。 +这个创建一个函数调用给定 objectpath 上的方法, +任何附加的参数都会传入这个调用函数中。

参数

  1. object (Object)

    要检索的对象

  2. -
  3. [args] (...*)

    The arguments to invoke the method with.

    +
  4. [args] (...*)

    传递给调用函数的参数

返回值 (Function)

-

Returns the new function.

+

返回新的函数

示例

var array = _.times(3, _.constant),
diff --git a/min.html b/min.html
index 4c0ca3a..b40958d 100644
--- a/min.html
+++ b/min.html
@@ -392,7 +392,7 @@
 
 
-

min source npm

+

min source npm

_.min(array)

计算 array 中最小的值。 如果 array 是 空的或者假值将会返回 undefined。

diff --git a/minBy.html b/minBy.html index 7a58c72..d6d2986 100644 --- a/minBy.html +++ b/minBy.html @@ -392,7 +392,7 @@
-

minBy source npm

+

minBy source npm

_.minBy(array, [iteratee=_.identity])

这个方法类似 _.min。 diff --git a/mixin.html b/mixin.html index 4015da6..c0d558d 100644 --- a/mixin.html +++ b/mixin.html @@ -392,27 +392,25 @@

-

mixin source npm

+

mixin source npm

_.mixin([object=lodash], source, [options])
-

Adds all own enumerable function properties of a source object to the -destination object. If object is a function then methods are added to -its prototype as well. +

添加来源对象自身的所有可枚举函数属性到目标对象。 +如果 object 是个函数,那么函数方法将被添加到原型链上。

-注意: Use _.runInContext to create a pristine lodash function to -avoid conflicts caused by modifying the original.

+注意: 使用 _.runInContext 来创建原始的 lodash 函数来避免修改造成的冲突。

参数

  1. [object=lodash] (Function|Object)

    目标对象

  2. -
  3. source (Object)

    The object of functions to add.

    +
  4. source (Object)

    来源对象

  5. -
  6. [options] (Object)

    The options object.

    +
  7. [options] (Object)

    选项对象

  8. -
  9. [options.chain=true] (boolean)

    Specify whether the functions added are chainable.

    +
  10. [options.chain=true] (boolean)

    是否开启链式操作

返回值 (Function|Object)

diff --git a/negate.html b/negate.html index 6ae8b5a..cbf4037 100644 --- a/negate.html +++ b/negate.html @@ -392,7 +392,7 @@
-

negate source npm

+

negate source npm

_.negate(predicate)

创建一个对 func 结果 取反的函数。 diff --git a/noConflict.html b/noConflict.html index d3c834e..d279ba7 100644 --- a/noConflict.html +++ b/noConflict.html @@ -392,15 +392,14 @@

-

noConflict source npm

+

noConflict source npm

_.noConflict()
-

Reverts the _ variable to its previous value and returns a reference to -the lodash function.

+

释放 _ 为原来的值,并返回一个 lodash 的引用

返回值 (Function)

-

Returns the lodash function.

+

返回 lodash 函数

示例

var lodash = _.noConflict();
diff --git a/noop.html b/noop.html
index 2ab7ac0..784d59c 100644
--- a/noop.html
+++ b/noop.html
@@ -392,11 +392,10 @@
 
 
-

noop source npm

+

noop source npm

_.noop()
-

A no-operation function that returns undefined regardless of the -arguments it receives.

+

无论传递什么参数,都返回 undefined

示例

diff --git a/nthArg.html b/nthArg.html index bd947bb..76841bc 100644 --- a/nthArg.html +++ b/nthArg.html @@ -392,19 +392,19 @@
-

nthArg source npm

+

nthArg source npm

_.nthArg([n=0])
-

Creates a function that returns its nth argument.

+

创建一个返回第 N 个参数的函数。

参数

    -
  1. [n=0] (number)

    The index of the argument to return.

    +
  2. [n=0] (number)

    要返回参数的索引

返回值 (Function)

-

Returns the new function.

+

返回新的函数

示例

var func = _.nthArg(1);
diff --git a/omit.html b/omit.html
index e604c1b..1535d75 100644
--- a/omit.html
+++ b/omit.html
@@ -392,7 +392,7 @@
 
 
-

omit source npm

+

omit source npm

_.omit(object, [props])

反向版 _.pick。 diff --git a/omitBy.html b/omitBy.html index bb99d30..d66105a 100644 --- a/omitBy.html +++ b/omitBy.html @@ -392,7 +392,7 @@

-

omitBy source npm

+

omitBy source npm

_.omitBy(object, [predicate=_.identity])

反向版 _.pickBy。 diff --git a/once.html b/once.html index 8a26ffe..6502ca1 100644 --- a/once.html +++ b/once.html @@ -392,7 +392,7 @@

-

once source npm

+

once source npm

_.once(func)

创建一个只能调用一次的函数。 diff --git a/over.html b/over.html index 56c6184..e9331e5 100644 --- a/over.html +++ b/over.html @@ -392,20 +392,19 @@

-

over source npm

+

over source npm

_.over(iteratees)
-

Creates a function that invokes iteratees with the arguments provided -to the created function and returns their results.

+

创建一个传入提供的参数的函数并调用 iteratees 返回结果的函数。

参数

    -
  1. iteratees (...(Function|Function[])

    The iteratees to invoke.

    +
  2. iteratees (...(Function|Function[])

    要调用的 iteratees

返回值 (Function)

-

Returns the new function.

+

返回新的函数

示例

var func = _.over(Math.max, Math.min);
diff --git a/overArgs.html b/overArgs.html
index a2e7b57..5995e0d 100644
--- a/overArgs.html
+++ b/overArgs.html
@@ -392,7 +392,7 @@
 
 
-

overArgs source npm

+

overArgs source npm

_.overArgs(func, [transforms])

创建一个函数,调用时func 参数会先一对一的改变。

diff --git a/overEvery.html b/overEvery.html index d7601b1..b67500c 100644 --- a/overEvery.html +++ b/overEvery.html @@ -392,20 +392,19 @@
-

overEvery source npm

+

overEvery source npm

_.overEvery(predicates)
-

Creates a function that checks if all of the predicates return -truthy when invoked with the arguments provided to the created function.

+

创建一个传入提供的参数的函数并调用 iteratees 判断是否 全部 都为真值的函数。

参数

    -
  1. predicates (...(Function|Function[])

    The predicates to check.

    +
  2. predicates (...(Function|Function[])

    要调用的 predicates

返回值 (Function)

-

Returns the new function.

+

返回新的函数

示例

var func = _.overEvery(Boolean, isFinite);
diff --git a/overSome.html b/overSome.html
index 4a7a56b..aefad61 100644
--- a/overSome.html
+++ b/overSome.html
@@ -392,20 +392,19 @@
 
 
-

overSome source npm

+

overSome source npm

_.overSome(predicates)
-

Creates a function that checks if any of the predicates return -truthy when invoked with the arguments provided to the created function.

+

创建一个传入提供的参数的函数并调用 iteratees 判断是否 存在 有真值的函数。

参数

    -
  1. predicates (...(Function|Function[])

    The predicates to check.

    +
  2. predicates (...(Function|Function[])

    要调用的 predicates

返回值 (Function)

-

Returns the new function.

+

返回新的函数

示例

var func = _.overSome(Boolean, isFinite);
diff --git a/pad.html b/pad.html
index d5edf33..d7d93b0 100644
--- a/pad.html
+++ b/pad.html
@@ -392,7 +392,7 @@
 
 
-

pad source npm

+

pad source npm

_.pad([string=''], [length=0], [chars=' '])

如果字符串长度小于 length 则从左到右填充字符。 diff --git a/padEnd.html b/padEnd.html index 71058de..9a9eb62 100644 --- a/padEnd.html +++ b/padEnd.html @@ -392,7 +392,7 @@

-

padEnd source npm

+

padEnd source npm

_.padEnd([string=''], [length=0], [chars=' '])

如果字符串长度小于 length 则在右侧填充字符。 如果超出长度则截断超出的部分。

diff --git a/padStart.html b/padStart.html index 103e340..f288803 100644 --- a/padStart.html +++ b/padStart.html @@ -392,7 +392,7 @@
-

padStart source npm

+

padStart source npm

_.padStart([string=''], [length=0], [chars=' '])

如果字符串长度小于 length 则在左侧填充字符。 如果超出长度则截断超出的部分。

diff --git a/pages.json b/pages.json index 2a00414..ca51d14 100644 --- a/pages.json +++ b/pages.json @@ -205,253 +205,253 @@ ,{ "href":"/before", "html":"

before source npm

\n
_.before(n, func)
\n\n

创建一个调用 func 的函数。\n调用次数不超过 N 次。\n之后再调用这个函数,将返回最后一个调用的结果。

\n
\n\n

参数

\n
    \n
  1. n (number)

    超过多少次不再调用 func

    \n
  2. \n
  3. func (Function)

    指定的触发的函数

    \n
  4. \n
\n

返回值 (Function)

\n

返回限定的函数

\n
\n

示例

\n
jQuery(element).on('click', _.before(5, addContactToList));\n// => 最多允许添加4个联系人到列表里\n
\n
\n
\n\n
" } ,{ "href":"/bind", - "html":"

bind source npm

\n
_.bind(func, thisArg, [partials])
\n\n

创建一个函数 func,这个函数的 this 会被绑定在 thisArg。\n并且任何附加在 _.bind 的参数会被传入到这个绑定函数上。\n
\n
\n这个 _.bind.placeholder 的值,默认是以 _ 作为附加部分参数的占位符。\n
\n
\n注意: 不同于原生的 Function#bind,这个方法不会设置绑定函数的 length 属性。

\n
\n\n

参数

\n
    \n
  1. func (Function)

    要绑定的函数

    \n
  2. \n
  3. thisArg (*)

    这个 this 会被绑定给 func

    \n
  4. \n
  5. [partials] (...*)

    附加的部分参数

    \n
  6. \n
\n

返回值 (Function)

\n

返回新的绑定函数

\n
\n

示例

\n
var greet = function(greeting, punctuation) {\n  return greeting + ' ' + this.user + punctuation;\n};\n\nvar object = { 'user': 'fred' };\n\nvar bound = _.bind(greet, object, 'hi');\nbound('!');\n// => 'hi fred!'\n\n// 使用了占位符\nvar bound = _.bind(greet, object, _, '!');\nbound('hi');\n// => 'hi fred!'\n
\n
\n
\n\n
" } + "html":"

bind source npm

\n
_.bind(func, thisArg, [partials])
\n\n

创建一个函数 func,这个函数的 this 会被绑定在 thisArg。\n并且任何附加在 _.bind 的参数会被传入到这个绑定函数上。\n这个 _.bind.placeholder 的值,默认是以 _ 作为附加部分参数的占位符。\n
\n
\n注意: 不同于原生的 Function#bind,这个方法不会设置绑定函数的 length 属性。

\n
\n\n

参数

\n
    \n
  1. func (Function)

    要绑定的函数

    \n
  2. \n
  3. thisArg (*)

    这个 this 会被绑定给 func

    \n
  4. \n
  5. [partials] (...*)

    附加的部分参数

    \n
  6. \n
\n

返回值 (Function)

\n

返回新的绑定函数

\n
\n

示例

\n
var greet = function(greeting, punctuation) {\n  return greeting + ' ' + this.user + punctuation;\n};\n\nvar object = { 'user': 'fred' };\n\nvar bound = _.bind(greet, object, 'hi');\nbound('!');\n// => 'hi fred!'\n\n// 使用了占位符\nvar bound = _.bind(greet, object, _, '!');\nbound('hi');\n// => 'hi fred!'\n
\n
\n
\n\n
" } ,{ "href":"/bindKey", - "html":"

bindKey source npm

\n
_.bindKey(object, key, [partials])
\n\n

创建一个函数。\n该方法绑定 object[key] 的方法。\n任何附加在 _.bindKey 的参数会预设到该绑定函数上。\n
\n
\n这个方法与 _.bind 的不同之处在于允许重写绑定函数即使它还不存在。\n浏览 Peter Michaux's article\n了解更多详情。\n
\n
\n这个 _.bindKey.placeholder 的值,默认是以 _ 作为附加部分参数的占位符。

\n
\n\n

参数

\n
    \n
  1. object (Object)

    需要绑定函数的对象

    \n
  2. \n
  3. key (string)

    需要绑定函数对象的键

    \n
  4. \n
  5. [partials] (...*)

    附加的部分参数

    \n
  6. \n
\n

返回值 (Function)

\n

返回新的绑定函数

\n
\n

示例

\n
var object = {\n  'user': 'fred',\n  'greet': function(greeting, punctuation) {\n    return greeting + ' ' + this.user + punctuation;\n  }\n};\n\nvar bound = _.bindKey(object, 'greet', 'hi');\nbound('!');\n// => 'hi fred!'\n\nobject.greet = function(greeting, punctuation) {\n  return greeting + 'ya ' + this.user + punctuation;\n};\n\nbound('!');\n// => 'hiya fred!'\n\n// 使用了占位符\nvar bound = _.bindKey(object, 'greet', _, '!');\nbound('hi');\n// => 'hiya fred!'\n
\n
\n
\n\n
" } + "html":"

bindKey source npm

\n
_.bindKey(object, key, [partials])
\n\n

创建一个函数。\n该方法绑定 object[key] 的方法。\n任何附加在 _.bindKey 的参数会预设到该绑定函数上。\n
\n
\n这个方法与 _.bind 的不同之处在于允许重写绑定函数即使它还不存在。\n浏览 Peter Michaux's article\n了解更多详情。\n
\n
\n这个 _.bindKey.placeholder 的值,默认是以 _ 作为附加部分参数的占位符。

\n
\n\n

参数

\n
    \n
  1. object (Object)

    需要绑定函数的对象

    \n
  2. \n
  3. key (string)

    需要绑定函数对象的键

    \n
  4. \n
  5. [partials] (...*)

    附加的部分参数

    \n
  6. \n
\n

返回值 (Function)

\n

返回新的绑定函数

\n
\n

示例

\n
var object = {\n  'user': 'fred',\n  'greet': function(greeting, punctuation) {\n    return greeting + ' ' + this.user + punctuation;\n  }\n};\n\nvar bound = _.bindKey(object, 'greet', 'hi');\nbound('!');\n// => 'hi fred!'\n\nobject.greet = function(greeting, punctuation) {\n  return greeting + 'ya ' + this.user + punctuation;\n};\n\nbound('!');\n// => 'hiya fred!'\n\n// 使用了占位符\nvar bound = _.bindKey(object, 'greet', _, '!');\nbound('hi');\n// => 'hiya fred!'\n
\n
\n
\n\n
" } ,{ "href":"/curry", - "html":"

curry source npm

\n
_.curry(func, [arity=func.length])
\n\n

创建一个函数,该函数接收一个或多个 func 的参数。\n当该函数被调用时,如果 func 所需要传递的所有参数都被提供,则直接返回 func 所执行的结果。\n否则继续返回该函数并等待接收剩余的参数。\n可以使用 func.length 强制需要累积的参数个数。\n
\n
\n这个 _.curry.placeholder 的值,默认是以 _ 作为附加部分参数的占位符。\n
\n
\n注意: 这个方法不会设置 "length" 到 curried 函数上。

\n
\n\n

参数

\n
    \n
  1. func (Function)

    需要 curry 的函数

    \n
  2. \n
  3. [arity=func.length] (number)

    需要提供给 func 的参数数量

    \n
  4. \n
\n

返回值 (Function)

\n

返回 curry 后的函数

\n
\n

示例

\n
var abc = function(a, b, c) {\n  return [a, b, c];\n};\n\nvar curried = _.curry(abc);\n\ncurried(1)(2)(3);\n// => [1, 2, 3]\n\ncurried(1, 2)(3);\n// => [1, 2, 3]\n\ncurried(1, 2, 3);\n// => [1, 2, 3]\n\n// 使用了占位符\ncurried(1)(_, 3)(2);\n// => [1, 2, 3]\n
\n
\n
\n\n
" } + "html":"

curry source npm

\n
_.curry(func, [arity=func.length])
\n\n

创建一个函数,该函数接收一个或多个 func 的参数。\n当该函数被调用时,如果 func 所需要传递的所有参数都被提供,则直接返回 func 所执行的结果。\n否则继续返回该函数并等待接收剩余的参数。\n可以使用 func.length 强制需要累积的参数个数。\n
\n
\n这个 _.curry.placeholder 的值,默认是以 _ 作为附加部分参数的占位符。\n
\n
\n注意: 这个方法不会设置 "length" 到 curried 函数上。

\n
\n\n

参数

\n
    \n
  1. func (Function)

    需要 curry 的函数

    \n
  2. \n
  3. [arity=func.length] (number)

    需要提供给 func 的参数数量

    \n
  4. \n
\n

返回值 (Function)

\n

返回 curry 后的函数

\n
\n

示例

\n
var abc = function(a, b, c) {\n  return [a, b, c];\n};\n\nvar curried = _.curry(abc);\n\ncurried(1)(2)(3);\n// => [1, 2, 3]\n\ncurried(1, 2)(3);\n// => [1, 2, 3]\n\ncurried(1, 2, 3);\n// => [1, 2, 3]\n\n// 使用了占位符\ncurried(1)(_, 3)(2);\n// => [1, 2, 3]\n
\n
\n
\n\n
" } ,{ "href":"/curryRight", - "html":"

curryRight source npm

\n
_.curryRight(func, [arity=func.length])
\n\n

这个方法类似 _.curry。\n除了它接受参数的方式用 _.partialRight 代替了 _.partial。\n
\n
\n这个 _.curry.placeholder 的值,默认是以 _ 作为附加部分参数的占位符。\n
\n
\n注意: 这个方法不会设置 "length" 到 curried 函数上。

\n
\n\n

参数

\n
    \n
  1. func (Function)

    需要 curry 的函数

    \n
  2. \n
  3. [arity=func.length] (number)

    需要提供给 func 的参数数量

    \n
  4. \n
\n

返回值 (Function)

\n

返回 curry 后的函数

\n
\n

示例

\n
var abc = function(a, b, c) {\n  return [a, b, c];\n};\n\nvar curried = _.curryRight(abc);\n\ncurried(3)(2)(1);\n// => [1, 2, 3]\n\ncurried(2, 3)(1);\n// => [1, 2, 3]\n\ncurried(1, 2, 3);\n// => [1, 2, 3]\n\n// 使用了占位符\ncurried(3)(1, _)(2);\n// => [1, 2, 3]\n
\n
\n
\n\n
" } + "html":"

curryRight source npm

\n
_.curryRight(func, [arity=func.length])
\n\n

这个方法类似 _.curry。\n除了它接受参数的方式用 _.partialRight 代替了 _.partial。\n
\n
\n这个 _.curry.placeholder 的值,默认是以 _ 作为附加部分参数的占位符。\n
\n
\n注意: 这个方法不会设置 "length" 到 curried 函数上。

\n
\n\n

参数

\n
    \n
  1. func (Function)

    需要 curry 的函数

    \n
  2. \n
  3. [arity=func.length] (number)

    需要提供给 func 的参数数量

    \n
  4. \n
\n

返回值 (Function)

\n

返回 curry 后的函数

\n
\n

示例

\n
var abc = function(a, b, c) {\n  return [a, b, c];\n};\n\nvar curried = _.curryRight(abc);\n\ncurried(3)(2)(1);\n// => [1, 2, 3]\n\ncurried(2, 3)(1);\n// => [1, 2, 3]\n\ncurried(1, 2, 3);\n// => [1, 2, 3]\n\n// 使用了占位符\ncurried(3)(1, _)(2);\n// => [1, 2, 3]\n
\n
\n
\n\n
" } ,{ "href":"/debounce", - "html":"

debounce source npm

\n
_.debounce(func, [wait=0], [options])
\n\n

创建一个防抖动函数。\n该函数会在 wait 毫秒后调用 func 方法。\n该函数提供一个 cancel 方法取消延迟的函数调用以及 flush 方法立即调用。\n可以提供一个 options 对象决定如何调用 func 方法,\noptions.leading 与|或 options.trailing 决定延迟前后如何触发。\nfunc 会传入最后一次传入的参数给防抖动函数。\n随后调用的防抖动函数返回是最后一次 func 调用的结果。\n
\n
\n注意: 如果 leadingtrailing 都设定为 true。\n则 func 允许 trailing 方式调用的条件为: 在 wait 期间多次调用防抖方法。\n
\n
\n查看 David Corbacho's article\n了解 _.debounce_.throttle 的区别。

\n
\n\n

参数

\n
    \n
  1. func (Function)

    要防抖动的函数

    \n
  2. \n
  3. [wait=0] (number)

    需要延迟的毫秒数

    \n
  4. \n
  5. [options] (Object)

    选项对象

    \n
  6. \n
  7. [options.leading=false] (boolean)

    指定调用在延迟开始前

    \n
  8. \n
  9. [options.maxWait] (number)

    设置 func 允许被延迟的最大值

    \n
  10. \n
  11. [options.trailing=true] (boolean)

    指定调用在延迟结束后

    \n
  12. \n
\n

返回值 (Function)

\n

返回具有防抖动功能的函数

\n
\n

示例

\n
// 避免窗口在变动时出现昂贵的计算开销。\njQuery(window).on('resize', _.debounce(calculateLayout, 150));\n\n// 当点击时 `sendMail` 随后就被调用。\njQuery(element).on('click', _.debounce(sendMail, 300, {\n  'leading': true,\n  'trailing': false\n}));\n\n// 确保 `batchLog` 调用1次之后,1秒内会被触发。\nvar debounced = _.debounce(batchLog, 250, { 'maxWait': 1000 });\nvar source = new EventSource('/stream');\njQuery(source).on('message', debounced);\n\n// 取消一个 trailing 的防抖动调用\njQuery(window).on('popstate', debounced.cancel);\n
\n
\n
\n\n
" } + "html":"

debounce source npm

\n
_.debounce(func, [wait=0], [options])
\n\n

创建一个防抖动函数。\n该函数会在 wait 毫秒后调用 func 方法。\n该函数提供一个 cancel 方法取消延迟的函数调用以及 flush 方法立即调用。\n可以提供一个 options 对象决定如何调用 func 方法,\noptions.leading 与|或 options.trailing 决定延迟前后如何触发。\nfunc 会传入最后一次传入的参数给防抖动函数。\n随后调用的防抖动函数返回是最后一次 func 调用的结果。\n
\n
\n注意: 如果 leadingtrailing 都设定为 true。\n则 func 允许 trailing 方式调用的条件为: 在 wait 期间多次调用防抖方法。\n
\n
\n查看 David Corbacho's article\n了解 _.debounce_.throttle 的区别。

\n
\n\n

参数

\n
    \n
  1. func (Function)

    要防抖动的函数

    \n
  2. \n
  3. [wait=0] (number)

    需要延迟的毫秒数

    \n
  4. \n
  5. [options] (Object)

    选项对象

    \n
  6. \n
  7. [options.leading=false] (boolean)

    指定调用在延迟开始前

    \n
  8. \n
  9. [options.maxWait] (number)

    设置 func 允许被延迟的最大值

    \n
  10. \n
  11. [options.trailing=true] (boolean)

    指定调用在延迟结束后

    \n
  12. \n
\n

返回值 (Function)

\n

返回具有防抖动功能的函数

\n
\n

示例

\n
// 避免窗口在变动时出现昂贵的计算开销。\njQuery(window).on('resize', _.debounce(calculateLayout, 150));\n\n// 当点击时 `sendMail` 随后就被调用。\njQuery(element).on('click', _.debounce(sendMail, 300, {\n  'leading': true,\n  'trailing': false\n}));\n\n// 确保 `batchLog` 调用1次之后,1秒内会被触发。\nvar debounced = _.debounce(batchLog, 250, { 'maxWait': 1000 });\nvar source = new EventSource('/stream');\njQuery(source).on('message', debounced);\n\n// 取消一个 trailing 的防抖动调用\njQuery(window).on('popstate', debounced.cancel);\n
\n
\n
\n\n
" } ,{ "href":"/defer", - "html":"

defer source npm

\n
_.defer(func, [args])
\n\n

延迟调用 func 直到当前堆栈清理完毕。\n任何附加的参数会传入到 func

\n
\n\n

参数

\n
    \n
  1. func (Function)

    要延迟的函数

    \n
  2. \n
  3. [args] (...*)

    会在调用时传入到 func 的参数

    \n
  4. \n
\n

返回值 (number)

\n

返回计时器 id

\n
\n

示例

\n
_.defer(function(text) {\n  console.log(text);\n}, 'deferred');\n// 一毫秒或更久一些输出 'deferred'。\n
\n
\n
\n\n
" } + "html":"

defer source npm

\n
_.defer(func, [args])
\n\n

延迟调用 func 直到当前堆栈清理完毕。\n任何附加的参数会传入到 func

\n
\n\n

参数

\n
    \n
  1. func (Function)

    要延迟的函数

    \n
  2. \n
  3. [args] (...*)

    会在调用时传入到 func 的参数

    \n
  4. \n
\n

返回值 (number)

\n

返回计时器 id

\n
\n

示例

\n
_.defer(function(text) {\n  console.log(text);\n}, 'deferred');\n// 一毫秒或更久一些输出 'deferred'。\n
\n
\n
\n\n
" } ,{ "href":"/delay", - "html":"

delay source npm

\n
_.delay(func, wait, [args])
\n\n

延迟 wait 毫秒后调用 func。\n任何附加的参数会传入到 func

\n
\n\n

参数

\n
    \n
  1. func (Function)

    要延迟的函数

    \n
  2. \n
  3. wait (number)

    要延迟的毫秒数

    \n
  4. \n
  5. [args] (...*)

    会在调用时传入到 func 的参数

    \n
  6. \n
\n

返回值 (number)

\n

返回计时器 id

\n
\n

示例

\n
_.delay(function(text) {\n  console.log(text);\n}, 1000, 'later');\n// => 一秒后输出 'later'。\n
\n
\n
\n\n
" } + "html":"

delay source npm

\n
_.delay(func, wait, [args])
\n\n

延迟 wait 毫秒后调用 func。\n任何附加的参数会传入到 func

\n
\n\n

参数

\n
    \n
  1. func (Function)

    要延迟的函数

    \n
  2. \n
  3. wait (number)

    要延迟的毫秒数

    \n
  4. \n
  5. [args] (...*)

    会在调用时传入到 func 的参数

    \n
  6. \n
\n

返回值 (number)

\n

返回计时器 id

\n
\n

示例

\n
_.delay(function(text) {\n  console.log(text);\n}, 1000, 'later');\n// => 一秒后输出 'later'。\n
\n
\n
\n\n
" } ,{ "href":"/flip", - "html":"

flip source npm

\n
_.flip(func)
\n\n

创建一个翻转接收参数的 func 函数。

\n
\n\n

参数

\n
    \n
  1. func (Function)

    要翻转参数的函数

    \n
  2. \n
\n

返回值 (Function)

\n

返回新的函数

\n
\n

示例

\n
var flipped = _.flip(function() {\n  return _.toArray(arguments);\n});\n\nflipped('a', 'b', 'c', 'd');\n// => ['d', 'c', 'b', 'a']\n
\n
\n
\n\n
" } + "html":"

flip source npm

\n
_.flip(func)
\n\n

创建一个翻转接收参数的 func 函数。

\n
\n\n

参数

\n
    \n
  1. func (Function)

    要翻转参数的函数

    \n
  2. \n
\n

返回值 (Function)

\n

返回新的函数

\n
\n

示例

\n
var flipped = _.flip(function() {\n  return _.toArray(arguments);\n});\n\nflipped('a', 'b', 'c', 'd');\n// => ['d', 'c', 'b', 'a']\n
\n
\n
\n\n
" } ,{ "href":"/memoize", - "html":"

memoize source npm

\n
_.memoize(func, [resolver])
\n\n

创建一个会缓存 func 结果的函数。\n如果提供了 resolver,就用 resolver 的返回值作为 key 缓存函数的结果。\n默认情况下用第一个参数作为缓存的 key。\nfunc 在调用时 this 会绑定在缓存函数上。\n
\n
\n注意: \n缓存会暴露在缓存函数的 cache 上。\n它是可以定制的,只要替换了 _.memoize.Cache 构造函数,或实现了 Map 的\ndeletegethas, 以及 set方法。

\n
\n\n

参数

\n
    \n
  1. func (Function)

    需要缓存化的函数

    \n
  2. \n
  3. [resolver] (Function)

    这个函数的返回值作为缓存的 key

    \n
  4. \n
\n

返回值 (Function)

\n

返回缓存化后的函数

\n
\n

示例

\n
var object = { 'a': 1, 'b': 2 };\nvar other = { 'c': 3, 'd': 4 };\n\nvar values = _.memoize(_.values);\nvalues(object);\n// => [1, 2]\n\nvalues(other);\n// => [3, 4]\n\nobject.a = 2;\nvalues(object);\n// => [1, 2]\n\n// 修改结果缓存\nvalues.cache.set(object, ['a', 'b']);\nvalues(object);\n// => ['a', 'b']\n\n// 替换 `_.memoize.Cache`\n_.memoize.Cache = WeakMap;\n
\n
\n
\n\n
" } + "html":"

memoize source npm

\n
_.memoize(func, [resolver])
\n\n

创建一个会缓存 func 结果的函数。\n如果提供了 resolver,就用 resolver 的返回值作为 key 缓存函数的结果。\n默认情况下用第一个参数作为缓存的 key。\nfunc 在调用时 this 会绑定在缓存函数上。\n
\n
\n注意: \n缓存会暴露在缓存函数的 cache 上。\n它是可以定制的,只要替换了 _.memoize.Cache 构造函数,或实现了 Map 的\ndeletegethas, 以及 set方法。

\n
\n\n

参数

\n
    \n
  1. func (Function)

    需要缓存化的函数

    \n
  2. \n
  3. [resolver] (Function)

    这个函数的返回值作为缓存的 key

    \n
  4. \n
\n

返回值 (Function)

\n

返回缓存化后的函数

\n
\n

示例

\n
var object = { 'a': 1, 'b': 2 };\nvar other = { 'c': 3, 'd': 4 };\n\nvar values = _.memoize(_.values);\nvalues(object);\n// => [1, 2]\n\nvalues(other);\n// => [3, 4]\n\nobject.a = 2;\nvalues(object);\n// => [1, 2]\n\n// 修改结果缓存\nvalues.cache.set(object, ['a', 'b']);\nvalues(object);\n// => ['a', 'b']\n\n// 替换 `_.memoize.Cache`\n_.memoize.Cache = WeakMap;\n
\n
\n
\n\n
" } ,{ "href":"/negate", - "html":"

negate source npm

\n
_.negate(predicate)
\n\n

创建一个对 func 结果 取反的函数。\n用 predicate 对 func 检查的时候,this 绑定到创建的函数,并传入对应参数。

\n
\n\n

参数

\n
    \n
  1. predicate (Function)

    需要对结果取反的函数

    \n
  2. \n
\n

返回值 (Function)

\n

返回一个新函数

\n
\n

示例

\n
function isEven(n) {\n  return n % 2 == 0;\n}\n\n_.filter([1, 2, 3, 4, 5, 6], _.negate(isEven));\n// => [1, 3, 5]\n
\n
\n
\n\n
" } + "html":"

negate source npm

\n
_.negate(predicate)
\n\n

创建一个对 func 结果 取反的函数。\n用 predicate 对 func 检查的时候,this 绑定到创建的函数,并传入对应参数。

\n
\n\n

参数

\n
    \n
  1. predicate (Function)

    需要对结果取反的函数

    \n
  2. \n
\n

返回值 (Function)

\n

返回一个新函数

\n
\n

示例

\n
function isEven(n) {\n  return n % 2 == 0;\n}\n\n_.filter([1, 2, 3, 4, 5, 6], _.negate(isEven));\n// => [1, 3, 5]\n
\n
\n
\n\n
" } ,{ "href":"/once", - "html":"

once source npm

\n
_.once(func)
\n\n

创建一个只能调用一次的函数。\n重复调用返回第一次调用的结果。\nfunc 调用时,this 绑定到创建的函数,并传入对应参数。

\n
\n\n

参数

\n
    \n
  1. func (Function)

    指定的触发的函数

    \n
  2. \n
\n

返回值 (Function)

\n

返回受限的函数

\n
\n

示例

\n
var initialize = _.once(createApplication);\ninitialize();\ninitialize();\n// `initialize` 只能调用 `createApplication` 一次。\n
\n
\n
\n\n
" } + "html":"

once source npm

\n
_.once(func)
\n\n

创建一个只能调用一次的函数。\n重复调用返回第一次调用的结果。\nfunc 调用时,this 绑定到创建的函数,并传入对应参数。

\n
\n\n

参数

\n
    \n
  1. func (Function)

    指定的触发的函数

    \n
  2. \n
\n

返回值 (Function)

\n

返回受限的函数

\n
\n

示例

\n
var initialize = _.once(createApplication);\ninitialize();\ninitialize();\n// `initialize` 只能调用 `createApplication` 一次。\n
\n
\n
\n\n
" } ,{ "href":"/overArgs", - "html":"

overArgs source npm

\n
_.overArgs(func, [transforms])
\n\n

创建一个函数,调用时func 参数会先一对一的改变。

\n
\n\n

参数

\n
    \n
  1. func (Function)

    要包裹的函数

    \n
  2. \n
  3. [transforms] (...(Function|Function[])

    这个函数会改变传参,单独指定或者指定在数组中

    \n
  4. \n
\n

返回值 (Function)

\n

返回新函数

\n
\n

示例

\n
function doubled(n) {\n  return n * 2;\n}\n\nfunction square(n) {\n  return n * n;\n}\n\nvar func = _.overArgs(function(x, y) {\n  return [x, y];\n}, square, doubled);\n\nfunc(9, 3);\n// => [81, 6]\n\nfunc(10, 5);\n// => [100, 10]\n
\n
\n
\n\n
" } + "html":"

overArgs source npm

\n
_.overArgs(func, [transforms])
\n\n

创建一个函数,调用时func 参数会先一对一的改变。

\n
\n\n

参数

\n
    \n
  1. func (Function)

    要包裹的函数

    \n
  2. \n
  3. [transforms] (...(Function|Function[])

    这个函数会改变传参,单独指定或者指定在数组中

    \n
  4. \n
\n

返回值 (Function)

\n

返回新函数

\n
\n

示例

\n
function doubled(n) {\n  return n * 2;\n}\n\nfunction square(n) {\n  return n * n;\n}\n\nvar func = _.overArgs(function(x, y) {\n  return [x, y];\n}, square, doubled);\n\nfunc(9, 3);\n// => [81, 6]\n\nfunc(10, 5);\n// => [100, 10]\n
\n
\n
\n\n
" } ,{ "href":"/partial", - "html":"

partial source npm

\n
_.partial(func, [partials])
\n\n

创建一个函数。\n该函数调用 func,并传入预设的参数。\n这个方法类似 _.bind,除了它不会绑定 this。\n
\n
\n
\n
\n这个 .partial.placeholder 的值,默认是以 作为附加部分参数的占位符。\n
\n
\n注意: 这个方法不会设置 "length" 到函数上。

\n
\n\n

参数

\n
    \n
  1. func (Function)

    需要预设的函数

    \n
  2. \n
  3. [partials] (...*)

    预设的参数

    \n
  4. \n
\n

返回值 (Function)

\n

返回预设参数的函数

\n
\n

示例

\n
var greet = function(greeting, name) {\n  return greeting + ' ' + name;\n};\n\nvar sayHelloTo = _.partial(greet, 'hello');\nsayHelloTo('fred');\n// => 'hello fred'\n\n// 使用了占位符\nvar greetFred = _.partial(greet, _, 'fred');\ngreetFred('hi');\n// => 'hi fred'\n
\n
\n
\n\n
" } + "html":"

partial source npm

\n
_.partial(func, [partials])
\n\n

创建一个函数。\n该函数调用 func,并传入预设的参数。\n这个方法类似 _.bind,除了它不会绑定 this。\n这个 _.partial.placeholder 的值,默认是以 _ 作为附加部分参数的占位符。\n
\n
\n注意: 这个方法不会设置 "length" 到函数上。

\n
\n\n

参数

\n
    \n
  1. func (Function)

    需要预设的函数

    \n
  2. \n
  3. [partials] (...*)

    预设的参数

    \n
  4. \n
\n

返回值 (Function)

\n

返回预设参数的函数

\n
\n

示例

\n
var greet = function(greeting, name) {\n  return greeting + ' ' + name;\n};\n\nvar sayHelloTo = _.partial(greet, 'hello');\nsayHelloTo('fred');\n// => 'hello fred'\n\n// 使用了占位符\nvar greetFred = _.partial(greet, _, 'fred');\ngreetFred('hi');\n// => 'hi fred'\n
\n
\n
\n\n
" } ,{ "href":"/partialRight", - "html":"

partialRight source npm

\n
_.partialRight(func, [partials])
\n\n

这个函数类似 _.partial,除了它是从右到左预设参数的。\n
\n
\n
\n
\n这个 .partialRight.placeholder 的值,默认是以 作为附加部分参数的占位符。\n
\n
\n注意: 这个方法不会设置 "length" 到函数上。

\n
\n\n

参数

\n
    \n
  1. func (Function)

    需要预设的函数

    \n
  2. \n
  3. [partials] (...*)

    预设的参数

    \n
  4. \n
\n

返回值 (Function)

\n

返回预设参数的函数

\n
\n

示例

\n
var greet = function(greeting, name) {\n  return greeting + ' ' + name;\n};\n\nvar greetFred = _.partialRight(greet, 'fred');\ngreetFred('hi');\n// => 'hi fred'\n\n// 使用了占位符\nvar sayHelloTo = _.partialRight(greet, 'hello', _);\nsayHelloTo('fred');\n// => 'hello fred'\n
\n
\n
\n\n
" } + "html":"

partialRight source npm

\n
_.partialRight(func, [partials])
\n\n

这个函数类似 _.partial,除了它是从右到左预设参数的。\n这个 .partialRight.placeholder 的值,默认是以 作为附加部分参数的占位符。\n
\n
\n注意: 这个方法不会设置 "length" 到函数上。

\n
\n\n

参数

\n
    \n
  1. func (Function)

    需要预设的函数

    \n
  2. \n
  3. [partials] (...*)

    预设的参数

    \n
  4. \n
\n

返回值 (Function)

\n

返回预设参数的函数

\n
\n

示例

\n
var greet = function(greeting, name) {\n  return greeting + ' ' + name;\n};\n\nvar greetFred = _.partialRight(greet, 'fred');\ngreetFred('hi');\n// => 'hi fred'\n\n// 使用了占位符\nvar sayHelloTo = _.partialRight(greet, 'hello', _);\nsayHelloTo('fred');\n// => 'hello fred'\n
\n
\n
\n\n
" } ,{ "href":"/rearg", - "html":"

rearg source npm

\n
_.rearg(func, indexes)
\n\n

创建一个调用 func 的函数。\n所传递的参数根据 indexes 调整到对应位置。\n第一个 index 对应到第一个传参,第二个 index 对应到第二个传参,以此类推。

\n
\n\n

参数

\n
    \n
  1. func (Function)

    待调用的函数

    \n
  2. \n
  3. indexes (...(number|number[])

    重新排列参数的位置,单独指定或者指定在数组中

    \n
  4. \n
\n

返回值 (Function)

\n

返回新的函数

\n
\n

示例

\n
var rearged = _.rearg(function(a, b, c) {\n  return [a, b, c];\n}, 2, 0, 1);\n\nrearged('b', 'c', 'a')\n// => ['a', 'b', 'c']\n
\n
\n
\n\n
" } + "html":"

rearg source npm

\n
_.rearg(func, indexes)
\n\n

创建一个调用 func 的函数。\n所传递的参数根据 indexes 调整到对应位置。\n第一个 index 对应到第一个传参,第二个 index 对应到第二个传参,以此类推。

\n
\n\n

参数

\n
    \n
  1. func (Function)

    待调用的函数

    \n
  2. \n
  3. indexes (...(number|number[])

    重新排列参数的位置,单独指定或者指定在数组中

    \n
  4. \n
\n

返回值 (Function)

\n

返回新的函数

\n
\n

示例

\n
var rearged = _.rearg(function(a, b, c) {\n  return [a, b, c];\n}, 2, 0, 1);\n\nrearged('b', 'c', 'a')\n// => ['a', 'b', 'c']\n
\n
\n
\n\n
" } ,{ "href":"/rest", - "html":"

rest source npm

\n
_.rest(func, [start=func.length-1])
\n\n

创建一个调用 func 的函数。\nthis 绑定到这个函数 并且 从 start 之后的参数都作为数组传入。\n
\n
\n注意: 这个方法基于rest parameter

\n
\n\n

参数

\n
    \n
  1. func (Function)

    要应用的函数

    \n
  2. \n
  3. [start=func.length-1] (number)

    从第几个参数开始应用

    \n
  4. \n
\n

返回值 (Function)

\n

返回新的函数

\n
\n

示例

\n
var say = _.rest(function(what, names) {\n  return what + ' ' + _.initial(names).join(', ') +\n    (_.size(names) > 1 ? ', & ' : '') + _.last(names);\n});\n\nsay('hello', 'fred', 'barney', 'pebbles');\n// => 'hello fred, barney, & pebbles'\n
\n
\n
\n\n
" } + "html":"

rest source npm

\n
_.rest(func, [start=func.length-1])
\n\n

创建一个调用 func 的函数。\nthis 绑定到这个函数 并且 从 start 之后的参数都作为数组传入。\n
\n
\n注意: 这个方法基于rest parameter

\n
\n\n

参数

\n
    \n
  1. func (Function)

    要应用的函数

    \n
  2. \n
  3. [start=func.length-1] (number)

    从第几个参数开始应用

    \n
  4. \n
\n

返回值 (Function)

\n

返回新的函数

\n
\n

示例

\n
var say = _.rest(function(what, names) {\n  return what + ' ' + _.initial(names).join(', ') +\n    (_.size(names) > 1 ? ', & ' : '') + _.last(names);\n});\n\nsay('hello', 'fred', 'barney', 'pebbles');\n// => 'hello fred, barney, & pebbles'\n
\n
\n
\n\n
" } ,{ "href":"/spread", - "html":"

spread source npm

\n
_.spread(func)
\n\n

创建一个调用 func 的函数。 this 绑定到这个函数上。\n把参数作为数组传入,类似于 Function#apply\n
\n
\n注意: 这个方法基于 spread operator

\n
\n\n

参数

\n
    \n
  1. func (Function)

    要应用的函数

    \n
  2. \n
\n

返回值 (Function)

\n

返回新的函数

\n
\n

示例

\n
var say = _.spread(function(who, what) {\n  return who + ' says ' + what;\n});\n\nsay(['fred', 'hello']);\n// => 'fred says hello'\n\n// 使用在 Promise\nvar numbers = Promise.all([\n  Promise.resolve(40),\n  Promise.resolve(36)\n]);\n\nnumbers.then(_.spread(function(x, y) {\n  return x + y;\n}));\n// => 返回 76\n
\n
\n
\n\n
" } + "html":"

spread source npm

\n
_.spread(func)
\n\n

创建一个调用 func 的函数。 this 绑定到这个函数上。\n把参数作为数组传入,类似于 Function#apply\n
\n
\n注意: 这个方法基于 spread operator

\n
\n\n

参数

\n
    \n
  1. func (Function)

    要应用的函数

    \n
  2. \n
\n

返回值 (Function)

\n

返回新的函数

\n
\n

示例

\n
var say = _.spread(function(who, what) {\n  return who + ' says ' + what;\n});\n\nsay(['fred', 'hello']);\n// => 'fred says hello'\n\n// 使用在 Promise\nvar numbers = Promise.all([\n  Promise.resolve(40),\n  Promise.resolve(36)\n]);\n\nnumbers.then(_.spread(function(x, y) {\n  return x + y;\n}));\n// => 返回 76\n
\n
\n
\n\n
" } ,{ "href":"/throttle", - "html":"

throttle source npm

\n
_.throttle(func, [wait=0], [options])
\n\n

创建一个节流函数,在 wait 秒内最多执行 func 一次的函数。\n该函数提供一个 cancel 方法取消延迟的函数调用以及 flush 方法立即调用。\n可以提供一个 options 对象决定如何调用 func 方法, options.leading 与|或 options.trailing 决定 wait 前后如何触发。 func 会传入最后一次传入的参数给这个函数。 随后调用的函数返回是最后一次 func 调用的结果。 \n
\n
\n注意: 如果 leading 和 trailing 都设定为 true。 则 func 允许 trailing 方式调用的条件为: 在 wait 期间多次调用。 \n
\n
\n查看 David Corbacho's article\n了解 _.throttle_.debounce 的区别

\n
\n\n

参数

\n
    \n
  1. func (Function)

    要节流的函数

    \n
  2. \n
  3. [wait=0] (number)

    需要节流的毫秒

    \n
  4. \n
  5. [options] (Object)

    选项对象

    \n
  6. \n
  7. [options.leading=true] (boolean)

    指定调用在节流开始前

    \n
  8. \n
  9. [options.trailing=true] (boolean)

    指定调用在节流结束后

    \n
  10. \n
\n

返回值 (Function)

\n

返回节流的函数

\n
\n

示例

\n
// 避免在滚动时过分的更新定位\njQuery(window).on('scroll', _.throttle(updatePosition, 100));\n\n// 点击后就调用 `renewToken`,但5分钟内超过1次。\nvar throttled = _.throttle(renewToken, 300000, { 'trailing': false });\njQuery(element).on('click', throttled);\n\n// 取消一个 trailing 的节流调用\njQuery(window).on('popstate', throttled.cancel);\n
\n
\n
\n\n
" } + "html":"

throttle source npm

\n
_.throttle(func, [wait=0], [options])
\n\n

创建一个节流函数,在 wait 秒内最多执行 func 一次的函数。\n该函数提供一个 cancel 方法取消延迟的函数调用以及 flush 方法立即调用。\n可以提供一个 options 对象决定如何调用 func 方法, options.leading 与|或 options.trailing 决定 wait 前后如何触发。 func 会传入最后一次传入的参数给这个函数。 随后调用的函数返回是最后一次 func 调用的结果。 \n
\n
\n注意: 如果 leading 和 trailing 都设定为 true。 则 func 允许 trailing 方式调用的条件为: 在 wait 期间多次调用。 \n
\n
\n查看 David Corbacho's article\n了解 _.throttle_.debounce 的区别

\n
\n\n

参数

\n
    \n
  1. func (Function)

    要节流的函数

    \n
  2. \n
  3. [wait=0] (number)

    需要节流的毫秒

    \n
  4. \n
  5. [options] (Object)

    选项对象

    \n
  6. \n
  7. [options.leading=true] (boolean)

    指定调用在节流开始前

    \n
  8. \n
  9. [options.trailing=true] (boolean)

    指定调用在节流结束后

    \n
  10. \n
\n

返回值 (Function)

\n

返回节流的函数

\n
\n

示例

\n
// 避免在滚动时过分的更新定位\njQuery(window).on('scroll', _.throttle(updatePosition, 100));\n\n// 点击后就调用 `renewToken`,但5分钟内超过1次。\nvar throttled = _.throttle(renewToken, 300000, { 'trailing': false });\njQuery(element).on('click', throttled);\n\n// 取消一个 trailing 的节流调用\njQuery(window).on('popstate', throttled.cancel);\n
\n
\n
\n\n
" } ,{ "href":"/unary", - "html":"

unary source npm

\n
_.unary(func)
\n\n

创建一个最多接受一个参数的函数,忽略多余的参数。

\n
\n\n

参数

\n
    \n
  1. func (Function)

    要处理的函数

    \n
  2. \n
\n

返回值 (Function)

\n

返回新函数

\n
\n

示例

\n
_.map(['6', '8', '10'], _.unary(parseInt));\n// => [6, 8, 10]\n
\n
\n
\n\n
" } + "html":"

unary source npm

\n
_.unary(func)
\n\n

创建一个最多接受一个参数的函数,忽略多余的参数。

\n
\n\n

参数

\n
    \n
  1. func (Function)

    要处理的函数

    \n
  2. \n
\n

返回值 (Function)

\n

返回新函数

\n
\n

示例

\n
_.map(['6', '8', '10'], _.unary(parseInt));\n// => [6, 8, 10]\n
\n
\n
\n\n
" } ,{ "href":"/wrap", - "html":"

wrap source npm

\n
_.wrap(value, wrapper)
\n\n

创建一个函数。提供的 value 包装在 wrapper 函数的第一个参数里。\n任何附加的参数都提供给 wrapper 函数。\n被调用时 this 绑定在创建的函数上。

\n
\n\n

参数

\n
    \n
  1. value (*)

    要包装的值

    \n
  2. \n
  3. wrapper (Function)

    包装函数

    \n
  4. \n
\n

返回值 (Function)

\n

返回新的函数

\n
\n

示例

\n
var p = _.wrap(_.escape, function(func, text) {\n  return '<p>' + func(text) + '</p>';\n});\n\np('fred, barney, & pebbles');\n// => '<p>fred, barney, &amp; pebbles</p>'\n
\n
\n
\n\n
" } + "html":"

wrap source npm

\n
_.wrap(value, wrapper)
\n\n

创建一个函数。提供的 value 包装在 wrapper 函数的第一个参数里。\n任何附加的参数都提供给 wrapper 函数。\n被调用时 this 绑定在创建的函数上。

\n
\n\n

参数

\n
    \n
  1. value (*)

    要包装的值

    \n
  2. \n
  3. wrapper (Function)

    包装函数

    \n
  4. \n
\n

返回值 (Function)

\n

返回新的函数

\n
\n

示例

\n
var p = _.wrap(_.escape, function(func, text) {\n  return '<p>' + func(text) + '</p>';\n});\n\np('fred, barney, & pebbles');\n// => '<p>fred, barney, &amp; pebbles</p>'\n
\n
\n
\n\n
" } ,{ "href":"/clone", - "html":"

clone source npm

\n
_.clone(value)
\n\n

创建一个 value 的浅拷贝。\n
\n
\n注意: 这个方法参考自\nstructured clone algorithm\n以及支持 arrays、array buffers、 booleans、 date objects、maps、\nnumbers, Object objects, regexes, sets, strings, symbols, 以及 typed\narrays。\n参数对象的可枚举属性会拷贝为普通对象。\n一些不可拷贝的对象,例如error objects、functions, DOM nodes, 以及 WeakMaps 会返回空对象。

\n
\n\n

参数

\n
    \n
  1. value (*)

    要拷贝的值

    \n
  2. \n
\n

返回值 (*)

\n

返回拷贝后的值

\n
\n

示例

\n
var users = [\n  { 'user': 'barney' },\n  { 'user': 'fred' }\n];\n\nvar shallow = _.clone(users);\nconsole.log(shallow[0] === users[0]);\n// => true\n
\n
\n
\n\n
" } + "html":"

clone source npm

\n
_.clone(value)
\n\n

创建一个 value 的浅拷贝。\n
\n
\n注意: 这个方法参考自\nstructured clone algorithm\n以及支持 arrays、array buffers、 booleans、 date objects、maps、\nnumbers, Object objects, regexes, sets, strings, symbols, 以及 typed\narrays。\n参数对象的可枚举属性会拷贝为普通对象。\n一些不可拷贝的对象,例如error objects、functions, DOM nodes, 以及 WeakMaps 会返回空对象。

\n
\n\n

参数

\n
    \n
  1. value (*)

    要拷贝的值

    \n
  2. \n
\n

返回值 (*)

\n

返回拷贝后的值

\n
\n

示例

\n
var users = [\n  { 'user': 'barney' },\n  { 'user': 'fred' }\n];\n\nvar shallow = _.clone(users);\nconsole.log(shallow[0] === users[0]);\n// => true\n
\n
\n
\n\n
" } ,{ "href":"/cloneDeep", - "html":"

cloneDeep source npm

\n
_.cloneDeep(value)
\n\n

这个方法类似 _.clone,除了它会递归拷贝 value

\n
\n\n

参数

\n
    \n
  1. value (*)

    要深拷贝的值

    \n
  2. \n
\n

返回值 (*)

\n

返回拷贝后的值

\n
\n

示例

\n
var users = [\n  { 'user': 'barney' },\n  { 'user': 'fred' }\n];\n\nvar deep = _.cloneDeep(users);\nconsole.log(deep[0] === users[0]);\n// => false\n
\n
\n
\n\n
" } + "html":"

cloneDeep source npm

\n
_.cloneDeep(value)
\n\n

这个方法类似 _.clone,除了它会递归拷贝 value

\n
\n\n

参数

\n
    \n
  1. value (*)

    要深拷贝的值

    \n
  2. \n
\n

返回值 (*)

\n

返回拷贝后的值

\n
\n

示例

\n
var users = [\n  { 'user': 'barney' },\n  { 'user': 'fred' }\n];\n\nvar deep = _.cloneDeep(users);\nconsole.log(deep[0] === users[0]);\n// => false\n
\n
\n
\n\n
" } ,{ "href":"/cloneDeepWith", - "html":"

cloneDeepWith source npm

\n
_.cloneDeepWith(value, [customizer])
\n\n

这个方法类似 _.cloneWith,除了它会递归拷贝 value

\n
\n\n

参数

\n
    \n
  1. value (*)

    要深拷贝的值

    \n
  2. \n
  3. [customizer] (Function)

    这个函数定制返回的拷贝值

    \n
  4. \n
\n

返回值 (*)

\n

返回拷贝后的值

\n
\n

示例

\n
function customizer(value) {\n  if (_.isElement(value)) {\n    return value.cloneNode(true);\n  }\n}\n\nvar el = _.cloneDeep(document.body, customizer);\n\nconsole.log(el === document.body);\n// => false\nconsole.log(el.nodeName);\n// => BODY\nconsole.log(el.childNodes.length);\n// => 20\n
\n
\n
\n\n
" } + "html":"

cloneDeepWith source npm

\n
_.cloneDeepWith(value, [customizer])
\n\n

这个方法类似 _.cloneWith,除了它会递归拷贝 value

\n
\n\n

参数

\n
    \n
  1. value (*)

    要深拷贝的值

    \n
  2. \n
  3. [customizer] (Function)

    这个函数定制返回的拷贝值

    \n
  4. \n
\n

返回值 (*)

\n

返回拷贝后的值

\n
\n

示例

\n
function customizer(value) {\n  if (_.isElement(value)) {\n    return value.cloneNode(true);\n  }\n}\n\nvar el = _.cloneDeep(document.body, customizer);\n\nconsole.log(el === document.body);\n// => false\nconsole.log(el.nodeName);\n// => BODY\nconsole.log(el.childNodes.length);\n// => 20\n
\n
\n
\n\n
" } ,{ "href":"/cloneWith", - "html":"

cloneWith source npm

\n
_.cloneWith(value, [customizer])
\n\n

这个方法类似 _.clone,除了它接受一个 customizer 定制返回的拷贝值。\n如果 customizer 返回 undefined 将会拷贝处理方法代替。\ncustomizer 会传入5个参数:(value [, index|key, object, stack])

\n
\n\n

参数

\n
    \n
  1. value (*)

    要拷贝的值

    \n
  2. \n
  3. [customizer] (Function)

    这个函数定制返回的拷贝值

    \n
  4. \n
\n

返回值 (*)

\n

返回拷贝后的值

\n
\n

示例

\n
function customizer(value) {\n  if (_.isElement(value)) {\n    return value.cloneNode(false);\n  }\n}\n\nvar el = _.clone(document.body, customizer);\n\nconsole.log(el === document.body);\n// => false\nconsole.log(el.nodeName);\n// => BODY\nconsole.log(el.childNodes.length);\n// => 0\n
\n
\n
\n\n
" } + "html":"

cloneWith source npm

\n
_.cloneWith(value, [customizer])
\n\n

这个方法类似 _.clone,除了它接受一个 customizer 定制返回的拷贝值。\n如果 customizer 返回 undefined 将会拷贝处理方法代替。\ncustomizer 会传入5个参数:(value [, index|key, object, stack])

\n
\n\n

参数

\n
    \n
  1. value (*)

    要拷贝的值

    \n
  2. \n
  3. [customizer] (Function)

    这个函数定制返回的拷贝值

    \n
  4. \n
\n

返回值 (*)

\n

返回拷贝后的值

\n
\n

示例

\n
function customizer(value) {\n  if (_.isElement(value)) {\n    return value.cloneNode(false);\n  }\n}\n\nvar el = _.clone(document.body, customizer);\n\nconsole.log(el === document.body);\n// => false\nconsole.log(el.nodeName);\n// => BODY\nconsole.log(el.childNodes.length);\n// => 0\n
\n
\n
\n\n
" } ,{ "href":"/eq", - "html":"

eq source npm

\n
_.eq(value, other)
\n\n

执行 SameValueZero 比较两者的值确定它们是否相等。

\n
\n\n

参数

\n
    \n
  1. value (*)

    要比较的值

    \n
  2. \n
  3. other (*)

    其他要比较的值

    \n
  4. \n
\n

返回值 (boolean)

\n

相等返回 true,否则返回 false

\n
\n

示例

\n
var object = { 'user': 'fred' };\nvar other = { 'user': 'fred' };\n\n_.eq(object, object);\n// => true\n\n_.eq(object, other);\n// => false\n\n_.eq('a', 'a');\n// => true\n\n_.eq('a', Object('a'));\n// => false\n\n_.eq(NaN, NaN);\n// => true\n
\n
\n
\n\n
" } + "html":"

eq source npm

\n
_.eq(value, other)
\n\n

执行 SameValueZero 比较两者的值确定它们是否相等。

\n
\n\n

参数

\n
    \n
  1. value (*)

    要比较的值

    \n
  2. \n
  3. other (*)

    其他要比较的值

    \n
  4. \n
\n

返回值 (boolean)

\n

相等返回 true,否则返回 false

\n
\n

示例

\n
var object = { 'user': 'fred' };\nvar other = { 'user': 'fred' };\n\n_.eq(object, object);\n// => true\n\n_.eq(object, other);\n// => false\n\n_.eq('a', 'a');\n// => true\n\n_.eq('a', Object('a'));\n// => false\n\n_.eq(NaN, NaN);\n// => true\n
\n
\n
\n\n
" } ,{ "href":"/gt", - "html":"

gt source npm

\n
_.gt(value, other)
\n\n

检查 value 是否大于 other

\n
\n\n

参数

\n
    \n
  1. value (*)

    要比较的值

    \n
  2. \n
  3. other (*)

    其他要比较的值

    \n
  4. \n
\n

返回值 (boolean)

\n

如果 value 大于 other,返回 true,否则返回 false

\n
\n

示例

\n
_.gt(3, 1);\n// => true\n\n_.gt(3, 3);\n// => false\n\n_.gt(1, 3);\n// => false\n
\n
\n
\n\n
" } + "html":"

gt source npm

\n
_.gt(value, other)
\n\n

检查 value 是否大于 other

\n
\n\n

参数

\n
    \n
  1. value (*)

    要比较的值

    \n
  2. \n
  3. other (*)

    其他要比较的值

    \n
  4. \n
\n

返回值 (boolean)

\n

如果 value 大于 other,返回 true,否则返回 false

\n
\n

示例

\n
_.gt(3, 1);\n// => true\n\n_.gt(3, 3);\n// => false\n\n_.gt(1, 3);\n// => false\n
\n
\n
\n\n
" } ,{ "href":"/gte", - "html":"

gte source npm

\n
_.gte(value, other)
\n\n

检查 value 是否大于等于 other

\n
\n\n

参数

\n
    \n
  1. value (*)

    要比较的值

    \n
  2. \n
  3. other (*)

    其他要比较的值

    \n
  4. \n
\n

返回值 (boolean)

\n

如果 value 大于等于 other,返回 true,否则返回 false

\n
\n

示例

\n
_.gte(3, 1);\n// => true\n\n_.gte(3, 3);\n// => true\n\n_.gte(1, 3);\n// => false\n
\n
\n
\n\n
" } + "html":"

gte source npm

\n
_.gte(value, other)
\n\n

检查 value 是否大于等于 other

\n
\n\n

参数

\n
    \n
  1. value (*)

    要比较的值

    \n
  2. \n
  3. other (*)

    其他要比较的值

    \n
  4. \n
\n

返回值 (boolean)

\n

如果 value 大于等于 other,返回 true,否则返回 false

\n
\n

示例

\n
_.gte(3, 1);\n// => true\n\n_.gte(3, 3);\n// => true\n\n_.gte(1, 3);\n// => false\n
\n
\n
\n\n
" } ,{ "href":"/isArguments", - "html":"

isArguments source npm

\n
_.isArguments(value)
\n\n

检查 value 是否是 类 arguments 对象。

\n
\n\n

参数

\n
    \n
  1. value (*)

    要检查的值

    \n
  2. \n
\n

返回值 (boolean)

\n

如果是正确的类型,返回 true,否则返回 false

\n
\n

示例

\n
_.isArguments(function() { return arguments; }());\n// => true\n\n_.isArguments([1, 2, 3]);\n// => false\n
\n
\n
\n\n
" } + "html":"

isArguments source npm

\n
_.isArguments(value)
\n\n

检查 value 是否是 类 arguments 对象。

\n
\n\n

参数

\n
    \n
  1. value (*)

    要检查的值

    \n
  2. \n
\n

返回值 (boolean)

\n

如果是正确的类型,返回 true,否则返回 false

\n
\n

示例

\n
_.isArguments(function() { return arguments; }());\n// => true\n\n_.isArguments([1, 2, 3]);\n// => false\n
\n
\n
\n\n
" } ,{ "href":"/isArray", - "html":"

isArray source npm

\n
_.isArray(value)
\n\n

检查 value 是否是 Array 类对象。

\n
\n\n

参数

\n
    \n
  1. value (*)

    要检查的值

    \n
  2. \n
\n

返回值 (boolean)

\n

如果是正确的类型,返回 true,否则返回 false

\n
\n

示例

\n
_.isArray([1, 2, 3]);\n// => true\n\n_.isArray(document.body.children);\n// => false\n\n_.isArray('abc');\n// => false\n\n_.isArray(_.noop);\n// => false\n
\n
\n
\n\n
" } + "html":"

isArray source npm

\n
_.isArray(value)
\n\n

检查 value 是否是 Array 类对象。

\n
\n\n

参数

\n
    \n
  1. value (*)

    要检查的值

    \n
  2. \n
\n

返回值 (boolean)

\n

如果是正确的类型,返回 true,否则返回 false

\n
\n

示例

\n
_.isArray([1, 2, 3]);\n// => true\n\n_.isArray(document.body.children);\n// => false\n\n_.isArray('abc');\n// => false\n\n_.isArray(_.noop);\n// => false\n
\n
\n
\n\n
" } ,{ "href":"/isArrayLike", - "html":"

isArrayLike source npm

\n
_.isArrayLike(value)
\n\n

检查 value 是否是类数组。\n如果是类数组的话,应该不是一个函数,而且 value.length 是个整数,大于等于 0,小于或等于 Number.MAX_SAFE_INTEGER

\n
\n\n

参数

\n
    \n
  1. value (*)

    要检查的值

    \n
  2. \n
\n

返回值 (boolean)

\n

如果是类数组,返回 true,否则返回 false

\n
\n

示例

\n
_.isArrayLike([1, 2, 3]);\n// => true\n\n_.isArrayLike(document.body.children);\n// => true\n\n_.isArrayLike('abc');\n// => true\n\n_.isArrayLike(_.noop);\n// => false\n
\n
\n
\n\n
" } + "html":"

isArrayLike source npm

\n
_.isArrayLike(value)
\n\n

检查 value 是否是类数组。\n如果是类数组的话,应该不是一个函数,而且 value.length 是个整数,大于等于 0,小于或等于 Number.MAX_SAFE_INTEGER

\n
\n\n

参数

\n
    \n
  1. value (*)

    要检查的值

    \n
  2. \n
\n

返回值 (boolean)

\n

如果是类数组,返回 true,否则返回 false

\n
\n

示例

\n
_.isArrayLike([1, 2, 3]);\n// => true\n\n_.isArrayLike(document.body.children);\n// => true\n\n_.isArrayLike('abc');\n// => true\n\n_.isArrayLike(_.noop);\n// => false\n
\n
\n
\n\n
" } ,{ "href":"/isArrayLikeObject", - "html":"

isArrayLikeObject source npm

\n
_.isArrayLikeObject(value)
\n\n

这个方法类似 _.isArrayLike,除了它还检查值是否是个对象。

\n
\n\n

参数

\n
    \n
  1. value (*)

    要检查的值

    \n
  2. \n
\n

返回值 (boolean)

\n

如果是类数组对象,返回 true,否则返回 false

\n
\n

示例

\n
_.isArrayLikeObject([1, 2, 3]);\n// => true\n\n_.isArrayLikeObject(document.body.children);\n// => true\n\n_.isArrayLikeObject('abc');\n// => false\n\n_.isArrayLikeObject(_.noop);\n// => false\n
\n
\n
\n\n
" } + "html":"

isArrayLikeObject source npm

\n
_.isArrayLikeObject(value)
\n\n

这个方法类似 _.isArrayLike,除了它还检查值是否是个对象。

\n
\n\n

参数

\n
    \n
  1. value (*)

    要检查的值

    \n
  2. \n
\n

返回值 (boolean)

\n

如果是类数组对象,返回 true,否则返回 false

\n
\n

示例

\n
_.isArrayLikeObject([1, 2, 3]);\n// => true\n\n_.isArrayLikeObject(document.body.children);\n// => true\n\n_.isArrayLikeObject('abc');\n// => false\n\n_.isArrayLikeObject(_.noop);\n// => false\n
\n
\n
\n\n
" } ,{ "href":"/isBoolean", - "html":"

isBoolean source npm

\n
_.isBoolean(value)
\n\n

检查 value 是否是原始 boolean 类型或者对象。

\n
\n\n

参数

\n
    \n
  1. value (*)

    要检查的值

    \n
  2. \n
\n

返回值 (boolean)

\n

如果是正确的类型,返回 true,否则返回 false

\n
\n

示例

\n
_.isBoolean(false);\n// => true\n\n_.isBoolean(null);\n// => false\n
\n
\n
\n\n
" } + "html":"

isBoolean source npm

\n
_.isBoolean(value)
\n\n

检查 value 是否是原始 boolean 类型或者对象。

\n
\n\n

参数

\n
    \n
  1. value (*)

    要检查的值

    \n
  2. \n
\n

返回值 (boolean)

\n

如果是正确的类型,返回 true,否则返回 false

\n
\n

示例

\n
_.isBoolean(false);\n// => true\n\n_.isBoolean(null);\n// => false\n
\n
\n
\n\n
" } ,{ "href":"/isDate", - "html":"

isDate source npm

\n
_.isDate(value)
\n\n

检查 value 是否是 Date 类型

\n
\n\n

参数

\n
    \n
  1. value (*)

    要检查的值

    \n
  2. \n
\n

返回值 (boolean)

\n

如果是正确的类型,返回 true,否则返回 false

\n
\n

示例

\n
_.isDate(new Date);\n// => true\n\n_.isDate('Mon April 23 2012');\n// => false\n
\n
\n
\n\n
" } + "html":"

isDate source npm

\n
_.isDate(value)
\n\n

检查 value 是否是 Date 类型

\n
\n\n

参数

\n
    \n
  1. value (*)

    要检查的值

    \n
  2. \n
\n

返回值 (boolean)

\n

如果是正确的类型,返回 true,否则返回 false

\n
\n

示例

\n
_.isDate(new Date);\n// => true\n\n_.isDate('Mon April 23 2012');\n// => false\n
\n
\n
\n\n
" } ,{ "href":"/isElement", - "html":"

isElement source npm

\n
_.isElement(value)
\n\n

检查 value 是否是可能是 DOM 元素

\n
\n\n

参数

\n
    \n
  1. value (*)

    要检查的值

    \n
  2. \n
\n

返回值 (boolean)

\n

如果是 DOM 元素返回 true,否则返回 false

\n
\n

示例

\n
_.isElement(document.body);\n// => true\n\n_.isElement('<body>');\n// => false\n
\n
\n
\n\n
" } + "html":"

isElement source npm

\n
_.isElement(value)
\n\n

检查 value 是否是可能是 DOM 元素

\n
\n\n

参数

\n
    \n
  1. value (*)

    要检查的值

    \n
  2. \n
\n

返回值 (boolean)

\n

如果是 DOM 元素返回 true,否则返回 false

\n
\n

示例

\n
_.isElement(document.body);\n// => true\n\n_.isElement('<body>');\n// => false\n
\n
\n
\n\n
" } ,{ "href":"/isEmpty", - "html":"

isEmpty source npm

\n
_.isEmpty(value)
\n\n

检查 value 是否为空。\n判断的依据是除非是有枚举属性的对象,length 大于 0arguments object, array, string 或类jquery选择器。

\n
\n\n

参数

\n
    \n
  1. value (Array|Object|string)

    要检查的值

    \n
  2. \n
\n

返回值 (boolean)

\n

如果为空返回 true,否则返回 false

\n
\n

示例

\n
_.isEmpty(null);\n// => true\n\n_.isEmpty(true);\n// => true\n\n_.isEmpty(1);\n// => true\n\n_.isEmpty([1, 2, 3]);\n// => false\n\n_.isEmpty({ 'a': 1 });\n// => false\n
\n
\n
\n\n
" } + "html":"

isEmpty source npm

\n
_.isEmpty(value)
\n\n

检查 value 是否为空。\n判断的依据是除非是有枚举属性的对象,length 大于 0arguments object, array, string 或类jquery选择器。

\n
\n\n

参数

\n
    \n
  1. value (Array|Object|string)

    要检查的值

    \n
  2. \n
\n

返回值 (boolean)

\n

如果为空返回 true,否则返回 false

\n
\n

示例

\n
_.isEmpty(null);\n// => true\n\n_.isEmpty(true);\n// => true\n\n_.isEmpty(1);\n// => true\n\n_.isEmpty([1, 2, 3]);\n// => false\n\n_.isEmpty({ 'a': 1 });\n// => false\n
\n
\n
\n\n
" } ,{ "href":"/isEqual", - "html":"

isEqual source npm

\n
_.isEqual(value, other)
\n\n

执行深比较来决定两者的值是否相等。\n
\n
\n注意: 这个方法支持比较 arrays, array buffers, booleans,\ndate objects, error objects, maps, numbers, Object objects, regexes,\nsets, strings, symbols, 以及 typed arrays. Object 对象值比较自身的属性,不包括继承的和可枚举的属性。\n不支持函数和DOM节点。

\n
\n\n

参数

\n
    \n
  1. value (*)

    要比较的值

    \n
  2. \n
  3. other (*)

    其他要比较的值

    \n
  4. \n
\n

返回值 (boolean)

\n

如果相等返回 true,否则返回 false

\n
\n

示例

\n
var object = { 'user': 'fred' };\nvar other = { 'user': 'fred' };\n\n_.isEqual(object, other);\n// => true\n\nobject === other;\n// => false\n
\n
\n
\n\n
" } + "html":"

isEqual source npm

\n
_.isEqual(value, other)
\n\n

执行深比较来决定两者的值是否相等。\n
\n
\n注意: 这个方法支持比较 arrays, array buffers, booleans,\ndate objects, error objects, maps, numbers, Object objects, regexes,\nsets, strings, symbols, 以及 typed arrays. Object 对象值比较自身的属性,不包括继承的和可枚举的属性。\n不支持函数和DOM节点。

\n
\n\n

参数

\n
    \n
  1. value (*)

    要比较的值

    \n
  2. \n
  3. other (*)

    其他要比较的值

    \n
  4. \n
\n

返回值 (boolean)

\n

如果相等返回 true,否则返回 false

\n
\n

示例

\n
var object = { 'user': 'fred' };\nvar other = { 'user': 'fred' };\n\n_.isEqual(object, other);\n// => true\n\nobject === other;\n// => false\n
\n
\n
\n\n
" } ,{ "href":"/isEqualWith", - "html":"

isEqualWith source npm

\n
_.isEqualWith(value, other, [customizer])
\n\n

这个方法类似 _.isEqual。\n除了它接受一个 customizer 定制比较值。 如果 customizer 返回 undefined 将会比较处理方法代替。\ncustomizer 会传入7个参数:(objValue, othValue [, index|key, object, other, stack])

\n
\n\n

参数

\n
    \n
  1. value (*)

    要比较的值

    \n
  2. \n
  3. other (*)

    其他要比较的值

    \n
  4. \n
  5. [customizer] (Function)

    这个函数定制比较值

    \n
  6. \n
\n

返回值 (boolean)

\n

如果相等返回 true,否则返回 false

\n
\n

示例

\n
function isGreeting(value) {\n  return /^h(?:i|ello)$/.test(value);\n}\n\nfunction customizer(objValue, othValue) {\n  if (isGreeting(objValue) && isGreeting(othValue)) {\n    return true;\n  }\n}\n\nvar array = ['hello', 'goodbye'];\nvar other = ['hi', 'goodbye'];\n\n_.isEqualWith(array, other, customizer);\n// => true\n
\n
\n
\n\n
" } + "html":"

isEqualWith source npm

\n
_.isEqualWith(value, other, [customizer])
\n\n

这个方法类似 _.isEqual。\n除了它接受一个 customizer 定制比较值。 如果 customizer 返回 undefined 将会比较处理方法代替。\ncustomizer 会传入7个参数:(objValue, othValue [, index|key, object, other, stack])

\n
\n\n

参数

\n
    \n
  1. value (*)

    要比较的值

    \n
  2. \n
  3. other (*)

    其他要比较的值

    \n
  4. \n
  5. [customizer] (Function)

    这个函数定制比较值

    \n
  6. \n
\n

返回值 (boolean)

\n

如果相等返回 true,否则返回 false

\n
\n

示例

\n
function isGreeting(value) {\n  return /^h(?:i|ello)$/.test(value);\n}\n\nfunction customizer(objValue, othValue) {\n  if (isGreeting(objValue) && isGreeting(othValue)) {\n    return true;\n  }\n}\n\nvar array = ['hello', 'goodbye'];\nvar other = ['hi', 'goodbye'];\n\n_.isEqualWith(array, other, customizer);\n// => true\n
\n
\n
\n\n
" } ,{ "href":"/isError", - "html":"

isError source npm

\n
_.isError(value)
\n\n

检查 value 是否是 Error, EvalError, RangeError, ReferenceError,\nSyntaxError, TypeError, 或 URIError object.

\n
\n\n

参数

\n
    \n
  1. value (*)

    要检查的值

    \n
  2. \n
\n

返回值 (boolean)

\n

如果是 error object 返回 true,否则返回 false

\n
\n

示例

\n
_.isError(new Error);\n// => true\n\n_.isError(Error);\n// => false\n
\n
\n
\n\n
" } + "html":"

isError source npm

\n
_.isError(value)
\n\n

检查 value 是否是 Error, EvalError, RangeError, ReferenceError,\nSyntaxError, TypeError, 或 URIError object.

\n
\n\n

参数

\n
    \n
  1. value (*)

    要检查的值

    \n
  2. \n
\n

返回值 (boolean)

\n

如果是 error object 返回 true,否则返回 false

\n
\n

示例

\n
_.isError(new Error);\n// => true\n\n_.isError(Error);\n// => false\n
\n
\n
\n\n
" } ,{ "href":"/isFinite", - "html":"

isFinite source npm

\n
_.isFinite(value)
\n\n

检查 value 是否是原始 finite number。\n
\n
\n注意: 这个方法基于 Number.isFinite.

\n
\n\n

参数

\n
    \n
  1. value (*)

    要检查的值

    \n
  2. \n
\n

返回值 (boolean)

\n

如果是 finite number 返回 true,否则返回 false

\n
\n

示例

\n
_.isFinite(3);\n// => true\n\n_.isFinite(Number.MAX_VALUE);\n// => true\n\n_.isFinite(3.14);\n// => true\n\n_.isFinite(Infinity);\n// => false\n
\n
\n
\n\n
" } + "html":"

isFinite source npm

\n
_.isFinite(value)
\n\n

检查 value 是否是原始 finite number。\n
\n
\n注意: 这个方法基于 Number.isFinite.

\n
\n\n

参数

\n
    \n
  1. value (*)

    要检查的值

    \n
  2. \n
\n

返回值 (boolean)

\n

如果是 finite number 返回 true,否则返回 false

\n
\n

示例

\n
_.isFinite(3);\n// => true\n\n_.isFinite(Number.MAX_VALUE);\n// => true\n\n_.isFinite(3.14);\n// => true\n\n_.isFinite(Infinity);\n// => false\n
\n
\n
\n\n
" } ,{ "href":"/isFunction", - "html":"

isFunction source npm

\n
_.isFunction(value)
\n\n

检查 value 是否是 Function 对象。

\n
\n\n

参数

\n
    \n
  1. value (*)

    要检查的值

    \n
  2. \n
\n

返回值 (boolean)

\n

如果是正确的类型,返回 true,否则返回 false

\n
\n

示例

\n
_.isFunction(_);\n// => true\n\n_.isFunction(/abc/);\n// => false\n
\n
\n
\n\n
" } + "html":"

isFunction source npm

\n
_.isFunction(value)
\n\n

检查 value 是否是 Function 对象。

\n
\n\n

参数

\n
    \n
  1. value (*)

    要检查的值

    \n
  2. \n
\n

返回值 (boolean)

\n

如果是正确的类型,返回 true,否则返回 false

\n
\n

示例

\n
_.isFunction(_);\n// => true\n\n_.isFunction(/abc/);\n// => false\n
\n
\n
\n\n
" } ,{ "href":"/isInteger", - "html":"

isInteger source npm

\n
_.isInteger(value)
\n\n

检查 value 是否是整数。\n
\n
\n注意: 这个方法基于 Number.isInteger.

\n
\n\n

参数

\n
    \n
  1. value (*)

    要检查的值

    \n
  2. \n
\n

返回值 (boolean)

\n

如果是整数返回 true,否则返回 false

\n
\n

示例

\n
_.isInteger(3);\n// => true\n\n_.isInteger(Number.MIN_VALUE);\n// => false\n\n_.isInteger(Infinity);\n// => false\n\n_.isInteger('3');\n// => false\n
\n
\n
\n\n
" } + "html":"

isInteger source npm

\n
_.isInteger(value)
\n\n

检查 value 是否是整数。\n
\n
\n注意: 这个方法基于 Number.isInteger.

\n
\n\n

参数

\n
    \n
  1. value (*)

    要检查的值

    \n
  2. \n
\n

返回值 (boolean)

\n

如果是整数返回 true,否则返回 false

\n
\n

示例

\n
_.isInteger(3);\n// => true\n\n_.isInteger(Number.MIN_VALUE);\n// => false\n\n_.isInteger(Infinity);\n// => false\n\n_.isInteger('3');\n// => false\n
\n
\n
\n\n
" } ,{ "href":"/isLength", - "html":"

isLength source npm

\n
_.isLength(value)
\n\n

检查 value 是否是有效长度\n
\n
\n注意: 这个方法参考自 ToLength.

\n
\n\n

参数

\n
    \n
  1. value (*)

    要检查的值

    \n
  2. \n
\n

返回值 (boolean)

\n

如果是有效长度返回 true,否则返回 false

\n
\n

示例

\n
_.isLength(3);\n// => true\n\n_.isLength(Number.MIN_VALUE);\n// => false\n\n_.isLength(Infinity);\n// => false\n\n_.isLength('3');\n// => false\n
\n
\n
\n\n
" } + "html":"

isLength source npm

\n
_.isLength(value)
\n\n

检查 value 是否是有效长度\n
\n
\n注意: 这个方法参考自 ToLength.

\n
\n\n

参数

\n
    \n
  1. value (*)

    要检查的值

    \n
  2. \n
\n

返回值 (boolean)

\n

如果是有效长度返回 true,否则返回 false

\n
\n

示例

\n
_.isLength(3);\n// => true\n\n_.isLength(Number.MIN_VALUE);\n// => false\n\n_.isLength(Infinity);\n// => false\n\n_.isLength('3');\n// => false\n
\n
\n
\n\n
" } ,{ "href":"/isMatch", - "html":"

isMatch source npm

\n
_.isMatch(object, source)
\n\n

执行一个深比较来确定object 是否包含有 source 的属性值。\n
\n
\n注意: 这个方法支持比较相同的值和 _.isEqual 一样

\n
\n\n

参数

\n
    \n
  1. object (Object)

    要检查的值

    \n
  2. \n
  3. source (Object)

    匹配包含在 object 的对象

    \n
  4. \n
\n

返回值 (boolean)

\n

如果匹配返回 true,否则返回 false

\n
\n

示例

\n
var object = { 'user': 'fred', 'age': 40 };\n\n_.isMatch(object, { 'age': 40 });\n// => true\n\n_.isMatch(object, { 'age': 36 });\n// => false\n
\n
\n
\n\n
" } + "html":"

isMatch source npm

\n
_.isMatch(object, source)
\n\n

执行一个深比较来确定object 是否包含有 source 的属性值。\n
\n
\n注意: 这个方法支持比较相同的值和 _.isEqual 一样

\n
\n\n

参数

\n
    \n
  1. object (Object)

    要检查的值

    \n
  2. \n
  3. source (Object)

    匹配包含在 object 的对象

    \n
  4. \n
\n

返回值 (boolean)

\n

如果匹配返回 true,否则返回 false

\n
\n

示例

\n
var object = { 'user': 'fred', 'age': 40 };\n\n_.isMatch(object, { 'age': 40 });\n// => true\n\n_.isMatch(object, { 'age': 36 });\n// => false\n
\n
\n
\n\n
" } ,{ "href":"/isMatchWith", - "html":"

isMatchWith source npm

\n
_.isMatchWith(object, source, [customizer])
\n\n

这个方法类似 _.isMatch。\n除了它接受一个 customizer 定制比较的值。 \n如果 customizer 返回 undefined 将会比较处理方法代替。 customizer 会传入5个参数:(objValue, srcValue, index|key, object, source)

\n
\n\n

参数

\n
    \n
  1. object (Object)

    要检查的值

    \n
  2. \n
  3. source (Object)

    匹配包含在 object 的对象

    \n
  4. \n
  5. [customizer] (Function)

    这个函数定制比较值

    \n
  6. \n
\n

返回值 (boolean)

\n

如果匹配返回 true,否则返回 false

\n
\n

示例

\n
function isGreeting(value) {\n  return /^h(?:i|ello)$/.test(value);\n}\n\nfunction customizer(objValue, srcValue) {\n  if (isGreeting(objValue) && isGreeting(srcValue)) {\n    return true;\n  }\n}\n\nvar object = { 'greeting': 'hello' };\nvar source = { 'greeting': 'hi' };\n\n_.isMatchWith(object, source, customizer);\n// => true\n
\n
\n
\n\n
" } + "html":"

isMatchWith source npm

\n
_.isMatchWith(object, source, [customizer])
\n\n

这个方法类似 _.isMatch。\n除了它接受一个 customizer 定制比较的值。 \n如果 customizer 返回 undefined 将会比较处理方法代替。 customizer 会传入5个参数:(objValue, srcValue, index|key, object, source)

\n
\n\n

参数

\n
    \n
  1. object (Object)

    要检查的值

    \n
  2. \n
  3. source (Object)

    匹配包含在 object 的对象

    \n
  4. \n
  5. [customizer] (Function)

    这个函数定制比较值

    \n
  6. \n
\n

返回值 (boolean)

\n

如果匹配返回 true,否则返回 false

\n
\n

示例

\n
function isGreeting(value) {\n  return /^h(?:i|ello)$/.test(value);\n}\n\nfunction customizer(objValue, srcValue) {\n  if (isGreeting(objValue) && isGreeting(srcValue)) {\n    return true;\n  }\n}\n\nvar object = { 'greeting': 'hello' };\nvar source = { 'greeting': 'hi' };\n\n_.isMatchWith(object, source, customizer);\n// => true\n
\n
\n
\n\n
" } ,{ "href":"/isNaN", - "html":"

isNaN source npm

\n
_.isNaN(value)
\n\n

检查 value 是否是 NaN.\n
\n
\n注意: 这个方法不同于 isNaN\n对 undefind 和 其他非数值返回 true.

\n
\n\n

参数

\n
    \n
  1. value (*)

    要检查的值

    \n
  2. \n
\n

返回值 (boolean)

\n

如果符合 NaN 返回 true,否则返回 false

\n
\n

示例

\n
_.isNaN(NaN);\n// => true\n\n_.isNaN(new Number(NaN));\n// => true\n\nisNaN(undefined);\n// => true\n\n_.isNaN(undefined);\n// => false\n
\n
\n
\n\n
" } + "html":"

isNaN source npm

\n
_.isNaN(value)
\n\n

检查 value 是否是 NaN.\n
\n
\n注意: 这个方法不同于 isNaN\n对 undefind 和 其他非数值返回 true.

\n
\n\n

参数

\n
    \n
  1. value (*)

    要检查的值

    \n
  2. \n
\n

返回值 (boolean)

\n

如果符合 NaN 返回 true,否则返回 false

\n
\n

示例

\n
_.isNaN(NaN);\n// => true\n\n_.isNaN(new Number(NaN));\n// => true\n\nisNaN(undefined);\n// => true\n\n_.isNaN(undefined);\n// => false\n
\n
\n
\n\n
" } ,{ "href":"/isNative", - "html":"

isNative source npm

\n
_.isNative(value)
\n\n

检查 value 是否是原生函数

\n
\n\n

参数

\n
    \n
  1. value (*)

    要检查的值

    \n
  2. \n
\n

返回值 (boolean)

\n

如果是原生函数返回 true,否则返回 false

\n
\n

示例

\n
_.isNative(Array.prototype.push);\n// => true\n\n_.isNative(_);\n// => false\n
\n
\n
\n\n
" } + "html":"

isNative source npm

\n
_.isNative(value)
\n\n

检查 value 是否是原生函数

\n
\n\n

参数

\n
    \n
  1. value (*)

    要检查的值

    \n
  2. \n
\n

返回值 (boolean)

\n

如果是原生函数返回 true,否则返回 false

\n
\n

示例

\n
_.isNative(Array.prototype.push);\n// => true\n\n_.isNative(_);\n// => false\n
\n
\n
\n\n
" } ,{ "href":"/isNil", - "html":"

isNil source npm

\n
_.isNil(value)
\n\n

检查 value 是否是 null 或者 undefined

\n
\n\n

参数

\n
    \n
  1. value (*)

    要检查的值

    \n
  2. \n
\n

返回值 (boolean)

\n

如果是 null 或者 undefined 返回 true,否则返回 false

\n
\n

示例

\n
_.isNil(null);\n// => true\n\n_.isNil(void 0);\n// => true\n\n_.isNil(NaN);\n// => false\n
\n
\n
\n\n
" } + "html":"

isNil source npm

\n
_.isNil(value)
\n\n

检查 value 是否是 null 或者 undefined

\n
\n\n

参数

\n
    \n
  1. value (*)

    要检查的值

    \n
  2. \n
\n

返回值 (boolean)

\n

如果是 null 或者 undefined 返回 true,否则返回 false

\n
\n

示例

\n
_.isNil(null);\n// => true\n\n_.isNil(void 0);\n// => true\n\n_.isNil(NaN);\n// => false\n
\n
\n
\n\n
" } ,{ "href":"/isNull", - "html":"

isNull source npm

\n
_.isNull(value)
\n\n

检查 value 是否是 null.

\n
\n\n

参数

\n
    \n
  1. value (*)

    要检查的值

    \n
  2. \n
\n

返回值 (boolean)

\n

如果是 null 返回 true,否则返回 false

\n
\n

示例

\n
_.isNull(null);\n// => true\n\n_.isNull(void 0);\n// => false\n
\n
\n
\n\n
" } + "html":"

isNull source npm

\n
_.isNull(value)
\n\n

检查 value 是否是 null.

\n
\n\n

参数

\n
    \n
  1. value (*)

    要检查的值

    \n
  2. \n
\n

返回值 (boolean)

\n

如果是 null 返回 true,否则返回 false

\n
\n

示例

\n
_.isNull(null);\n// => true\n\n_.isNull(void 0);\n// => false\n
\n
\n
\n\n
" } ,{ "href":"/isNumber", - "html":"

isNumber source npm

\n
_.isNumber(value)
\n\n

检查 value 是否是原始数值型 或者 对象。\n
\n
\n注意: 要排除 Infinity, -Infinity, 以及 NaN 数值类型,用 _.isFinite 方法

\n
\n\n

参数

\n
    \n
  1. value (*)

    要检查的值

    \n
  2. \n
\n

返回值 (boolean)

\n

如果是正确的类型,返回 true,否则返回 false

\n
\n

示例

\n
_.isNumber(3);\n// => true\n\n_.isNumber(Number.MIN_VALUE);\n// => true\n\n_.isNumber(Infinity);\n// => true\n\n_.isNumber('3');\n// => false\n
\n
\n
\n\n
" } + "html":"

isNumber source npm

\n
_.isNumber(value)
\n\n

检查 value 是否是原始数值型 或者 对象。\n
\n
\n注意: 要排除 Infinity, -Infinity, 以及 NaN 数值类型,用 _.isFinite 方法

\n
\n\n

参数

\n
    \n
  1. value (*)

    要检查的值

    \n
  2. \n
\n

返回值 (boolean)

\n

如果是正确的类型,返回 true,否则返回 false

\n
\n

示例

\n
_.isNumber(3);\n// => true\n\n_.isNumber(Number.MIN_VALUE);\n// => true\n\n_.isNumber(Infinity);\n// => true\n\n_.isNumber('3');\n// => false\n
\n
\n
\n\n
" } ,{ "href":"/isObject", - "html":"

isObject source npm

\n
_.isObject(value)
\n\n

检查 value 是否是 Objectlanguage type。\n(例如: arrays, functions, objects, regexes, new Number(0), 以及 new String(''))

\n
\n\n

参数

\n
    \n
  1. value (*)

    要检查的值

    \n
  2. \n
\n

返回值 (boolean)

\n

如果是对象返回 true,否则返回 false

\n
\n

示例

\n
_.isObject({});\n// => true\n\n_.isObject([1, 2, 3]);\n// => true\n\n_.isObject(_.noop);\n// => true\n\n_.isObject(null);\n// => false\n
\n
\n
\n\n
" } + "html":"

isObject source npm

\n
_.isObject(value)
\n\n

检查 value 是否是 Objectlanguage type。\n(例如: arrays, functions, objects, regexes, new Number(0), 以及 new String(''))

\n
\n\n

参数

\n
    \n
  1. value (*)

    要检查的值

    \n
  2. \n
\n

返回值 (boolean)

\n

如果是对象返回 true,否则返回 false

\n
\n

示例

\n
_.isObject({});\n// => true\n\n_.isObject([1, 2, 3]);\n// => true\n\n_.isObject(_.noop);\n// => true\n\n_.isObject(null);\n// => false\n
\n
\n
\n\n
" } ,{ "href":"/isObjectLike", - "html":"

isObjectLike source npm

\n
_.isObjectLike(value)
\n\n

检查 value 是否是 类对象。\n类对象应该不是 null 以及 typeof 的结果是 "object"。

\n
\n\n

参数

\n
    \n
  1. value (*)

    要检查的值

    \n
  2. \n
\n

返回值 (boolean)

\n

如果是类对象返回 true,否则返回 false

\n
\n

示例

\n
_.isObjectLike({});\n// => true\n\n_.isObjectLike([1, 2, 3]);\n// => true\n\n_.isObjectLike(_.noop);\n// => false\n\n_.isObjectLike(null);\n// => false\n
\n
\n
\n\n
" } + "html":"

isObjectLike source npm

\n
_.isObjectLike(value)
\n\n

检查 value 是否是 类对象。\n类对象应该不是 null 以及 typeof 的结果是 "object"。

\n
\n\n

参数

\n
    \n
  1. value (*)

    要检查的值

    \n
  2. \n
\n

返回值 (boolean)

\n

如果是类对象返回 true,否则返回 false

\n
\n

示例

\n
_.isObjectLike({});\n// => true\n\n_.isObjectLike([1, 2, 3]);\n// => true\n\n_.isObjectLike(_.noop);\n// => false\n\n_.isObjectLike(null);\n// => false\n
\n
\n
\n\n
" } ,{ "href":"/isPlainObject", - "html":"

isPlainObject source npm

\n
_.isPlainObject(value)
\n\n

检查 value 是否是普通对象。\n也就是说该对象由 Object 构造函数创建或者 [[Prototype]] 为空。

\n
\n\n

参数

\n
    \n
  1. value (*)

    要检查的值

    \n
  2. \n
\n

返回值 (boolean)

\n

如果是普通对象返回 true,否则返回 false

\n
\n

示例

\n
function Foo() {\n  this.a = 1;\n}\n\n_.isPlainObject(new Foo);\n// => false\n\n_.isPlainObject([1, 2, 3]);\n// => false\n\n_.isPlainObject({ 'x': 0, 'y': 0 });\n// => true\n\n_.isPlainObject(Object.create(null));\n// => true\n
\n
\n
\n\n
" } + "html":"

isPlainObject source npm

\n
_.isPlainObject(value)
\n\n

检查 value 是否是普通对象。\n也就是说该对象由 Object 构造函数创建或者 [[Prototype]] 为空。

\n
\n\n

参数

\n
    \n
  1. value (*)

    要检查的值

    \n
  2. \n
\n

返回值 (boolean)

\n

如果是普通对象返回 true,否则返回 false

\n
\n

示例

\n
function Foo() {\n  this.a = 1;\n}\n\n_.isPlainObject(new Foo);\n// => false\n\n_.isPlainObject([1, 2, 3]);\n// => false\n\n_.isPlainObject({ 'x': 0, 'y': 0 });\n// => true\n\n_.isPlainObject(Object.create(null));\n// => true\n
\n
\n
\n\n
" } ,{ "href":"/isRegExp", - "html":"

isRegExp source npm

\n
_.isRegExp(value)
\n\n

检查 value 是否是 RegExp 对象

\n
\n\n

参数

\n
    \n
  1. value (*)

    要检查的值

    \n
  2. \n
\n

返回值 (boolean)

\n

如果是正确的类型,返回 true,否则返回 false

\n
\n

示例

\n
_.isRegExp(/abc/);\n// => true\n\n_.isRegExp('/abc/');\n// => false\n
\n
\n
\n\n
" } + "html":"

isRegExp source npm

\n
_.isRegExp(value)
\n\n

检查 value 是否是 RegExp 对象

\n
\n\n

参数

\n
    \n
  1. value (*)

    要检查的值

    \n
  2. \n
\n

返回值 (boolean)

\n

如果是正确的类型,返回 true,否则返回 false

\n
\n

示例

\n
_.isRegExp(/abc/);\n// => true\n\n_.isRegExp('/abc/');\n// => false\n
\n
\n
\n\n
" } ,{ "href":"/isSafeInteger", - "html":"

isSafeInteger source npm

\n
_.isSafeInteger(value)
\n\n

检查 value 是否是安全整数。\n这个整数应该是符合 IEEE-754 标准的非双精度浮点数。\n
\n
\n注意: 这个方法基于 Number.isSafeInteger.

\n
\n\n

参数

\n
    \n
  1. value (*)

    要检查的值

    \n
  2. \n
\n

返回值 (boolean)

\n

如果是安全整数返回true,否则返回 false

\n
\n

示例

\n
_.isSafeInteger(3);\n// => true\n\n_.isSafeInteger(Number.MIN_VALUE);\n// => false\n\n_.isSafeInteger(Infinity);\n// => false\n\n_.isSafeInteger('3');\n// => false\n
\n
\n
\n\n
" } + "html":"

isSafeInteger source npm

\n
_.isSafeInteger(value)
\n\n

检查 value 是否是安全整数。\n这个整数应该是符合 IEEE-754 标准的非双精度浮点数。\n
\n
\n注意: 这个方法基于 Number.isSafeInteger.

\n
\n\n

参数

\n
    \n
  1. value (*)

    要检查的值

    \n
  2. \n
\n

返回值 (boolean)

\n

如果是安全整数返回true,否则返回 false

\n
\n

示例

\n
_.isSafeInteger(3);\n// => true\n\n_.isSafeInteger(Number.MIN_VALUE);\n// => false\n\n_.isSafeInteger(Infinity);\n// => false\n\n_.isSafeInteger('3');\n// => false\n
\n
\n
\n\n
" } ,{ "href":"/isString", - "html":"

isString source npm

\n
_.isString(value)
\n\n

检查 value 是否是原始字符串或者对象。

\n
\n\n

参数

\n
    \n
  1. value (*)

    要检查的值

    \n
  2. \n
\n

返回值 (boolean)

\n

如果是正确的类型,返回 true,否则返回 false

\n
\n

示例

\n
_.isString('abc');\n// => true\n\n_.isString(1);\n// => false\n
\n
\n
\n\n
" } + "html":"

isString source npm

\n
_.isString(value)
\n\n

检查 value 是否是原始字符串或者对象。

\n
\n\n

参数

\n
    \n
  1. value (*)

    要检查的值

    \n
  2. \n
\n

返回值 (boolean)

\n

如果是正确的类型,返回 true,否则返回 false

\n
\n

示例

\n
_.isString('abc');\n// => true\n\n_.isString(1);\n// => false\n
\n
\n
\n\n
" } ,{ "href":"/isSymbol", - "html":"

isSymbol source npm

\n
_.isSymbol(value)
\n\n

检查 value 是否是原始 Symbol 或者对象。

\n
\n\n

参数

\n
    \n
  1. value (*)

    要检查的值

    \n
  2. \n
\n

返回值 (boolean)

\n

如果是正确的类型,返回 true,否则返回 false

\n
\n

示例

\n
_.isSymbol(Symbol.iterator);\n// => true\n\n_.isSymbol('abc');\n// => false\n
\n
\n
\n\n
" } + "html":"

isSymbol source npm

\n
_.isSymbol(value)
\n\n

检查 value 是否是原始 Symbol 或者对象。

\n
\n\n

参数

\n
    \n
  1. value (*)

    要检查的值

    \n
  2. \n
\n

返回值 (boolean)

\n

如果是正确的类型,返回 true,否则返回 false

\n
\n

示例

\n
_.isSymbol(Symbol.iterator);\n// => true\n\n_.isSymbol('abc');\n// => false\n
\n
\n
\n\n
" } ,{ "href":"/isTypedArray", - "html":"

isTypedArray source npm

\n
_.isTypedArray(value)
\n\n

检查 value 是否是TypedArray。

\n
\n\n

参数

\n
    \n
  1. value (*)

    要检查的值

    \n
  2. \n
\n

返回值 (boolean)

\n

如果是正确的类型,返回 true,否则返回 false

\n
\n

示例

\n
_.isTypedArray(new Uint8Array);\n// => true\n\n_.isTypedArray([]);\n// => false\n
\n
\n
\n\n
" } + "html":"

isTypedArray source npm

\n
_.isTypedArray(value)
\n\n

检查 value 是否是TypedArray。

\n
\n\n

参数

\n
    \n
  1. value (*)

    要检查的值

    \n
  2. \n
\n

返回值 (boolean)

\n

如果是正确的类型,返回 true,否则返回 false

\n
\n

示例

\n
_.isTypedArray(new Uint8Array);\n// => true\n\n_.isTypedArray([]);\n// => false\n
\n
\n
\n\n
" } ,{ "href":"/isUndefined", - "html":"

isUndefined source npm

\n
_.isUndefined(value)
\n\n

检查 value 是否是 undefined.

\n
\n\n

参数

\n
    \n
  1. value (*)

    要检查的值

    \n
  2. \n
\n

返回值 (boolean)

\n

Returns true if value is undefined否则返回 false

\n
\n

示例

\n
_.isUndefined(void 0);\n// => true\n\n_.isUndefined(null);\n// => false\n
\n
\n
\n\n
" } + "html":"

isUndefined source npm

\n
_.isUndefined(value)
\n\n

检查 value 是否是 undefined.

\n
\n\n

参数

\n
    \n
  1. value (*)

    要检查的值

    \n
  2. \n
\n

返回值 (boolean)

\n

Returns true if value is undefined否则返回 false

\n
\n

示例

\n
_.isUndefined(void 0);\n// => true\n\n_.isUndefined(null);\n// => false\n
\n
\n
\n\n
" } ,{ "href":"/lt", - "html":"

lt source npm

\n
_.lt(value, other)
\n\n

检查 value 是否是 小于 other

\n
\n\n

参数

\n
    \n
  1. value (*)

    要比较的值

    \n
  2. \n
  3. other (*)

    其他要比较的值

    \n
  4. \n
\n

返回值 (boolean)

\n

如果 value 小于 other 返回 true,否则返回 false

\n
\n

示例

\n
_.lt(1, 3);\n// => true\n\n_.lt(3, 3);\n// => false\n\n_.lt(3, 1);\n// => false\n
\n
\n
\n\n
" } + "html":"

lt source npm

\n
_.lt(value, other)
\n\n

检查 value 是否是 小于 other

\n
\n\n

参数

\n
    \n
  1. value (*)

    要比较的值

    \n
  2. \n
  3. other (*)

    其他要比较的值

    \n
  4. \n
\n

返回值 (boolean)

\n

如果 value 小于 other 返回 true,否则返回 false

\n
\n

示例

\n
_.lt(1, 3);\n// => true\n\n_.lt(3, 3);\n// => false\n\n_.lt(3, 1);\n// => false\n
\n
\n
\n\n
" } ,{ "href":"/lte", - "html":"

lte source npm

\n
_.lte(value, other)
\n\n

检查 value 是否是 小于等于 other.

\n
\n\n

参数

\n
    \n
  1. value (*)

    要比较的值

    \n
  2. \n
  3. other (*)

    其他要比较的值

    \n
  4. \n
\n

返回值 (boolean)

\n

如果 value 小于等于 other 返回 true,否则返回 false

\n
\n

示例

\n
_.lte(1, 3);\n// => true\n\n_.lte(3, 3);\n// => true\n\n_.lte(3, 1);\n// => false\n
\n
\n
\n\n
" } + "html":"

lte source npm

\n
_.lte(value, other)
\n\n

检查 value 是否是 小于等于 other.

\n
\n\n

参数

\n
    \n
  1. value (*)

    要比较的值

    \n
  2. \n
  3. other (*)

    其他要比较的值

    \n
  4. \n
\n

返回值 (boolean)

\n

如果 value 小于等于 other 返回 true,否则返回 false

\n
\n

示例

\n
_.lte(1, 3);\n// => true\n\n_.lte(3, 3);\n// => true\n\n_.lte(3, 1);\n// => false\n
\n
\n
\n\n
" } ,{ "href":"/toArray", - "html":"

toArray source npm

\n
_.toArray(value)
\n\n

转换 value 为数组

\n
\n\n

参数

\n
    \n
  1. value (*)

    要转换的值

    \n
  2. \n
\n

返回值 (Array)

\n

然后转换后的数组

\n
\n

示例

\n
(function() {\n  return _.toArray(arguments).slice(1);\n}(1, 2, 3));\n// => [2, 3]\n
\n
\n
\n\n
" } + "html":"

toArray source npm

\n
_.toArray(value)
\n\n

转换 value 为数组

\n
\n\n

参数

\n
    \n
  1. value (*)

    要转换的值

    \n
  2. \n
\n

返回值 (Array)

\n

然后转换后的数组

\n
\n

示例

\n
(function() {\n  return _.toArray(arguments).slice(1);\n}(1, 2, 3));\n// => [2, 3]\n
\n
\n
\n\n
" } ,{ "href":"/toInteger", - "html":"

toInteger source npm

\n
_.toInteger(value)
\n\n

转换 value 为整数\n
\n
\n注意: 这个函数参考 ToInteger.

\n
\n\n

参数

\n
    \n
  1. value (*)

    要转换的值

    \n
  2. \n
\n

返回值 (number)

\n

返回转换后的整数

\n
\n

示例

\n
_.toInteger(3);\n// => 3\n\n_.toInteger(Number.MIN_VALUE);\n// => 0\n\n_.toInteger(Infinity);\n// => 1.7976931348623157e+308\n\n_.toInteger('3');\n// => 3\n
\n
\n
\n\n
" } + "html":"

toInteger source npm

\n
_.toInteger(value)
\n\n

转换 value 为整数\n
\n
\n注意: 这个函数参考 ToInteger.

\n
\n\n

参数

\n
    \n
  1. value (*)

    要转换的值

    \n
  2. \n
\n

返回值 (number)

\n

返回转换后的整数

\n
\n

示例

\n
_.toInteger(3);\n// => 3\n\n_.toInteger(Number.MIN_VALUE);\n// => 0\n\n_.toInteger(Infinity);\n// => 1.7976931348623157e+308\n\n_.toInteger('3');\n// => 3\n
\n
\n
\n\n
" } ,{ "href":"/toLength", - "html":"

toLength source npm

\n
_.toLength(value)
\n\n

转换 value 为用作类数组对象的长度整数。\n
\n
\n注意: 这个方法基于 ToLength.

\n
\n\n

参数

\n
    \n
  1. value (*)

    要转换的值

    \n
  2. \n
\n

返回值 (number)

\n

返回转换后的整数

\n
\n

示例

\n
_.toLength(3);\n// => 3\n\n_.toLength(Number.MIN_VALUE);\n// => 0\n\n_.toLength(Infinity);\n// => 4294967295\n\n_.toLength('3');\n// => 3\n
\n
\n
\n\n
" } + "html":"

toLength source npm

\n
_.toLength(value)
\n\n

转换 value 为用作类数组对象的长度整数。\n
\n
\n注意: 这个方法基于 ToLength.

\n
\n\n

参数

\n
    \n
  1. value (*)

    要转换的值

    \n
  2. \n
\n

返回值 (number)

\n

返回转换后的整数

\n
\n

示例

\n
_.toLength(3);\n// => 3\n\n_.toLength(Number.MIN_VALUE);\n// => 0\n\n_.toLength(Infinity);\n// => 4294967295\n\n_.toLength('3');\n// => 3\n
\n
\n
\n\n
" } ,{ "href":"/toNumber", - "html":"

toNumber source npm

\n
_.toNumber(value)
\n\n

转换 value 为数值

\n
\n\n

参数

\n
    \n
  1. value (*)

    要处理的值

    \n
  2. \n
\n

返回值 (number)

\n

返回数值

\n
\n

示例

\n
_.toNumber(3);\n// => 3\n\n_.toNumber(Number.MIN_VALUE);\n// => 5e-324\n\n_.toNumber(Infinity);\n// => Infinity\n\n_.toNumber('3');\n// => 3\n
\n
\n
\n\n
" } + "html":"

toNumber source npm

\n
_.toNumber(value)
\n\n

转换 value 为数值

\n
\n\n

参数

\n
    \n
  1. value (*)

    要处理的值

    \n
  2. \n
\n

返回值 (number)

\n

返回数值

\n
\n

示例

\n
_.toNumber(3);\n// => 3\n\n_.toNumber(Number.MIN_VALUE);\n// => 5e-324\n\n_.toNumber(Infinity);\n// => Infinity\n\n_.toNumber('3');\n// => 3\n
\n
\n
\n\n
" } ,{ "href":"/toPlainObject", - "html":"

toPlainObject source npm

\n
_.toPlainObject(value)
\n\n

转换 value 为普通对象。\n包括继承的可枚举属性。

\n
\n\n

参数

\n
    \n
  1. value (*)

    要转换的值

    \n
  2. \n
\n

返回值 (Object)

\n

返回转换后的普通对象

\n
\n

示例

\n
function Foo() {\n  this.b = 2;\n}\n\nFoo.prototype.c = 3;\n\n_.assign({ 'a': 1 }, new Foo);\n// => { 'a': 1, 'b': 2 }\n\n_.assign({ 'a': 1 }, _.toPlainObject(new Foo));\n// => { 'a': 1, 'b': 2, 'c': 3 }\n
\n
\n
\n\n
" } + "html":"

toPlainObject source npm

\n
_.toPlainObject(value)
\n\n

转换 value 为普通对象。\n包括继承的可枚举属性。

\n
\n\n

参数

\n
    \n
  1. value (*)

    要转换的值

    \n
  2. \n
\n

返回值 (Object)

\n

返回转换后的普通对象

\n
\n

示例

\n
function Foo() {\n  this.b = 2;\n}\n\nFoo.prototype.c = 3;\n\n_.assign({ 'a': 1 }, new Foo);\n// => { 'a': 1, 'b': 2 }\n\n_.assign({ 'a': 1 }, _.toPlainObject(new Foo));\n// => { 'a': 1, 'b': 2, 'c': 3 }\n
\n
\n
\n\n
" } ,{ "href":"/toSafeInteger", - "html":"

toSafeInteger source npm

\n
_.toSafeInteger(value)
\n\n

转换 value 为安全整数。\n安全整数可以用于比较和准确的表示。

\n
\n\n

参数

\n
    \n
  1. value (*)

    要转换的值

    \n
  2. \n
\n

返回值 (number)

\n

返回转换后的整数

\n
\n

示例

\n
_.toSafeInteger(3);\n// => 3\n\n_.toSafeInteger(Number.MIN_VALUE);\n// => 0\n\n_.toSafeInteger(Infinity);\n// => 9007199254740991\n\n_.toSafeInteger('3');\n// => 3\n
\n
\n
\n\n
" } + "html":"

toSafeInteger source npm

\n
_.toSafeInteger(value)
\n\n

转换 value 为安全整数。\n安全整数可以用于比较和准确的表示。

\n
\n\n

参数

\n
    \n
  1. value (*)

    要转换的值

    \n
  2. \n
\n

返回值 (number)

\n

返回转换后的整数

\n
\n

示例

\n
_.toSafeInteger(3);\n// => 3\n\n_.toSafeInteger(Number.MIN_VALUE);\n// => 0\n\n_.toSafeInteger(Infinity);\n// => 9007199254740991\n\n_.toSafeInteger('3');\n// => 3\n
\n
\n
\n\n
" } ,{ "href":"/toString", - "html":"

toString source npm

\n
_.toString(value)
\n\n

如果 value 不是字符串,将其转换为字符串。\nnullundefined 将返回空字符串。

\n
\n\n

参数

\n
    \n
  1. value (*)

    要转换的值

    \n
  2. \n
\n

返回值 (string)

\n

返回字符串

\n
\n

示例

\n
_.toString(null);\n// => ''\n\n_.toString(-0);\n// => '-0'\n\n_.toString([1, 2, 3]);\n// => '1,2,3'\n
\n
\n
\n\n
" } + "html":"

toString source npm

\n
_.toString(value)
\n\n

如果 value 不是字符串,将其转换为字符串。\nnullundefined 将返回空字符串。

\n
\n\n

参数

\n
    \n
  1. value (*)

    要转换的值

    \n
  2. \n
\n

返回值 (string)

\n

返回字符串

\n
\n

示例

\n
_.toString(null);\n// => ''\n\n_.toString(-0);\n// => '-0'\n\n_.toString([1, 2, 3]);\n// => '1,2,3'\n
\n
\n
\n\n
" } ,{ "href":"/add", - "html":"

add source npm

\n
_.add(augend, addend)
\n\n

相加两个数

\n
\n\n

参数

\n
    \n
  1. augend (number)

    相加的第一个数

    \n
  2. \n
  3. addend (number)

    相加的第二个数

    \n
  4. \n
\n

返回值 (number)

\n

返回总和

\n
\n

示例

\n
_.add(6, 4);\n// => 10\n
\n
\n
\n\n
" } + "html":"

add source npm

\n
_.add(augend, addend)
\n\n

相加两个数

\n
\n\n

参数

\n
    \n
  1. augend (number)

    相加的第一个数

    \n
  2. \n
  3. addend (number)

    相加的第二个数

    \n
  4. \n
\n

返回值 (number)

\n

返回总和

\n
\n

示例

\n
_.add(6, 4);\n// => 10\n
\n
\n
\n\n
" } ,{ "href":"/ceil", - "html":"

ceil source npm

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

根据 precision 向上舍入 number

\n
\n\n

参数

\n
    \n
  1. number (number)

    要向上舍入的值

    \n
  2. \n
  3. [precision=0] (number)

    精度

    \n
  4. \n
\n

返回值 (number)

\n

返回向上舍入的结果

\n
\n

示例

\n
_.ceil(4.006);\n// => 5\n\n_.ceil(6.004, 2);\n// => 6.01\n\n_.ceil(6040, -2);\n// => 6100\n
\n
\n
\n\n
" } + "html":"

ceil source npm

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

根据 precision 向上舍入 number

\n
\n\n

参数

\n
    \n
  1. number (number)

    要向上舍入的值

    \n
  2. \n
  3. [precision=0] (number)

    精度

    \n
  4. \n
\n

返回值 (number)

\n

返回向上舍入的结果

\n
\n

示例

\n
_.ceil(4.006);\n// => 5\n\n_.ceil(6.004, 2);\n// => 6.01\n\n_.ceil(6040, -2);\n// => 6100\n
\n
\n
\n\n
" } ,{ "href":"/floor", - "html":"

floor source npm

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

根据 precision 向下保留 number

\n
\n\n

参数

\n
    \n
  1. number (number)

    要向下保留的数

    \n
  2. \n
  3. [precision=0] (number)

    精度

    \n
  4. \n
\n

返回值 (number)

\n

返回向下保留的结果

\n
\n

示例

\n
_.floor(4.006);\n// => 4\n\n_.floor(0.046, 2);\n// => 0.04\n\n_.floor(4060, -2);\n// => 4000\n
\n
\n
\n\n
" } + "html":"

floor source npm

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

根据 precision 向下保留 number

\n
\n\n

参数

\n
    \n
  1. number (number)

    要向下保留的数

    \n
  2. \n
  3. [precision=0] (number)

    精度

    \n
  4. \n
\n

返回值 (number)

\n

返回向下保留的结果

\n
\n

示例

\n
_.floor(4.006);\n// => 4\n\n_.floor(0.046, 2);\n// => 0.04\n\n_.floor(4060, -2);\n// => 4000\n
\n
\n
\n\n
" } ,{ "href":"/max", - "html":"

max source npm

\n
_.max(array)
\n\n

计算 array 中最大的值。\n如果 array 是 空的或者假值将会返回 undefined。

\n
\n\n

参数

\n
    \n
  1. array (Array)

    要计算的数组

    \n
  2. \n
\n

返回值 (*)

\n

返回最大的值

\n
\n

示例

\n
_.max([4, 2, 8, 6]);\n// => 8\n\n_.max([]);\n// => undefined\n
\n
\n
\n\n
" } + "html":"

max source npm

\n
_.max(array)
\n\n

计算 array 中最大的值。\n如果 array 是 空的或者假值将会返回 undefined。

\n
\n\n

参数

\n
    \n
  1. array (Array)

    要计算的数组

    \n
  2. \n
\n

返回值 (*)

\n

返回最大的值

\n
\n

示例

\n
_.max([4, 2, 8, 6]);\n// => 8\n\n_.max([]);\n// => undefined\n
\n
\n
\n\n
" } ,{ "href":"/maxBy", - "html":"

maxBy source npm

\n
_.maxBy(array, [iteratee=_.identity])
\n\n

这个方法类似 _.max \n除了它接受 iteratee 调用每一个元素,根据返回的 value 决定排序准则。 \niteratee 会传入1个参数:(value)。

\n
\n\n

参数

\n
    \n
  1. array (Array)

    要遍历的数组

    \n
  2. \n
  3. [iteratee=_.identity] (Function|Object|string)

    这个函数会处理每一个元素

    \n
  4. \n
\n

返回值 (*)

\n

返回最大值

\n
\n

示例

\n
var users = [\n  { 'user': 'barney', 'age': 36 },\n  { 'user': 'fred',   'age': 40 }\n];\n\n_.maxBy(users, function(o) { return o.age; });\n// => { 'user': 'fred', 'age': 40 }\n\n// 使用了 `_.property` 的回调结果\n_.maxBy(users, 'age');\n// => { 'user': 'fred', 'age': 40 }\n
\n
\n
\n\n
" } + "html":"

maxBy source npm

\n
_.maxBy(array, [iteratee=_.identity])
\n\n

这个方法类似 _.max \n除了它接受 iteratee 调用每一个元素,根据返回的 value 决定排序准则。 \niteratee 会传入1个参数:(value)。

\n
\n\n

参数

\n
    \n
  1. array (Array)

    要遍历的数组

    \n
  2. \n
  3. [iteratee=_.identity] (Function|Object|string)

    这个函数会处理每一个元素

    \n
  4. \n
\n

返回值 (*)

\n

返回最大值

\n
\n

示例

\n
var users = [\n  { 'user': 'barney', 'age': 36 },\n  { 'user': 'fred',   'age': 40 }\n];\n\n_.maxBy(users, function(o) { return o.age; });\n// => { 'user': 'fred', 'age': 40 }\n\n// 使用了 `_.property` 的回调结果\n_.maxBy(users, 'age');\n// => { 'user': 'fred', 'age': 40 }\n
\n
\n
\n\n
" } ,{ "href":"/mean", - "html":"

mean source npm

\n
_.mean(array)
\n\n

计算 array 的平均值。

\n
\n\n

参数

\n
    \n
  1. array (Array)

    要遍历的数组

    \n
  2. \n
\n

返回值 (number)

\n

返回平均值

\n
\n

示例

\n
_.mean([4, 2, 8, 6]);\n// => 5\n
\n
\n
\n\n
" } + "html":"

mean source npm

\n
_.mean(array)
\n\n

计算 array 的平均值。

\n
\n\n

参数

\n
    \n
  1. array (Array)

    要遍历的数组

    \n
  2. \n
\n

返回值 (number)

\n

返回平均值

\n
\n

示例

\n
_.mean([4, 2, 8, 6]);\n// => 5\n
\n
\n
\n\n
" } ,{ "href":"/min", - "html":"

min source npm

\n
_.min(array)
\n\n

计算 array 中最小的值。 如果 array 是 空的或者假值将会返回 undefined。

\n
\n\n

参数

\n
    \n
  1. array (Array)

    要计算的数组

    \n
  2. \n
\n

返回值 (*)

\n

返回最小值

\n
\n

示例

\n
_.min([4, 2, 8, 6]);\n// => 2\n\n_.min([]);\n// => undefined\n
\n
\n
\n\n
" } + "html":"

min source npm

\n
_.min(array)
\n\n

计算 array 中最小的值。 如果 array 是 空的或者假值将会返回 undefined。

\n
\n\n

参数

\n
    \n
  1. array (Array)

    要计算的数组

    \n
  2. \n
\n

返回值 (*)

\n

返回最小值

\n
\n

示例

\n
_.min([4, 2, 8, 6]);\n// => 2\n\n_.min([]);\n// => undefined\n
\n
\n
\n\n
" } ,{ "href":"/minBy", - "html":"

minBy source npm

\n
_.minBy(array, [iteratee=_.identity])
\n\n

这个方法类似 _.min。\n除了它接受 iteratee 调用每一个元素,根据返回的 value 决定排序准则。 iteratee 会传入1个参数:(value)。

\n
\n\n

参数

\n
    \n
  1. array (Array)

    要遍历的数组

    \n
  2. \n
  3. [iteratee=_.identity] (Function|Object|string)

    这个函数会处理每一个元素

    \n
  4. \n
\n

返回值 (*)

\n

返回最小值

\n
\n

示例

\n
var users = [\n  { 'user': 'barney', 'age': 36 },\n  { 'user': 'fred',   'age': 40 }\n];\n\n_.minBy(users, function(o) { return o.age; });\n// => { 'user': 'barney', 'age': 36 }\n\n// 使用了 `_.property` 的回调结果\n_.minBy(users, 'age');\n// => { 'user': 'barney', 'age': 36 }\n
\n
\n
\n\n
" } + "html":"

minBy source npm

\n
_.minBy(array, [iteratee=_.identity])
\n\n

这个方法类似 _.min。\n除了它接受 iteratee 调用每一个元素,根据返回的 value 决定排序准则。 iteratee 会传入1个参数:(value)。

\n
\n\n

参数

\n
    \n
  1. array (Array)

    要遍历的数组

    \n
  2. \n
  3. [iteratee=_.identity] (Function|Object|string)

    这个函数会处理每一个元素

    \n
  4. \n
\n

返回值 (*)

\n

返回最小值

\n
\n

示例

\n
var users = [\n  { 'user': 'barney', 'age': 36 },\n  { 'user': 'fred',   'age': 40 }\n];\n\n_.minBy(users, function(o) { return o.age; });\n// => { 'user': 'barney', 'age': 36 }\n\n// 使用了 `_.property` 的回调结果\n_.minBy(users, 'age');\n// => { 'user': 'barney', 'age': 36 }\n
\n
\n
\n\n
" } ,{ "href":"/round", - "html":"

round source npm

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

根据 precision 四舍五入 number。

\n
\n\n

参数

\n
    \n
  1. number (number)

    要四舍五入的值

    \n
  2. \n
  3. [precision=0] (number)

    精度

    \n
  4. \n
\n

返回值 (number)

\n

返回四舍五入的结果

\n
\n

示例

\n
_.round(4.006);\n// => 4\n\n_.round(4.006, 2);\n// => 4.01\n\n_.round(4060, -2);\n// => 4100\n
\n
\n
\n\n
" } + "html":"

round source npm

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

根据 precision 四舍五入 number。

\n
\n\n

参数

\n
    \n
  1. number (number)

    要四舍五入的值

    \n
  2. \n
  3. [precision=0] (number)

    精度

    \n
  4. \n
\n

返回值 (number)

\n

返回四舍五入的结果

\n
\n

示例

\n
_.round(4.006);\n// => 4\n\n_.round(4.006, 2);\n// => 4.01\n\n_.round(4060, -2);\n// => 4100\n
\n
\n
\n\n
" } ,{ "href":"/subtract", - "html":"

subtract source npm

\n
_.subtract(minuend, subtrahend)
\n\n

两双相减

\n
\n\n

参数

\n
    \n
  1. minuend (number)

    相减的第一个数

    \n
  2. \n
  3. subtrahend (number)

    相减的第二个数

    \n
  4. \n
\n

返回值 (number)

\n

返回结果

\n
\n

示例

\n
_.subtract(6, 4);\n// => 2\n
\n
\n
\n\n
" } + "html":"

subtract source npm

\n
_.subtract(minuend, subtrahend)
\n\n

两双相减

\n
\n\n

参数

\n
    \n
  1. minuend (number)

    相减的第一个数

    \n
  2. \n
  3. subtrahend (number)

    相减的第二个数

    \n
  4. \n
\n

返回值 (number)

\n

返回结果

\n
\n

示例

\n
_.subtract(6, 4);\n// => 2\n
\n
\n
\n\n
" } ,{ "href":"/sum", - "html":"

sum source npm

\n
_.sum(array)
\n\n

计算 array 中值的总和

\n
\n\n

参数

\n
    \n
  1. array (Array)

    要遍历的数组

    \n
  2. \n
\n

返回值 (number)

\n

返回总和

\n
\n

示例

\n
_.sum([4, 2, 8, 6]);\n// => 20\n
\n
\n
\n\n
" } + "html":"

sum source npm

\n
_.sum(array)
\n\n

计算 array 中值的总和

\n
\n\n

参数

\n
    \n
  1. array (Array)

    要遍历的数组

    \n
  2. \n
\n

返回值 (number)

\n

返回总和

\n
\n

示例

\n
_.sum([4, 2, 8, 6]);\n// => 20\n
\n
\n
\n\n
" } ,{ "href":"/sumBy", - "html":"

sumBy source npm

\n
_.sumBy(array, [iteratee=_.identity])
\n\n

这个方法类似 _.sum。\n除了它接受 iteratee 调用每一个元素,根据返回的 value 决定如何计算。 \niteratee 会传入1个参数:(value)。

\n
\n\n

参数

\n
    \n
  1. array (Array)

    要遍历的数组

    \n
  2. \n
  3. [iteratee=_.identity] (Function|Object|string)

    这个函数会处理每一个元素

    \n
  4. \n
\n

返回值 (number)

\n

返回总和

\n
\n

示例

\n
var objects = [{ 'n': 4 }, { 'n': 2 }, { 'n': 8 }, { 'n': 6 }];\n\n_.sumBy(objects, function(o) { return o.n; });\n// => 20\n\n// 使用了 `_.property` 的回调结果\n_.sumBy(objects, 'n');\n// => 20\n
\n
\n
\n\n
" } + "html":"

sumBy source npm

\n
_.sumBy(array, [iteratee=_.identity])
\n\n

这个方法类似 _.sum。\n除了它接受 iteratee 调用每一个元素,根据返回的 value 决定如何计算。 \niteratee 会传入1个参数:(value)。

\n
\n\n

参数

\n
    \n
  1. array (Array)

    要遍历的数组

    \n
  2. \n
  3. [iteratee=_.identity] (Function|Object|string)

    这个函数会处理每一个元素

    \n
  4. \n
\n

返回值 (number)

\n

返回总和

\n
\n

示例

\n
var objects = [{ 'n': 4 }, { 'n': 2 }, { 'n': 8 }, { 'n': 6 }];\n\n_.sumBy(objects, function(o) { return o.n; });\n// => 20\n\n// 使用了 `_.property` 的回调结果\n_.sumBy(objects, 'n');\n// => 20\n
\n
\n
\n\n
" } ,{ "href":"/stringSize", "html":"

stringSize source

\n
stringSize(string)
\n\n

获得字符串的长度

\n
\n\n

参数

\n
    \n
  1. string (string)

    要处理的字符串

    \n
  2. \n
\n

返回值 (number)

\n

返回字符串长度

\n
\n
\n\n
" } ,{ "href":"/templateSettings-imports-_", "html":"

templateSettings.imports._ source

\n
_.templateSettings.imports._
\n\n

lodash 函数的引用

\n
\n\n
\n\n
" } ,{ "href":"/clamp", - "html":"

clamp source npm

\n
_.clamp(number, [min], max)
\n\n

返回限制在 minmax 之间的值

\n
\n\n

参数

\n
    \n
  1. number (number)

    被限制的值

    \n
  2. \n
  3. [min] (number)

    最小绝对值

    \n
  4. \n
  5. max (number)

    最大绝对值

    \n
  6. \n
\n

返回值 (number)

\n

[min, max] 中的一个

\n
\n

示例

\n
_.clamp(-10, -5, 5);\n// => -5\n\n_.clamp(10, -5, 5);\n// => 5\n
\n
\n
\n\n
" } + "html":"

clamp source npm

\n
_.clamp(number, [min], max)
\n\n

返回限制在 minmax 之间的值

\n
\n\n

参数

\n
    \n
  1. number (number)

    被限制的值

    \n
  2. \n
  3. [min] (number)

    最小绝对值

    \n
  4. \n
  5. max (number)

    最大绝对值

    \n
  6. \n
\n

返回值 (number)

\n

[min, max] 中的一个

\n
\n

示例

\n
_.clamp(-10, -5, 5);\n// => -5\n\n_.clamp(10, -5, 5);\n// => 5\n
\n
\n
\n\n
" } ,{ "href":"/inRange", - "html":"

inRange source npm

\n
_.inRange(number, [start=0], end)
\n\n

检查 n 是否在 startend 之间,但不包括 end。\n如果 end 没有指定,那么 start 设置为0。\n如果 start 大于 end,那么参数会交换以便支持负范围。

\n
\n\n

参数

\n
    \n
  1. number (number)

    要检查的值

    \n
  2. \n
  3. [start=0] (number)

    开始范围

    \n
  4. \n
  5. end (number)

    结束范围

    \n
  6. \n
\n

返回值 (boolean)

\n

如果值在范围内返回true,否则返回 false

\n
\n

示例

\n
_.inRange(3, 2, 4);\n// => true\n\n_.inRange(4, 8);\n// => true\n\n_.inRange(4, 2);\n// => false\n\n_.inRange(2, 2);\n// => false\n\n_.inRange(1.2, 2);\n// => true\n\n_.inRange(5.2, 4);\n// => false\n\n_.inRange(-3, -2, -6);\n// => true\n
\n
\n
\n\n
" } + "html":"

inRange source npm

\n
_.inRange(number, [start=0], end)
\n\n

检查 n 是否在 startend 之间,但不包括 end。\n如果 end 没有指定,那么 start 设置为0。\n如果 start 大于 end,那么参数会交换以便支持负范围。

\n
\n\n

参数

\n
    \n
  1. number (number)

    要检查的值

    \n
  2. \n
  3. [start=0] (number)

    开始范围

    \n
  4. \n
  5. end (number)

    结束范围

    \n
  6. \n
\n

返回值 (boolean)

\n

如果值在范围内返回true,否则返回 false

\n
\n

示例

\n
_.inRange(3, 2, 4);\n// => true\n\n_.inRange(4, 8);\n// => true\n\n_.inRange(4, 2);\n// => false\n\n_.inRange(2, 2);\n// => false\n\n_.inRange(1.2, 2);\n// => true\n\n_.inRange(5.2, 4);\n// => false\n\n_.inRange(-3, -2, -6);\n// => true\n
\n
\n
\n\n
" } ,{ "href":"/random", - "html":"

random source npm

\n
_.random([min=0], [max=1], [floating])
\n\n

产生一个包括 minmax 之间的数。\n如果只提供一个参数返回一个0到提供数之间的数。\n如果 floating 设为 true,或者 minmax 是浮点数,结果返回浮点数。\n
\n
\n注意: JavaScript 遵循 IEEE-754 标准处理无法预料的浮点数结果。

\n
\n\n

参数

\n
    \n
  1. [min=0] (number)

    最小值

    \n
  2. \n
  3. [max=1] (number)

    最大值

    \n
  4. \n
  5. [floating] (boolean)

    是否返回浮点数

    \n
  6. \n
\n

返回值 (number)

\n

返回随机数

\n
\n

示例

\n
_.random(0, 5);\n// =>  0 和 5 之间的数\n\n_.random(5);\n// => 同样是 0 和 5 之间的数\n\n_.random(5, true);\n// => 0 和 5 之间的浮点数\n\n_.random(1.2, 5.2);\n// =>  1.2 和 5.2 之间的浮点数\n
\n
\n
\n\n
" } + "html":"

random source npm

\n
_.random([min=0], [max=1], [floating])
\n\n

产生一个包括 minmax 之间的数。\n如果只提供一个参数返回一个0到提供数之间的数。\n如果 floating 设为 true,或者 minmax 是浮点数,结果返回浮点数。\n
\n
\n注意: JavaScript 遵循 IEEE-754 标准处理无法预料的浮点数结果。

\n
\n\n

参数

\n
    \n
  1. [min=0] (number)

    最小值

    \n
  2. \n
  3. [max=1] (number)

    最大值

    \n
  4. \n
  5. [floating] (boolean)

    是否返回浮点数

    \n
  6. \n
\n

返回值 (number)

\n

返回随机数

\n
\n

示例

\n
_.random(0, 5);\n// =>  0 和 5 之间的数\n\n_.random(5);\n// => 同样是 0 和 5 之间的数\n\n_.random(5, true);\n// => 0 和 5 之间的浮点数\n\n_.random(1.2, 5.2);\n// =>  1.2 和 5.2 之间的浮点数\n
\n
\n
\n\n
" } ,{ "href":"/assign", - "html":"

assign source npm

\n
_.assign(object, [sources])
\n\n

分配来源对象的可枚举属性到目标对象上。\n来源对象的应用规则是从左到右,随后的下一个对象的属性会覆盖上一个对象的属性。\n
\n
\n注意: 这方法会改变源对象,参考自\nObject.assign.

\n
\n\n

参数

\n
    \n
  1. object (Object)

    目标对象

    \n
  2. \n
  3. [sources] (...Object)

    来源对象

    \n
  4. \n
\n

返回值 (Object)

\n

返回对象

\n
\n

示例

\n
function Foo() {\n  this.c = 3;\n}\n\nfunction Bar() {\n  this.e = 5;\n}\n\nFoo.prototype.d = 4;\nBar.prototype.f = 6;\n\n_.assign({ 'a': 1 }, new Foo, new Bar);\n// => { 'a': 1, 'c': 3, 'e': 5 }\n
\n
\n
\n\n
" } + "html":"

assign source npm

\n
_.assign(object, [sources])
\n\n

分配来源对象的可枚举属性到目标对象上。\n来源对象的应用规则是从左到右,随后的下一个对象的属性会覆盖上一个对象的属性。\n
\n
\n注意: 这方法会改变源对象,参考自\nObject.assign.

\n
\n\n

参数

\n
    \n
  1. object (Object)

    目标对象

    \n
  2. \n
  3. [sources] (...Object)

    来源对象

    \n
  4. \n
\n

返回值 (Object)

\n

返回对象

\n
\n

示例

\n
function Foo() {\n  this.c = 3;\n}\n\nfunction Bar() {\n  this.e = 5;\n}\n\nFoo.prototype.d = 4;\nBar.prototype.f = 6;\n\n_.assign({ 'a': 1 }, new Foo, new Bar);\n// => { 'a': 1, 'c': 3, 'e': 5 }\n
\n
\n
\n\n
" } ,{ "href":"/assignIn", - "html":"

assignIn extend source npm

\n
_.assignIn(object, [sources])
\n\n

这个方法类似 _.assign。\n除了它会遍历并继承来源对象的属性。\n
\n
\n注意: 这方法会改变源对象

\n
\n\n

参数

\n
    \n
  1. object (Object)

    目标对象

    \n
  2. \n
  3. [sources] (...Object)

    来源对象

    \n
  4. \n
\n

返回值 (Object)

\n

返回对象

\n
\n

示例

\n
function Foo() {\n  this.b = 2;\n}\n\nfunction Bar() {\n  this.d = 4;\n}\n\nFoo.prototype.c = 3;\nBar.prototype.e = 5;\n\n_.assignIn({ 'a': 1 }, new Foo, new Bar);\n// => { 'a': 1, 'b': 2, 'c': 3, 'd': 4, 'e': 5 }\n
\n
\n
\n\n
" } + "html":"

assignIn extend source npm

\n
_.assignIn(object, [sources])
\n\n

这个方法类似 _.assign。\n除了它会遍历并继承来源对象的属性。\n
\n
\n注意: 这方法会改变源对象

\n
\n\n

参数

\n
    \n
  1. object (Object)

    目标对象

    \n
  2. \n
  3. [sources] (...Object)

    来源对象

    \n
  4. \n
\n

返回值 (Object)

\n

返回对象

\n
\n

示例

\n
function Foo() {\n  this.b = 2;\n}\n\nfunction Bar() {\n  this.d = 4;\n}\n\nFoo.prototype.c = 3;\nBar.prototype.e = 5;\n\n_.assignIn({ 'a': 1 }, new Foo, new Bar);\n// => { 'a': 1, 'b': 2, 'c': 3, 'd': 4, 'e': 5 }\n
\n
\n
\n\n
" } ,{ "href":"/assignInWith", - "html":"

assignInWith extendWith source npm

\n
_.assignInWith(object, sources, [customizer])
\n\n

这个方法类似 _.assignIn。\n除了它接受一个 customizer决定如何分配值。\n如果customizer返回undefined将会由分配处理方法代替。customizer` 会传入5个参数:(objValue, srcValue, key, object, source)。\n
\n
\n注意: 这方法会改变源对象

\n
\n\n

参数

\n
    \n
  1. object (Object)

    目标对象

    \n
  2. \n
  3. sources (...Object)

    来源对象

    \n
  4. \n
  5. [customizer] (Function)

    这个函数决定分配的值

    \n
  6. \n
\n

返回值 (Object)

\n

返回对象

\n
\n

示例

\n
function customizer(objValue, srcValue) {\n  return _.isUndefined(objValue) ? srcValue : objValue;\n}\n\nvar defaults = _.partialRight(_.assignInWith, customizer);\n\ndefaults({ 'a': 1 }, { 'b': 2 }, { 'a': 3 });\n// => { 'a': 1, 'b': 2 }\n
\n
\n
\n\n
" } + "html":"

assignInWith extendWith source npm

\n
_.assignInWith(object, sources, [customizer])
\n\n

这个方法类似 _.assignIn。\n除了它接受一个 customizer决定如何分配值。\n如果customizer返回undefined将会由分配处理方法代替。customizer` 会传入5个参数:(objValue, srcValue, key, object, source)。\n
\n
\n注意: 这方法会改变源对象

\n
\n\n

参数

\n
    \n
  1. object (Object)

    目标对象

    \n
  2. \n
  3. sources (...Object)

    来源对象

    \n
  4. \n
  5. [customizer] (Function)

    这个函数决定分配的值

    \n
  6. \n
\n

返回值 (Object)

\n

返回对象

\n
\n

示例

\n
function customizer(objValue, srcValue) {\n  return _.isUndefined(objValue) ? srcValue : objValue;\n}\n\nvar defaults = _.partialRight(_.assignInWith, customizer);\n\ndefaults({ 'a': 1 }, { 'b': 2 }, { 'a': 3 });\n// => { 'a': 1, 'b': 2 }\n
\n
\n
\n\n
" } ,{ "href":"/assignWith", - "html":"

assignWith source npm

\n
_.assignWith(object, sources, [customizer])
\n\n

这个方法类似 _.assign。\n除了它接受一个 customizer决定如何分配值。\n如果customizer返回undefined将会由分配处理方法代替。customizer` 会传入5个参数:(objValue, srcValue, key, object, source)。\n
\n
\n注意: 这方法会改变源对象

\n
\n\n

参数

\n
    \n
  1. object (Object)

    目标对象

    \n
  2. \n
  3. sources (...Object)

    来源对象

    \n
  4. \n
  5. [customizer] (Function)

    这个函数决定分配的值

    \n
  6. \n
\n

返回值 (Object)

\n

返回对象

\n
\n

示例

\n
function customizer(objValue, srcValue) {\n  return _.isUndefined(objValue) ? srcValue : objValue;\n}\n\nvar defaults = _.partialRight(_.assignWith, customizer);\n\ndefaults({ 'a': 1 }, { 'b': 2 }, { 'a': 3 });\n// => { 'a': 1, 'b': 2 }\n
\n
\n
\n\n
" } + "html":"

assignWith source npm

\n
_.assignWith(object, sources, [customizer])
\n\n

这个方法类似 _.assign。\n除了它接受一个 customizer决定如何分配值。\n如果customizer返回undefined将会由分配处理方法代替。customizer` 会传入5个参数:(objValue, srcValue, key, object, source)。\n
\n
\n注意: 这方法会改变源对象

\n
\n\n

参数

\n
    \n
  1. object (Object)

    目标对象

    \n
  2. \n
  3. sources (...Object)

    来源对象

    \n
  4. \n
  5. [customizer] (Function)

    这个函数决定分配的值

    \n
  6. \n
\n

返回值 (Object)

\n

返回对象

\n
\n

示例

\n
function customizer(objValue, srcValue) {\n  return _.isUndefined(objValue) ? srcValue : objValue;\n}\n\nvar defaults = _.partialRight(_.assignWith, customizer);\n\ndefaults({ 'a': 1 }, { 'b': 2 }, { 'a': 3 });\n// => { 'a': 1, 'b': 2 }\n
\n
\n
\n\n
" } ,{ "href":"/at", - "html":"

at source npm

\n
_.at(object, [paths])
\n\n

根据 object 的路径获取值为数组。

\n
\n\n

参数

\n
    \n
  1. object (Object)

    要遍历的对象

    \n
  2. \n
  3. [paths] (...(string|string[])

    要获取的对象的元素路径,单独指定或者指定在数组中

    \n
  4. \n
\n

返回值 (Array)

\n

返回选中值的数组

\n
\n

示例

\n
var object = { 'a': [{ 'b': { 'c': 3 } }, 4] };\n\n_.at(object, ['a[0].b.c', 'a[1]']);\n// => [3, 4]\n\n_.at(['a', 'b', 'c'], 0, 2);\n// => ['a', 'c']\n
\n
\n
\n\n
" } + "html":"

at source npm

\n
_.at(object, [paths])
\n\n

根据 object 的路径获取值为数组。

\n
\n\n

参数

\n
    \n
  1. object (Object)

    要遍历的对象

    \n
  2. \n
  3. [paths] (...(string|string[])

    要获取的对象的元素路径,单独指定或者指定在数组中

    \n
  4. \n
\n

返回值 (Array)

\n

返回选中值的数组

\n
\n

示例

\n
var object = { 'a': [{ 'b': { 'c': 3 } }, 4] };\n\n_.at(object, ['a[0].b.c', 'a[1]']);\n// => [3, 4]\n\n_.at(['a', 'b', 'c'], 0, 2);\n// => ['a', 'c']\n
\n
\n
\n\n
" } ,{ "href":"/create", - "html":"

create source npm

\n
_.create(prototype, [properties])
\n\n

创建一个继承 prototype 的对象。\n如果提供了 properties,它的可枚举属性会被分配到创建的对象上。

\n
\n\n

参数

\n
    \n
  1. prototype (Object)

    要继承的对象

    \n
  2. \n
  3. [properties] (Object)

    待分配的属性

    \n
  4. \n
\n

返回值 (Object)

\n

返回新对象

\n
\n

示例

\n
function Shape() {\n  this.x = 0;\n  this.y = 0;\n}\n\nfunction Circle() {\n  Shape.call(this);\n}\n\nCircle.prototype = _.create(Shape.prototype, {\n  'constructor': Circle\n});\n\nvar circle = new Circle;\ncircle instanceof Circle;\n// => true\n\ncircle instanceof Shape;\n// => true\n
\n
\n
\n\n
" } + "html":"

create source npm

\n
_.create(prototype, [properties])
\n\n

创建一个继承 prototype 的对象。\n如果提供了 properties,它的可枚举属性会被分配到创建的对象上。

\n
\n\n

参数

\n
    \n
  1. prototype (Object)

    要继承的对象

    \n
  2. \n
  3. [properties] (Object)

    待分配的属性

    \n
  4. \n
\n

返回值 (Object)

\n

返回新对象

\n
\n

示例

\n
function Shape() {\n  this.x = 0;\n  this.y = 0;\n}\n\nfunction Circle() {\n  Shape.call(this);\n}\n\nCircle.prototype = _.create(Shape.prototype, {\n  'constructor': Circle\n});\n\nvar circle = new Circle;\ncircle instanceof Circle;\n// => true\n\ncircle instanceof Shape;\n// => true\n
\n
\n
\n\n
" } ,{ "href":"/defaults", - "html":"

defaults source npm

\n
_.defaults(object, [sources])
\n\n

分配来源对象的可枚举属性到目标对象所有解析为 undefined 的属性上。\n来源对象从左到右应用。\n一旦设置了相同属性的值,后续的将被忽略掉。\n
\n
\n注意: 这方法会改变源对象

\n
\n\n

参数

\n
    \n
  1. object (Object)

    目标对象

    \n
  2. \n
  3. [sources] (...Object)

    来源对象

    \n
  4. \n
\n

返回值 (Object)

\n

返回对象

\n
\n

示例

\n
_.defaults({ 'user': 'barney' }, { 'age': 36 }, { 'user': 'fred' });\n// => { 'user': 'barney', 'age': 36 }\n
\n
\n
\n\n
" } + "html":"

defaults source npm

\n
_.defaults(object, [sources])
\n\n

分配来源对象的可枚举属性到目标对象所有解析为 undefined 的属性上。\n来源对象从左到右应用。\n一旦设置了相同属性的值,后续的将被忽略掉。\n
\n
\n注意: 这方法会改变源对象

\n
\n\n

参数

\n
    \n
  1. object (Object)

    目标对象

    \n
  2. \n
  3. [sources] (...Object)

    来源对象

    \n
  4. \n
\n

返回值 (Object)

\n

返回对象

\n
\n

示例

\n
_.defaults({ 'user': 'barney' }, { 'age': 36 }, { 'user': 'fred' });\n// => { 'user': 'barney', 'age': 36 }\n
\n
\n
\n\n
" } ,{ "href":"/defaultsDeep", - "html":"

defaultsDeep source npm

\n
_.defaultsDeep(object, [sources])
\n\n

这个方法类似 _.defaults,除了它会递归分配默认属性。\n
\n
\n注意: 这方法会改变源对象

\n
\n\n

参数

\n
    \n
  1. object (Object)

    目标对象

    \n
  2. \n
  3. [sources] (...Object)

    来源对象

    \n
  4. \n
\n

返回值 (Object)

\n

返回对象

\n
\n

示例

\n
_.defaultsDeep({ 'user': { 'name': 'barney' } }, { 'user': { 'name': 'fred', 'age': 36 } });\n// => { 'user': { 'name': 'barney', 'age': 36 } }\n
\n
\n
\n\n
" } + "html":"

defaultsDeep source npm

\n
_.defaultsDeep(object, [sources])
\n\n

这个方法类似 _.defaults,除了它会递归分配默认属性。\n
\n
\n注意: 这方法会改变源对象

\n
\n\n

参数

\n
    \n
  1. object (Object)

    目标对象

    \n
  2. \n
  3. [sources] (...Object)

    来源对象

    \n
  4. \n
\n

返回值 (Object)

\n

返回对象

\n
\n

示例

\n
_.defaultsDeep({ 'user': { 'name': 'barney' } }, { 'user': { 'name': 'fred', 'age': 36 } });\n// => { 'user': { 'name': 'barney', 'age': 36 } }\n
\n
\n
\n\n
" } ,{ "href":"/findKey", - "html":"

findKey source npm

\n
_.findKey(object, [predicate=_.identity])
\n\n

这个方法类似 _.find。\n除了它返回最先被 predicate 判断为真值的元素 key,而不是元素本身。

\n
\n\n

参数

\n
    \n
  1. object (Object)

    需要检索的对象

    \n
  2. \n
  3. [predicate=_.identity] (Function|Object|string)

    这个函数会处理每一个元素

    \n
  4. \n
\n

返回值 (string|undefined)

\n

返回匹配的 key,否则返回 undefined

\n
\n

示例

\n
var users = {\n  'barney':  { 'age': 36, 'active': true },\n  'fred':    { 'age': 40, 'active': false },\n  'pebbles': { 'age': 1,  'active': true }\n};\n\n_.findKey(users, function(o) { return o.age < 40; });\n// => 'barney' (无法保证遍历的顺序)\n\n// 使用了 `_.matches` 的回调结果\n_.findKey(users, { 'age': 1, 'active': true });\n// => 'pebbles'\n\n// 使用了 `_.matchesProperty` 的回调结果\n_.findKey(users, ['active', false]);\n// => 'fred'\n\n// 使用了 `_.property` 的回调结果\n_.findKey(users, 'active');\n// => 'barney'\n
\n
\n
\n\n
" } + "html":"

findKey source npm

\n
_.findKey(object, [predicate=_.identity])
\n\n

这个方法类似 _.find。\n除了它返回最先被 predicate 判断为真值的元素 key,而不是元素本身。

\n
\n\n

参数

\n
    \n
  1. object (Object)

    需要检索的对象

    \n
  2. \n
  3. [predicate=_.identity] (Function|Object|string)

    这个函数会处理每一个元素

    \n
  4. \n
\n

返回值 (string|undefined)

\n

返回匹配的 key,否则返回 undefined

\n
\n

示例

\n
var users = {\n  'barney':  { 'age': 36, 'active': true },\n  'fred':    { 'age': 40, 'active': false },\n  'pebbles': { 'age': 1,  'active': true }\n};\n\n_.findKey(users, function(o) { return o.age < 40; });\n// => 'barney' (无法保证遍历的顺序)\n\n// 使用了 `_.matches` 的回调结果\n_.findKey(users, { 'age': 1, 'active': true });\n// => 'pebbles'\n\n// 使用了 `_.matchesProperty` 的回调结果\n_.findKey(users, ['active', false]);\n// => 'fred'\n\n// 使用了 `_.property` 的回调结果\n_.findKey(users, 'active');\n// => 'barney'\n
\n
\n
\n\n
" } ,{ "href":"/findLastKey", - "html":"

findLastKey source npm

\n
_.findLastKey(object, [predicate=_.identity])
\n\n

这个方法类似 _.findKey。\n不过它是反方向开始遍历的。

\n
\n\n

参数

\n
    \n
  1. object (Object)

    需要检索的对象

    \n
  2. \n
  3. [predicate=_.identity] (Function|Object|string)

    这个函数会处理每一个元素

    \n
  4. \n
\n

返回值 (string|undefined)

\n

返回匹配的 key,否则返回 undefined

\n
\n

示例

\n
var users = {\n  'barney':  { 'age': 36, 'active': true },\n  'fred':    { 'age': 40, 'active': false },\n  'pebbles': { 'age': 1,  'active': true }\n};\n\n_.findLastKey(users, function(o) { return o.age < 40; });\n// => 返回 'pebbles', `_.findKey` 会返回 'barney'\n\n// 使用了 `_.matches` 的回调结果\n_.findLastKey(users, { 'age': 36, 'active': true });\n// => 'barney'\n\n// 使用了 `_.matchesProperty` 的回调结果\n_.findLastKey(users, ['active', false]);\n// => 'fred'\n\n// 使用了 `_.property` 的回调结果\n_.findLastKey(users, 'active');\n// => 'pebbles'\n
\n
\n
\n\n
" } + "html":"

findLastKey source npm

\n
_.findLastKey(object, [predicate=_.identity])
\n\n

这个方法类似 _.findKey。\n不过它是反方向开始遍历的。

\n
\n\n

参数

\n
    \n
  1. object (Object)

    需要检索的对象

    \n
  2. \n
  3. [predicate=_.identity] (Function|Object|string)

    这个函数会处理每一个元素

    \n
  4. \n
\n

返回值 (string|undefined)

\n

返回匹配的 key,否则返回 undefined

\n
\n

示例

\n
var users = {\n  'barney':  { 'age': 36, 'active': true },\n  'fred':    { 'age': 40, 'active': false },\n  'pebbles': { 'age': 1,  'active': true }\n};\n\n_.findLastKey(users, function(o) { return o.age < 40; });\n// => 返回 'pebbles', `_.findKey` 会返回 'barney'\n\n// 使用了 `_.matches` 的回调结果\n_.findLastKey(users, { 'age': 36, 'active': true });\n// => 'barney'\n\n// 使用了 `_.matchesProperty` 的回调结果\n_.findLastKey(users, ['active', false]);\n// => 'fred'\n\n// 使用了 `_.property` 的回调结果\n_.findLastKey(users, 'active');\n// => 'pebbles'\n
\n
\n
\n\n
" } ,{ "href":"/forIn", - "html":"

forIn source npm

\n
_.forIn(object, [iteratee=_.identity])
\n\n

使用 iteratee 遍历对象的自身和继承的可枚举属性。\niteratee 会传入3个参数:(value, key, object)。\n如果返回 false,iteratee 会提前退出遍历。

\n
\n\n

参数

\n
    \n
  1. object (Object)

    要遍历的对象

    \n
  2. \n
  3. [iteratee=_.identity] (Function)

    这个函数会处理每一个元素

    \n
  4. \n
\n

返回值 (Object)

\n

返回对象

\n
\n

示例

\n
function Foo() {\n  this.a = 1;\n  this.b = 2;\n}\n\nFoo.prototype.c = 3;\n\n_.forIn(new Foo, function(value, key) {\n  console.log(key);\n});\n// => 输出 'a', 'b', 然后 'c' (无法保证遍历的顺序)\n
\n
\n
\n\n
" } + "html":"

forIn source npm

\n
_.forIn(object, [iteratee=_.identity])
\n\n

使用 iteratee 遍历对象的自身和继承的可枚举属性。\niteratee 会传入3个参数:(value, key, object)。\n如果返回 false,iteratee 会提前退出遍历。

\n
\n\n

参数

\n
    \n
  1. object (Object)

    要遍历的对象

    \n
  2. \n
  3. [iteratee=_.identity] (Function)

    这个函数会处理每一个元素

    \n
  4. \n
\n

返回值 (Object)

\n

返回对象

\n
\n

示例

\n
function Foo() {\n  this.a = 1;\n  this.b = 2;\n}\n\nFoo.prototype.c = 3;\n\n_.forIn(new Foo, function(value, key) {\n  console.log(key);\n});\n// => 输出 'a', 'b', 然后 'c' (无法保证遍历的顺序)\n
\n
\n
\n\n
" } ,{ "href":"/forInRight", - "html":"

forInRight source npm

\n
_.forInRight(object, [iteratee=_.identity])
\n\n

这个方法类似 _.forIn。\n除了它是反方向开始遍历的。

\n
\n\n

参数

\n
    \n
  1. object (Object)

    要遍历的对象

    \n
  2. \n
  3. [iteratee=_.identity] (Function)

    这个函数会处理每一个元素

    \n
  4. \n
\n

返回值 (Object)

\n

返回对象

\n
\n

示例

\n
function Foo() {\n  this.a = 1;\n  this.b = 2;\n}\n\nFoo.prototype.c = 3;\n\n_.forInRight(new Foo, function(value, key) {\n  console.log(key);\n});\n// => 输出 'c', 'b', 然后 'a', `_.forIn` 会输出 'a', 'b', 然后 'c'\n
\n
\n
\n\n
" } + "html":"

forInRight source npm

\n
_.forInRight(object, [iteratee=_.identity])
\n\n

这个方法类似 _.forIn。\n除了它是反方向开始遍历的。

\n
\n\n

参数

\n
    \n
  1. object (Object)

    要遍历的对象

    \n
  2. \n
  3. [iteratee=_.identity] (Function)

    这个函数会处理每一个元素

    \n
  4. \n
\n

返回值 (Object)

\n

返回对象

\n
\n

示例

\n
function Foo() {\n  this.a = 1;\n  this.b = 2;\n}\n\nFoo.prototype.c = 3;\n\n_.forInRight(new Foo, function(value, key) {\n  console.log(key);\n});\n// => 输出 'c', 'b', 然后 'a', `_.forIn` 会输出 'a', 'b', 然后 'c'\n
\n
\n
\n\n
" } ,{ "href":"/forOwn", - "html":"

forOwn source npm

\n
_.forOwn(object, [iteratee=_.identity])
\n\n

使用 iteratee 遍历自身的可枚举属性。\niteratee 会传入3个参数:(value, key, object)。 如果返回 false,iteratee 会提前退出遍历。

\n
\n\n

参数

\n
    \n
  1. object (Object)

    要遍历的对象

    \n
  2. \n
  3. [iteratee=_.identity] (Function)

    这个函数会处理每一个元素

    \n
  4. \n
\n

返回值 (Object)

\n

返回对象

\n
\n

示例

\n
function Foo() {\n  this.a = 1;\n  this.b = 2;\n}\n\nFoo.prototype.c = 3;\n\n_.forOwn(new Foo, function(value, key) {\n  console.log(key);\n});\n// => 输出 'a' 然后 'b' (无法保证遍历的顺序)\n
\n
\n
\n\n
" } + "html":"

forOwn source npm

\n
_.forOwn(object, [iteratee=_.identity])
\n\n

使用 iteratee 遍历自身的可枚举属性。\niteratee 会传入3个参数:(value, key, object)。 如果返回 false,iteratee 会提前退出遍历。

\n
\n\n

参数

\n
    \n
  1. object (Object)

    要遍历的对象

    \n
  2. \n
  3. [iteratee=_.identity] (Function)

    这个函数会处理每一个元素

    \n
  4. \n
\n

返回值 (Object)

\n

返回对象

\n
\n

示例

\n
function Foo() {\n  this.a = 1;\n  this.b = 2;\n}\n\nFoo.prototype.c = 3;\n\n_.forOwn(new Foo, function(value, key) {\n  console.log(key);\n});\n// => 输出 'a' 然后 'b' (无法保证遍历的顺序)\n
\n
\n
\n\n
" } ,{ "href":"/forOwnRight", - "html":"

forOwnRight source npm

\n
_.forOwnRight(object, [iteratee=_.identity])
\n\n

这个方法类似 _.forOwn。 除了它是反方向开始遍历的。

\n
\n\n

参数

\n
    \n
  1. object (Object)

    要遍历的对象

    \n
  2. \n
  3. [iteratee=_.identity] (Function)

    这个函数会处理每一个元素

    \n
  4. \n
\n

返回值 (Object)

\n

返回对象

\n
\n

示例

\n
function Foo() {\n  this.a = 1;\n  this.b = 2;\n}\n\nFoo.prototype.c = 3;\n\n_.forOwnRight(new Foo, function(value, key) {\n  console.log(key);\n});\n// => 输出 'b' 然后 'a', `_.forOwn` 会输出 'a' 然后 'b'\n
\n
\n
\n\n
" } + "html":"

forOwnRight source npm

\n
_.forOwnRight(object, [iteratee=_.identity])
\n\n

这个方法类似 _.forOwn。 除了它是反方向开始遍历的。

\n
\n\n

参数

\n
    \n
  1. object (Object)

    要遍历的对象

    \n
  2. \n
  3. [iteratee=_.identity] (Function)

    这个函数会处理每一个元素

    \n
  4. \n
\n

返回值 (Object)

\n

返回对象

\n
\n

示例

\n
function Foo() {\n  this.a = 1;\n  this.b = 2;\n}\n\nFoo.prototype.c = 3;\n\n_.forOwnRight(new Foo, function(value, key) {\n  console.log(key);\n});\n// => 输出 'b' 然后 'a', `_.forOwn` 会输出 'a' 然后 'b'\n
\n
\n
\n\n
" } ,{ "href":"/functions", - "html":"

functions source npm

\n
_.functions(object)
\n\n

返回一个 function 对象自身可枚举属性名的数组。

\n
\n\n

参数

\n
    \n
  1. object (Object)

    要检索的对象

    \n
  2. \n
\n

返回值 (Array)

\n

返回包含属性名的新数组

\n
\n

示例

\n
function Foo() {\n  this.a = _.constant('a');\n  this.b = _.constant('b');\n}\n\nFoo.prototype.c = _.constant('c');\n\n_.functions(new Foo);\n// => ['a', 'b']\n
\n
\n
\n\n
" } + "html":"

functions source npm

\n
_.functions(object)
\n\n

返回一个 function 对象自身可枚举属性名的数组。

\n
\n\n

参数

\n
    \n
  1. object (Object)

    要检索的对象

    \n
  2. \n
\n

返回值 (Array)

\n

返回包含属性名的新数组

\n
\n

示例

\n
function Foo() {\n  this.a = _.constant('a');\n  this.b = _.constant('b');\n}\n\nFoo.prototype.c = _.constant('c');\n\n_.functions(new Foo);\n// => ['a', 'b']\n
\n
\n
\n\n
" } ,{ "href":"/functionsIn", - "html":"

functionsIn source npm

\n
_.functionsIn(object)
\n\n

返回一个 function 对象自身和继承的可枚举属性名的数组。

\n
\n\n

参数

\n
    \n
  1. object (Object)

    要检索的对象

    \n
  2. \n
\n

返回值 (Array)

\n

返回包含属性名的新数组

\n
\n

示例

\n
function Foo() {\n  this.a = _.constant('a');\n  this.b = _.constant('b');\n}\n\nFoo.prototype.c = _.constant('c');\n\n_.functionsIn(new Foo);\n// => ['a', 'b', 'c']\n
\n
\n
\n\n
" } + "html":"

functionsIn source npm

\n
_.functionsIn(object)
\n\n

返回一个 function 对象自身和继承的可枚举属性名的数组。

\n
\n\n

参数

\n
    \n
  1. object (Object)

    要检索的对象

    \n
  2. \n
\n

返回值 (Array)

\n

返回包含属性名的新数组

\n
\n

示例

\n
function Foo() {\n  this.a = _.constant('a');\n  this.b = _.constant('b');\n}\n\nFoo.prototype.c = _.constant('c');\n\n_.functionsIn(new Foo);\n// => ['a', 'b', 'c']\n
\n
\n
\n\n
" } ,{ "href":"/get", - "html":"

get source npm

\n
_.get(object, path, [defaultValue])
\n\n

根据对象路径获取值。\n如果解析 value 是 undefined 会以 defaultValue 取代。

\n
\n\n

参数

\n
    \n
  1. object (Object)

    要检索的对象

    \n
  2. \n
  3. path (Array|string)

    要获取的对象路径

    \n
  4. \n
  5. [defaultValue] (*)

    如果解析值是 undefined,这值会被返回

    \n
  6. \n
\n

返回值 (*)

\n

返回解析的值

\n
\n

示例

\n
var object = { 'a': [{ 'b': { 'c': 3 } }] };\n\n_.get(object, 'a[0].b.c');\n// => 3\n\n_.get(object, ['a', '0', 'b', 'c']);\n// => 3\n\n_.get(object, 'a.b.c', 'default');\n// => 'default'\n
\n
\n
\n\n
" } + "html":"

get source npm

\n
_.get(object, path, [defaultValue])
\n\n

根据对象路径获取值。\n如果解析 value 是 undefined 会以 defaultValue 取代。

\n
\n\n

参数

\n
    \n
  1. object (Object)

    要检索的对象

    \n
  2. \n
  3. path (Array|string)

    要获取的对象路径

    \n
  4. \n
  5. [defaultValue] (*)

    如果解析值是 undefined,这值会被返回

    \n
  6. \n
\n

返回值 (*)

\n

返回解析的值

\n
\n

示例

\n
var object = { 'a': [{ 'b': { 'c': 3 } }] };\n\n_.get(object, 'a[0].b.c');\n// => 3\n\n_.get(object, ['a', '0', 'b', 'c']);\n// => 3\n\n_.get(object, 'a.b.c', 'default');\n// => 'default'\n
\n
\n
\n\n
" } ,{ "href":"/has", - "html":"

has source npm

\n
_.has(object, path)
\n\n

检查 path 是否是对象的直接属性。

\n
\n\n

参数

\n
    \n
  1. object (Object)

    要检索的对象

    \n
  2. \n
  3. path (Array|string)

    要检查的路径

    \n
  4. \n
\n

返回值 (boolean)

\n

如果存在返回 true,否则返回 false

\n
\n

示例

\n
var object = { 'a': { 'b': { 'c': 3 } } };\nvar other = _.create({ 'a': _.create({ 'b': _.create({ 'c': 3 }) }) });\n\n_.has(object, 'a');\n// => true\n\n_.has(object, 'a.b.c');\n// => true\n\n_.has(object, ['a', 'b', 'c']);\n// => true\n\n_.has(other, 'a');\n// => false\n
\n
\n
\n\n
" } + "html":"

has source npm

\n
_.has(object, path)
\n\n

检查 path 是否是对象的直接属性。

\n
\n\n

参数

\n
    \n
  1. object (Object)

    要检索的对象

    \n
  2. \n
  3. path (Array|string)

    要检查的路径

    \n
  4. \n
\n

返回值 (boolean)

\n

如果存在返回 true,否则返回 false

\n
\n

示例

\n
var object = { 'a': { 'b': { 'c': 3 } } };\nvar other = _.create({ 'a': _.create({ 'b': _.create({ 'c': 3 }) }) });\n\n_.has(object, 'a');\n// => true\n\n_.has(object, 'a.b.c');\n// => true\n\n_.has(object, ['a', 'b', 'c']);\n// => true\n\n_.has(other, 'a');\n// => false\n
\n
\n
\n\n
" } ,{ "href":"/hasIn", - "html":"

hasIn source npm

\n
_.hasIn(object, path)
\n\n

检查 path 是否是对象的直接 或者 继承属性。

\n
\n\n

参数

\n
    \n
  1. object (Object)

    要检索的对象

    \n
  2. \n
  3. path (Array|string)

    要检查的路径

    \n
  4. \n
\n

返回值 (boolean)

\n

如果存在返回 true,否则返回 false

\n
\n

示例

\n
var object = _.create({ 'a': _.create({ 'b': _.create({ 'c': 3 }) }) });\n\n_.hasIn(object, 'a');\n// => true\n\n_.hasIn(object, 'a.b.c');\n// => true\n\n_.hasIn(object, ['a', 'b', 'c']);\n// => true\n\n_.hasIn(object, 'b');\n// => false\n
\n
\n
\n\n
" } + "html":"

hasIn source npm

\n
_.hasIn(object, path)
\n\n

检查 path 是否是对象的直接 或者 继承属性。

\n
\n\n

参数

\n
    \n
  1. object (Object)

    要检索的对象

    \n
  2. \n
  3. path (Array|string)

    要检查的路径

    \n
  4. \n
\n

返回值 (boolean)

\n

如果存在返回 true,否则返回 false

\n
\n

示例

\n
var object = _.create({ 'a': _.create({ 'b': _.create({ 'c': 3 }) }) });\n\n_.hasIn(object, 'a');\n// => true\n\n_.hasIn(object, 'a.b.c');\n// => true\n\n_.hasIn(object, ['a', 'b', 'c']);\n// => true\n\n_.hasIn(object, 'b');\n// => false\n
\n
\n
\n\n
" } ,{ "href":"/invert", - "html":"

invert source npm

\n
_.invert(object, [multiVal])
\n\n

创建一个键值倒置的对象。\n如果 object 有重复的值,后面的值会覆盖前面的值。\n如果 multiVal 为 true,重复的值则组成数组。

\n
\n\n

参数

\n
    \n
  1. object (Object)

    要倒置的对象

    \n
  2. \n
  3. [multiVal] (boolean)

    每个 key 允许多个值

    \n
  4. \n
\n

返回值 (Object)

\n

返回新的倒置的对象

\n
\n

示例

\n
var object = { 'a': 1, 'b': 2, 'c': 1 };\n\n_.invert(object);\n// => { '1': 'c', '2': 'b' }\n\n// 使用 `multiVal`\n_.invert(object, true);\n// => { '1': ['a', 'c'], '2': ['b'] }\n
\n
\n
\n\n
" } + "html":"

invert source npm

\n
_.invert(object, [multiVal])
\n\n

创建一个键值倒置的对象。\n如果 object 有重复的值,后面的值会覆盖前面的值。\n如果 multiVal 为 true,重复的值则组成数组。

\n
\n\n

参数

\n
    \n
  1. object (Object)

    要倒置的对象

    \n
  2. \n
  3. [multiVal] (boolean)

    每个 key 允许多个值

    \n
  4. \n
\n

返回值 (Object)

\n

返回新的倒置的对象

\n
\n

示例

\n
var object = { 'a': 1, 'b': 2, 'c': 1 };\n\n_.invert(object);\n// => { '1': 'c', '2': 'b' }\n\n// 使用 `multiVal`\n_.invert(object, true);\n// => { '1': ['a', 'c'], '2': ['b'] }\n
\n
\n
\n\n
" } ,{ "href":"/invoke", - "html":"

invoke source npm

\n
_.invoke(object, path, [args])
\n\n

调用对象路径的方法

\n
\n\n

参数

\n
    \n
  1. object (Object)

    要检索的对象

    \n
  2. \n
  3. path (Array|string)

    要调用方法的路径

    \n
  4. \n
  5. [args] (...*)

    调用方法的参数

    \n
  6. \n
\n

返回值 (*)

\n

返回调用方法的结果

\n
\n

示例

\n
var object = { 'a': [{ 'b': { 'c': [1, 2, 3, 4] } }] };\n\n_.invoke(object, 'a[0].b.c.slice', 1, 3);\n// => [2, 3]\n
\n
\n
\n\n
" } + "html":"

invoke source npm

\n
_.invoke(object, path, [args])
\n\n

调用对象路径的方法

\n
\n\n

参数

\n
    \n
  1. object (Object)

    要检索的对象

    \n
  2. \n
  3. path (Array|string)

    要调用方法的路径

    \n
  4. \n
  5. [args] (...*)

    调用方法的参数

    \n
  6. \n
\n

返回值 (*)

\n

返回调用方法的结果

\n
\n

示例

\n
var object = { 'a': [{ 'b': { 'c': [1, 2, 3, 4] } }] };\n\n_.invoke(object, 'a[0].b.c.slice', 1, 3);\n// => [2, 3]\n
\n
\n
\n\n
" } ,{ "href":"/keys", - "html":"

keys source npm

\n
_.keys(object)
\n\n

创建 object 自身可枚举属性名为一个数组。\n
\n
\n注意: 非对象的值会被强制转换为对象,查看\nES spec\n了解详情

\n
\n\n

参数

\n
    \n
  1. object (Object)

    要检索的对象

    \n
  2. \n
\n

返回值 (Array)

\n

返回包含属性名的数组

\n
\n

示例

\n
function Foo() {\n  this.a = 1;\n  this.b = 2;\n}\n\nFoo.prototype.c = 3;\n\n_.keys(new Foo);\n// => ['a', 'b'] (无法保证遍历的顺序)\n\n_.keys('hi');\n// => ['0', '1']\n
\n
\n
\n\n
" } + "html":"

keys source npm

\n
_.keys(object)
\n\n

创建 object 自身可枚举属性名为一个数组。\n
\n
\n注意: 非对象的值会被强制转换为对象,查看\nES spec\n了解详情

\n
\n\n

参数

\n
    \n
  1. object (Object)

    要检索的对象

    \n
  2. \n
\n

返回值 (Array)

\n

返回包含属性名的数组

\n
\n

示例

\n
function Foo() {\n  this.a = 1;\n  this.b = 2;\n}\n\nFoo.prototype.c = 3;\n\n_.keys(new Foo);\n// => ['a', 'b'] (无法保证遍历的顺序)\n\n_.keys('hi');\n// => ['0', '1']\n
\n
\n
\n\n
" } ,{ "href":"/keysIn", - "html":"

keysIn source npm

\n
_.keysIn(object)
\n\n

创建 object 自身 或 继承的可枚举属性名为一个数组。\n
\n
\n注意: 非对象的值会被强制转换为对象

\n
\n\n

参数

\n
    \n
  1. object (Object)

    要检索的对象

    \n
  2. \n
\n

返回值 (Array)

\n

返回包含属性名的数组

\n
\n

示例

\n
function Foo() {\n  this.a = 1;\n  this.b = 2;\n}\n\nFoo.prototype.c = 3;\n\n_.keysIn(new Foo);\n// => ['a', 'b', 'c'] (无法保证遍历的顺序)\n
\n
\n
\n\n
" } + "html":"

keysIn source npm

\n
_.keysIn(object)
\n\n

创建 object 自身 或 继承的可枚举属性名为一个数组。\n
\n
\n注意: 非对象的值会被强制转换为对象

\n
\n\n

参数

\n
    \n
  1. object (Object)

    要检索的对象

    \n
  2. \n
\n

返回值 (Array)

\n

返回包含属性名的数组

\n
\n

示例

\n
function Foo() {\n  this.a = 1;\n  this.b = 2;\n}\n\nFoo.prototype.c = 3;\n\n_.keysIn(new Foo);\n// => ['a', 'b', 'c'] (无法保证遍历的顺序)\n
\n
\n
\n\n
" } ,{ "href":"/mapKeys", - "html":"

mapKeys source npm

\n
_.mapKeys(object, [iteratee=_.identity])
\n\n

反向版 _.mapValues。\n这个方法创建一个对象,对象的值与源对象相同,但 key 是通过 iteratee 产生的。

\n
\n\n

参数

\n
    \n
  1. object (Object)

    要遍历的对象

    \n
  2. \n
  3. [iteratee=_.identity] (Function|Object|string)

    这个函数会处理每一个元素

    \n
  4. \n
\n

返回值 (Object)

\n

返回映射后的新对象

\n
\n

示例

\n
_.mapKeys({ 'a': 1, 'b': 2 }, function(value, key) {\n  return key + value;\n});\n// => { 'a1': 1, 'b2': 2 }\n
\n
\n
\n\n
" } + "html":"

mapKeys source npm

\n
_.mapKeys(object, [iteratee=_.identity])
\n\n

反向版 _.mapValues。\n这个方法创建一个对象,对象的值与源对象相同,但 key 是通过 iteratee 产生的。

\n
\n\n

参数

\n
    \n
  1. object (Object)

    要遍历的对象

    \n
  2. \n
  3. [iteratee=_.identity] (Function|Object|string)

    这个函数会处理每一个元素

    \n
  4. \n
\n

返回值 (Object)

\n

返回映射后的新对象

\n
\n

示例

\n
_.mapKeys({ 'a': 1, 'b': 2 }, function(value, key) {\n  return key + value;\n});\n// => { 'a1': 1, 'b2': 2 }\n
\n
\n
\n\n
" } ,{ "href":"/mapValues", - "html":"

mapValues source npm

\n
_.mapValues(object, [iteratee=_.identity])
\n\n

创建一个对象,对象的key相同,值是通过 iteratee 产生的。\niteratee 会传入3个参数: (value, key, object)

\n
\n\n

参数

\n
    \n
  1. object (Object)

    要遍历的对象

    \n
  2. \n
  3. [iteratee=_.identity] (Function|Object|string)

    这个函数会处理每一个元素

    \n
  4. \n
\n

返回值 (Object)

\n

返回映射后的对象

\n
\n

示例

\n
var users = {\n  'fred':    { 'user': 'fred',    'age': 40 },\n  'pebbles': { 'user': 'pebbles', 'age': 1 }\n};\n\n_.mapValues(users, function(o) { return o.age; });\n// => { 'fred': 40, 'pebbles': 1 } (无法保证遍历的顺序)\n\n// 使用了 `_.property` 的回调结果\n_.mapValues(users, 'age');\n// => { 'fred': 40, 'pebbles': 1 } (无法保证遍历的顺序)\n
\n
\n
\n\n
" } + "html":"

mapValues source npm

\n
_.mapValues(object, [iteratee=_.identity])
\n\n

创建一个对象,对象的key相同,值是通过 iteratee 产生的。\niteratee 会传入3个参数: (value, key, object)

\n
\n\n

参数

\n
    \n
  1. object (Object)

    要遍历的对象

    \n
  2. \n
  3. [iteratee=_.identity] (Function|Object|string)

    这个函数会处理每一个元素

    \n
  4. \n
\n

返回值 (Object)

\n

返回映射后的对象

\n
\n

示例

\n
var users = {\n  'fred':    { 'user': 'fred',    'age': 40 },\n  'pebbles': { 'user': 'pebbles', 'age': 1 }\n};\n\n_.mapValues(users, function(o) { return o.age; });\n// => { 'fred': 40, 'pebbles': 1 } (无法保证遍历的顺序)\n\n// 使用了 `_.property` 的回调结果\n_.mapValues(users, 'age');\n// => { 'fred': 40, 'pebbles': 1 } (无法保证遍历的顺序)\n
\n
\n
\n\n
" } ,{ "href":"/merge", - "html":"

merge source npm

\n
_.merge(object, [sources])
\n\n

递归合并来源对象的自身和继承的可枚举属性到目标对象。\n跳过来源对象解析为 undefined 的属性。\n数组和普通对象会递归合并,其他对象和值会被直接分配。\n来源对象从左到右分配,后续的来源对象属性会覆盖之前分配的属性。\n
\n
\n注意: 这方法会改变源对象

\n
\n\n

参数

\n
    \n
  1. object (Object)

    目标对象

    \n
  2. \n
  3. [sources] (...Object)

    来源对象

    \n
  4. \n
\n

返回值 (Object)

\n

返回对象

\n
\n

示例

\n
var users = {\n  'data': [{ 'user': 'barney' }, { 'user': 'fred' }]\n};\n\nvar ages = {\n  'data': [{ 'age': 36 }, { 'age': 40 }]\n};\n\n_.merge(users, ages);\n// => { 'data': [{ 'user': 'barney', 'age': 36 }, { 'user': 'fred', 'age': 40 }] }\n
\n
\n
\n\n
" } + "html":"

merge source npm

\n
_.merge(object, [sources])
\n\n

递归合并来源对象的自身和继承的可枚举属性到目标对象。\n跳过来源对象解析为 undefined 的属性。\n数组和普通对象会递归合并,其他对象和值会被直接分配。\n来源对象从左到右分配,后续的来源对象属性会覆盖之前分配的属性。\n
\n
\n注意: 这方法会改变源对象

\n
\n\n

参数

\n
    \n
  1. object (Object)

    目标对象

    \n
  2. \n
  3. [sources] (...Object)

    来源对象

    \n
  4. \n
\n

返回值 (Object)

\n

返回对象

\n
\n

示例

\n
var users = {\n  'data': [{ 'user': 'barney' }, { 'user': 'fred' }]\n};\n\nvar ages = {\n  'data': [{ 'age': 36 }, { 'age': 40 }]\n};\n\n_.merge(users, ages);\n// => { 'data': [{ 'user': 'barney', 'age': 36 }, { 'user': 'fred', 'age': 40 }] }\n
\n
\n
\n\n
" } ,{ "href":"/mergeWith", - "html":"

mergeWith source npm

\n
_.mergeWith(object, sources, customizer)
\n\n

这个方法类似 _.merge。\n除了它接受一个 customizer 决定如何合并。\n如果 customizer 返回 undefined 将会由合并处理方法代替。

\n
\n\n

参数

\n
    \n
  1. object (Object)

    目标对象

    \n
  2. \n
  3. sources (...Object)

    来源对象

    \n
  4. \n
  5. customizer (Function)

    这个方法决定如何合并

    \n
  6. \n
\n

返回值 (Object)

\n

返回对象

\n
\n

示例

\n
function customizer(objValue, srcValue) {\n  if (_.isArray(objValue)) {\n    return objValue.concat(srcValue);\n  }\n}\n\nvar object = {\n  'fruits': ['apple'],\n  'vegetables': ['beet']\n};\n\nvar other = {\n  'fruits': ['banana'],\n  'vegetables': ['carrot']\n};\n\n_.mergeWith(object, other, customizer);\n// => { 'fruits': ['apple', 'banana'], 'vegetables': ['beet', 'carrot'] }\n
\n
\n
\n\n
" } + "html":"

mergeWith source npm

\n
_.mergeWith(object, sources, customizer)
\n\n

这个方法类似 _.merge。\n除了它接受一个 customizer 决定如何合并。\n如果 customizer 返回 undefined 将会由合并处理方法代替。

\n
\n\n

参数

\n
    \n
  1. object (Object)

    目标对象

    \n
  2. \n
  3. sources (...Object)

    来源对象

    \n
  4. \n
  5. customizer (Function)

    这个方法决定如何合并

    \n
  6. \n
\n

返回值 (Object)

\n

返回对象

\n
\n

示例

\n
function customizer(objValue, srcValue) {\n  if (_.isArray(objValue)) {\n    return objValue.concat(srcValue);\n  }\n}\n\nvar object = {\n  'fruits': ['apple'],\n  'vegetables': ['beet']\n};\n\nvar other = {\n  'fruits': ['banana'],\n  'vegetables': ['carrot']\n};\n\n_.mergeWith(object, other, customizer);\n// => { 'fruits': ['apple', 'banana'], 'vegetables': ['beet', 'carrot'] }\n
\n
\n
\n\n
" } ,{ "href":"/omit", - "html":"

omit source npm

\n
_.omit(object, [props])
\n\n

反向版 _.pick。\n这个方法返回忽略属性之外的自身和继承的可枚举属性。

\n
\n\n

参数

\n
    \n
  1. object (Object)

    来源对象

    \n
  2. \n
  3. [props] (...(string|string[])

    要被忽略的属性,单独指定或指定在数组中

    \n
  4. \n
\n

返回值 (Object)

\n

返回新对象

\n
\n

示例

\n
var object = { 'user': 'fred', 'age': 40 };\n\n_.omit(object, 'user');\n// => { 'age': 40 }\n
\n
\n
\n\n
" } + "html":"

omit source npm

\n
_.omit(object, [props])
\n\n

反向版 _.pick。\n这个方法返回忽略属性之外的自身和继承的可枚举属性。

\n
\n\n

参数

\n
    \n
  1. object (Object)

    来源对象

    \n
  2. \n
  3. [props] (...(string|string[])

    要被忽略的属性,单独指定或指定在数组中

    \n
  4. \n
\n

返回值 (Object)

\n

返回新对象

\n
\n

示例

\n
var object = { 'user': 'fred', 'age': 40 };\n\n_.omit(object, 'user');\n// => { 'age': 40 }\n
\n
\n
\n\n
" } ,{ "href":"/omitBy", - "html":"

omitBy source npm

\n
_.omitBy(object, [predicate=_.identity])
\n\n

反向版 _.pickBy。\n这个方法返回经 predicate 判断不是真值的属性的自身和继承的可枚举属性。

\n
\n\n

参数

\n
    \n
  1. object (Object)

    来源对象

    \n
  2. \n
  3. [predicate=_.identity] (Function|Object|string)

    这个函数会调用每一个属性

    \n
  4. \n
\n

返回值 (Object)

\n

返回新对象

\n
\n

示例

\n
var object = { 'user': 'fred', 'age': 40 };\n\n_.omitBy(object, _.isNumber);\n// => { 'user': 'fred' }\n
\n
\n
\n\n
" } + "html":"

omitBy source npm

\n
_.omitBy(object, [predicate=_.identity])
\n\n

反向版 _.pickBy。\n这个方法返回经 predicate 判断不是真值的属性的自身和继承的可枚举属性。

\n
\n\n

参数

\n
    \n
  1. object (Object)

    来源对象

    \n
  2. \n
  3. [predicate=_.identity] (Function|Object|string)

    这个函数会调用每一个属性

    \n
  4. \n
\n

返回值 (Object)

\n

返回新对象

\n
\n

示例

\n
var object = { 'user': 'fred', 'age': 40 };\n\n_.omitBy(object, _.isNumber);\n// => { 'user': 'fred' }\n
\n
\n
\n\n
" } ,{ "href":"/pick", - "html":"

pick source npm

\n
_.pick(object, [props])
\n\n

创建一个从 object 中选中的属性的对象。

\n
\n\n

参数

\n
    \n
  1. object (Object)

    来源对象

    \n
  2. \n
  3. [props] (...(string|string[])

    要选中的属性名,单独指定或指定在数组中

    \n
  4. \n
\n

返回值 (Object)

\n

返回新对象

\n
\n

示例

\n
var object = { 'user': 'fred', 'age': 40 };\n\n_.pick(object, 'user');\n// => { 'user': 'fred' }\n
\n
\n
\n\n
" } + "html":"

pick source npm

\n
_.pick(object, [props])
\n\n

创建一个从 object 中选中的属性的对象。

\n
\n\n

参数

\n
    \n
  1. object (Object)

    来源对象

    \n
  2. \n
  3. [props] (...(string|string[])

    要选中的属性名,单独指定或指定在数组中

    \n
  4. \n
\n

返回值 (Object)

\n

返回新对象

\n
\n

示例

\n
var object = { 'user': 'fred', 'age': 40 };\n\n_.pick(object, 'user');\n// => { 'user': 'fred' }\n
\n
\n
\n\n
" } ,{ "href":"/pickBy", - "html":"

pickBy source npm

\n
_.pickBy(object, [predicate=_.identity])
\n\n

创建一个从 object 中经 predicate 判断为真值的属性为对象。\npredicate 会传入1个参数:(value)

\n
\n\n

参数

\n
    \n
  1. object (Object)

    来源对象

    \n
  2. \n
  3. [predicate=_.identity] (Function|Object|string)

    这个函数会调用每一个属性

    \n
  4. \n
\n

返回值 (Object)

\n

返回新对象

\n
\n

示例

\n
var object = { 'user': 'fred', 'age': 40 };\n\n_.pickBy(object, _.isNumber);\n// => { 'age': 40 }\n
\n
\n
\n\n
" } + "html":"

pickBy source npm

\n
_.pickBy(object, [predicate=_.identity])
\n\n

创建一个从 object 中经 predicate 判断为真值的属性为对象。\npredicate 会传入1个参数:(value)

\n
\n\n

参数

\n
    \n
  1. object (Object)

    来源对象

    \n
  2. \n
  3. [predicate=_.identity] (Function|Object|string)

    这个函数会调用每一个属性

    \n
  4. \n
\n

返回值 (Object)

\n

返回新对象

\n
\n

示例

\n
var object = { 'user': 'fred', 'age': 40 };\n\n_.pickBy(object, _.isNumber);\n// => { 'age': 40 }\n
\n
\n
\n\n
" } ,{ "href":"/result", - "html":"

result source npm

\n
_.result(object, path, [defaultValue])
\n\n

这个方法类似 _.get。\n除了如果解析到的值是一个函数的话,就绑定 this 到这个函数并返回执行后的结果。

\n
\n\n

参数

\n
    \n
  1. object (Object)

    要检索的对象

    \n
  2. \n
  3. path (Array|string)

    要解析的属性路径

    \n
  4. \n
  5. [defaultValue] (*)

    如果值是 undefined,返回这个值

    \n
  6. \n
\n

返回值 (*)

\n

返回解析后的值

\n
\n

示例

\n
var object = { 'a': [{ 'b': { 'c1': 3, 'c2': _.constant(4) } }] };\n\n_.result(object, 'a[0].b.c1');\n// => 3\n\n_.result(object, 'a[0].b.c2');\n// => 4\n\n_.result(object, 'a[0].b.c3', 'default');\n// => 'default'\n\n_.result(object, 'a[0].b.c3', _.constant('default'));\n// => 'default'\n
\n
\n
\n\n
" } + "html":"

result source npm

\n
_.result(object, path, [defaultValue])
\n\n

这个方法类似 _.get。\n除了如果解析到的值是一个函数的话,就绑定 this 到这个函数并返回执行后的结果。

\n
\n\n

参数

\n
    \n
  1. object (Object)

    要检索的对象

    \n
  2. \n
  3. path (Array|string)

    要解析的属性路径

    \n
  4. \n
  5. [defaultValue] (*)

    如果值是 undefined,返回这个值

    \n
  6. \n
\n

返回值 (*)

\n

返回解析后的值

\n
\n

示例

\n
var object = { 'a': [{ 'b': { 'c1': 3, 'c2': _.constant(4) } }] };\n\n_.result(object, 'a[0].b.c1');\n// => 3\n\n_.result(object, 'a[0].b.c2');\n// => 4\n\n_.result(object, 'a[0].b.c3', 'default');\n// => 'default'\n\n_.result(object, 'a[0].b.c3', _.constant('default'));\n// => 'default'\n
\n
\n
\n\n
" } ,{ "href":"/set", - "html":"

set source npm

\n
_.set(object, path, value)
\n\n

设置值到对象对应的属性路径上,如果没有则创建这部分路径。\n缺少的索引属性会创建为数组,而缺少的属性会创建为对象。\n使用 _.setWith 定制创建。

\n
\n\n

参数

\n
    \n
  1. object (Object)

    要修改的对象

    \n
  2. \n
  3. path (Array|string)

    要设置的对象路径

    \n
  4. \n
  5. value (*)

    要设置的值

    \n
  6. \n
\n

返回值 (Object)

\n

返回对象

\n
\n

示例

\n
var object = { 'a': [{ 'b': { 'c': 3 } }] };\n\n_.set(object, 'a[0].b.c', 4);\nconsole.log(object.a[0].b.c);\n// => 4\n\n_.set(object, 'x[0].y.z', 5);\nconsole.log(object.x[0].y.z);\n// => 5\n
\n
\n
\n\n
" } + "html":"

set source npm

\n
_.set(object, path, value)
\n\n

设置值到对象对应的属性路径上,如果没有则创建这部分路径。\n缺少的索引属性会创建为数组,而缺少的属性会创建为对象。\n使用 _.setWith 定制创建。

\n
\n\n

参数

\n
    \n
  1. object (Object)

    要修改的对象

    \n
  2. \n
  3. path (Array|string)

    要设置的对象路径

    \n
  4. \n
  5. value (*)

    要设置的值

    \n
  6. \n
\n

返回值 (Object)

\n

返回对象

\n
\n

示例

\n
var object = { 'a': [{ 'b': { 'c': 3 } }] };\n\n_.set(object, 'a[0].b.c', 4);\nconsole.log(object.a[0].b.c);\n// => 4\n\n_.set(object, 'x[0].y.z', 5);\nconsole.log(object.x[0].y.z);\n// => 5\n
\n
\n
\n\n
" } ,{ "href":"/setWith", - "html":"

setWith source npm

\n
_.setWith(object, path, value, [customizer])
\n\n

这个方法类似 _.set。\n除了它接受一个 customizer 决定如何设置对象路径的值。\n如果 customizer 返回 undefined 将会有它的处理方法代替。\ncustomizer 会传入3个参数:(nsValue, key, nsObject)

\n
\n\n

参数

\n
    \n
  1. object (Object)

    要修改的对象

    \n
  2. \n
  3. path (Array|string)

    要设置的对象路径

    \n
  4. \n
  5. value (*)

    要设置的值

    \n
  6. \n
  7. [customizer] (Function)

    这个函数决定如何分配值

    \n
  8. \n
\n

返回值 (Object)

\n

返回对象

\n
\n

示例

\n
_.setWith({ '0': { 'length': 2 } }, '[0][1][2]', 3, Object);\n// => { '0': { '1': { '2': 3 }, 'length': 2 } }\n
\n
\n
\n\n
" } + "html":"

setWith source npm

\n
_.setWith(object, path, value, [customizer])
\n\n

这个方法类似 _.set。\n除了它接受一个 customizer 决定如何设置对象路径的值。\n如果 customizer 返回 undefined 将会有它的处理方法代替。\ncustomizer 会传入3个参数:(nsValue, key, nsObject)

\n
\n\n

参数

\n
    \n
  1. object (Object)

    要修改的对象

    \n
  2. \n
  3. path (Array|string)

    要设置的对象路径

    \n
  4. \n
  5. value (*)

    要设置的值

    \n
  6. \n
  7. [customizer] (Function)

    这个函数决定如何分配值

    \n
  8. \n
\n

返回值 (Object)

\n

返回对象

\n
\n

示例

\n
_.setWith({ '0': { 'length': 2 } }, '[0][1][2]', 3, Object);\n// => { '0': { '1': { '2': 3 }, 'length': 2 } }\n
\n
\n
\n\n
" } ,{ "href":"/toPairs", - "html":"

toPairs source npm

\n
_.toPairs(object)
\n\n

创建一个对象自身可枚举属性的键值对数组。

\n
\n\n

参数

\n
    \n
  1. object (Object)

    要检索的对象

    \n
  2. \n
\n

返回值 (Array)

\n

返回键值对的数组

\n
\n

示例

\n
function Foo() {\n  this.a = 1;\n  this.b = 2;\n}\n\nFoo.prototype.c = 3;\n\n_.toPairs(new Foo);\n// => [['a', 1], ['b', 2]] (无法保证遍历的顺序)\n
\n
\n
\n\n
" } + "html":"

toPairs source npm

\n
_.toPairs(object)
\n\n

创建一个对象自身可枚举属性的键值对数组。

\n
\n\n

参数

\n
    \n
  1. object (Object)

    要检索的对象

    \n
  2. \n
\n

返回值 (Array)

\n

返回键值对的数组

\n
\n

示例

\n
function Foo() {\n  this.a = 1;\n  this.b = 2;\n}\n\nFoo.prototype.c = 3;\n\n_.toPairs(new Foo);\n// => [['a', 1], ['b', 2]] (无法保证遍历的顺序)\n
\n
\n
\n\n
" } ,{ "href":"/toPairsIn", - "html":"

toPairsIn source npm

\n
_.toPairsIn(object)
\n\n

创建一个对象自身和继承的可枚举属性的键值对数组。

\n
\n\n

参数

\n
    \n
  1. object (Object)

    要检索的对象

    \n
  2. \n
\n

返回值 (Array)

\n

返回键值对的数组

\n
\n

示例

\n
function Foo() {\n  this.a = 1;\n  this.b = 2;\n}\n\nFoo.prototype.c = 3;\n\n_.toPairsIn(new Foo);\n// => [['a', 1], ['b', 2], ['c', 1]] (无法保证遍历的顺序)\n
\n
\n
\n\n
" } + "html":"

toPairsIn source npm

\n
_.toPairsIn(object)
\n\n

创建一个对象自身和继承的可枚举属性的键值对数组。

\n
\n\n

参数

\n
    \n
  1. object (Object)

    要检索的对象

    \n
  2. \n
\n

返回值 (Array)

\n

返回键值对的数组

\n
\n

示例

\n
function Foo() {\n  this.a = 1;\n  this.b = 2;\n}\n\nFoo.prototype.c = 3;\n\n_.toPairsIn(new Foo);\n// => [['a', 1], ['b', 2], ['c', 1]] (无法保证遍历的顺序)\n
\n
\n
\n\n
" } ,{ "href":"/transform", - "html":"

transform source npm

\n
_.transform(object, [iteratee=_.identity], [accumulator])
\n\n

_.reduce 的代替方法。\n这个方法会改变对象为一个新的 accumulator 对象,来自每一次经 iteratee 处理自身可枚举对象的结果。\n每次调用可能会改变 accumulator 对象。\niteratee 会传入4个对象:(accumulator, value, key, object)。\n如果返回 false,iteratee 会提前退出。

\n
\n\n

参数

\n
    \n
  1. object (Array|Object)

    要遍历的对象

    \n
  2. \n
  3. [iteratee=_.identity] (Function)

    这个函数会处理每一个元素

    \n
  4. \n
  5. [accumulator] (*)

    定制叠加的值

    \n
  6. \n
\n

返回值 (*)

\n

返回叠加后的值

\n
\n

示例

\n
_.transform([2, 3, 4], function(result, n) {\n  result.push(n *= n);\n  return n % 2 == 0;\n});\n// => [4, 9]\n\n_.transform({ 'a': 1, 'b': 2, 'c': 1 }, function(result, value, key) {\n  (result[value] || (result[value] = [])).push(key);\n});\n// => { '1': ['a', 'c'], '2': ['b'] }\n
\n
\n
\n\n
" } + "html":"

transform source npm

\n
_.transform(object, [iteratee=_.identity], [accumulator])
\n\n

_.reduce 的代替方法。\n这个方法会改变对象为一个新的 accumulator 对象,来自每一次经 iteratee 处理自身可枚举对象的结果。\n每次调用可能会改变 accumulator 对象。\niteratee 会传入4个对象:(accumulator, value, key, object)。\n如果返回 false,iteratee 会提前退出。

\n
\n\n

参数

\n
    \n
  1. object (Array|Object)

    要遍历的对象

    \n
  2. \n
  3. [iteratee=_.identity] (Function)

    这个函数会处理每一个元素

    \n
  4. \n
  5. [accumulator] (*)

    定制叠加的值

    \n
  6. \n
\n

返回值 (*)

\n

返回叠加后的值

\n
\n

示例

\n
_.transform([2, 3, 4], function(result, n) {\n  result.push(n *= n);\n  return n % 2 == 0;\n});\n// => [4, 9]\n\n_.transform({ 'a': 1, 'b': 2, 'c': 1 }, function(result, value, key) {\n  (result[value] || (result[value] = [])).push(key);\n});\n// => { '1': ['a', 'c'], '2': ['b'] }\n
\n
\n
\n\n
" } ,{ "href":"/unset", - "html":"

unset source npm

\n
_.unset(object, path)
\n\n

移除对象路径的属性。

\n
\n\n

参数

\n
    \n
  1. object (Object)

    要修改的对象

    \n
  2. \n
  3. path (Array|string)

    要移除的对象路径

    \n
  4. \n
\n

返回值 (boolean)

\n

移除成功返回 true,否则返回 false

\n
\n

示例

\n
var object = { 'a': [{ 'b': { 'c': 7 } }] };\n_.unset(object, 'a[0].b.c');\n// => true\n\nconsole.log(object);\n// => { 'a': [{ 'b': {} }] };\n\n_.unset(object, 'a[0].b.c');\n// => true\n\nconsole.log(object);\n// => { 'a': [{ 'b': {} }] };\n
\n
\n
\n\n
" } + "html":"

unset source npm

\n
_.unset(object, path)
\n\n

移除对象路径的属性。

\n
\n\n

参数

\n
    \n
  1. object (Object)

    要修改的对象

    \n
  2. \n
  3. path (Array|string)

    要移除的对象路径

    \n
  4. \n
\n

返回值 (boolean)

\n

移除成功返回 true,否则返回 false

\n
\n

示例

\n
var object = { 'a': [{ 'b': { 'c': 7 } }] };\n_.unset(object, 'a[0].b.c');\n// => true\n\nconsole.log(object);\n// => { 'a': [{ 'b': {} }] };\n\n_.unset(object, 'a[0].b.c');\n// => true\n\nconsole.log(object);\n// => { 'a': [{ 'b': {} }] };\n
\n
\n
\n\n
" } ,{ "href":"/values", - "html":"

values source npm

\n
_.values(object)
\n\n

创建 object 自身可枚举属性的值为数组\n
\n
\n注意: 非对象的值会强制转换为对象

\n
\n\n

参数

\n
    \n
  1. object (Object)

    要检索的对象

    \n
  2. \n
\n

返回值 (Array)

\n

返回对象属性的值的数组

\n
\n

示例

\n
function Foo() {\n  this.a = 1;\n  this.b = 2;\n}\n\nFoo.prototype.c = 3;\n\n_.values(new Foo);\n// => [1, 2] (无法保证遍历的顺序)\n\n_.values('hi');\n// => ['h', 'i']\n
\n
\n
\n\n
" } + "html":"

values source npm

\n
_.values(object)
\n\n

创建 object 自身可枚举属性的值为数组\n
\n
\n注意: 非对象的值会强制转换为对象

\n
\n\n

参数

\n
    \n
  1. object (Object)

    要检索的对象

    \n
  2. \n
\n

返回值 (Array)

\n

返回对象属性的值的数组

\n
\n

示例

\n
function Foo() {\n  this.a = 1;\n  this.b = 2;\n}\n\nFoo.prototype.c = 3;\n\n_.values(new Foo);\n// => [1, 2] (无法保证遍历的顺序)\n\n_.values('hi');\n// => ['h', 'i']\n
\n
\n
\n\n
" } ,{ "href":"/valuesIn", - "html":"

valuesIn source npm

\n
_.valuesIn(object)
\n\n

创建 object 自身和继承的可枚举属性的值为数组\n
\n
\n注意: 非对象的值会强制转换为对象

\n
\n\n

参数

\n
    \n
  1. object (Object)

    要检索的对象

    \n
  2. \n
\n

返回值 (Array)

\n

Returns the array of property values.

\n
\n

示例

\n
function Foo() {\n  this.a = 1;\n  this.b = 2;\n}\n\nFoo.prototype.c = 3;\n\n_.valuesIn(new Foo);\n// => [1, 2, 3] (无法保证遍历的顺序)\n
\n
\n
\n\n
" } + "html":"

valuesIn source npm

\n
_.valuesIn(object)
\n\n

创建 object 自身和继承的可枚举属性的值为数组\n
\n
\n注意: 非对象的值会强制转换为对象

\n
\n\n

参数

\n
    \n
  1. object (Object)

    要检索的对象

    \n
  2. \n
\n

返回值 (Array)

\n

Returns the array of property values.

\n
\n

示例

\n
function Foo() {\n  this.a = 1;\n  this.b = 2;\n}\n\nFoo.prototype.c = 3;\n\n_.valuesIn(new Foo);\n// => [1, 2, 3] (无法保证遍历的顺序)\n
\n
\n
\n\n
" } ,{ "href":"/templateSettings", "html":"

templateSettings source npm

\n
_.templateSettings
\n\n

(Object): 默认情况下,这些都是用于处理lodash的模板,类似 Ruby 的嵌入式 (ERB)。\n可以改变接下来的设置用新的方式代替。

\n
\n\n
\n\n
" } ,{ "href":"/templateSettings-escape", @@ -465,121 +465,121 @@ ,{ "href":"/templateSettings-variable", "html":"

templateSettings.variable source

\n
_.templateSettings.variable
\n\n

(string): 用于引用模板文本中的 data 对象

\n
\n\n
\n\n
" } ,{ "href":"/VERSION", - "html":"

VERSION source

\n
_.VERSION
\n\n

(string): 语义化版本号

\n
\n\n
\n\n
" } + "html":"

VERSION source

\n
_.VERSION
\n\n

(string): 语义化版本号

\n
\n\n
\n\n
" } ,{ "href":"/camelCase", - "html":"

camelCase source npm

\n
_.camelCase([string=''])
\n\n

转换字符串为 驼峰写法

\n
\n\n

参数

\n
    \n
  1. [string=''] (string)

    要转换的字符串

    \n
  2. \n
\n

返回值 (string)

\n

返回驼峰写法的字符串

\n
\n

示例

\n
_.camelCase('Foo Bar');\n// => 'fooBar'\n\n_.camelCase('--foo-bar');\n// => 'fooBar'\n\n_.camelCase('__foo_bar__');\n// => 'fooBar'\n
\n
\n
\n\n
" } + "html":"

camelCase source npm

\n
_.camelCase([string=''])
\n\n

转换字符串为 驼峰写法

\n
\n\n

参数

\n
    \n
  1. [string=''] (string)

    要转换的字符串

    \n
  2. \n
\n

返回值 (string)

\n

返回驼峰写法的字符串

\n
\n

示例

\n
_.camelCase('Foo Bar');\n// => 'fooBar'\n\n_.camelCase('--foo-bar');\n// => 'fooBar'\n\n_.camelCase('__foo_bar__');\n// => 'fooBar'\n
\n
\n
\n\n
" } ,{ "href":"/capitalize", - "html":"

capitalize source npm

\n
_.capitalize([string=''])
\n\n

转换字符串首字母为大写,剩下为小写。

\n
\n\n

参数

\n
    \n
  1. [string=''] (string)

    要大写开头的字符串

    \n
  2. \n
\n

返回值 (string)

\n

返回大写开头的字符串

\n
\n

示例

\n
_.capitalize('FRED');\n// => 'Fred'\n
\n
\n
\n\n
" } + "html":"

capitalize source npm

\n
_.capitalize([string=''])
\n\n

转换字符串首字母为大写,剩下为小写。

\n
\n\n

参数

\n
    \n
  1. [string=''] (string)

    要大写开头的字符串

    \n
  2. \n
\n

返回值 (string)

\n

返回大写开头的字符串

\n
\n

示例

\n
_.capitalize('FRED');\n// => 'Fred'\n
\n
\n
\n\n
" } ,{ "href":"/deburr", - "html":"

deburr source npm

\n
_.deburr([string=''])
\n\n

转换 latin-1 supplementary letters#Character_table) 为基本拉丁字母,并删除变音符

\n
\n\n

参数

\n
    \n
  1. [string=''] (string)

    要处理的字符串

    \n
  2. \n
\n

返回值 (string)

\n

返回处理后的字符串

\n
\n

示例

\n
_.deburr('déjà vu');\n// => 'deja vu'\n
\n
\n
\n\n
" } + "html":"

deburr source npm

\n
_.deburr([string=''])
\n\n

转换 latin-1 supplementary letters#Character_table) 为基本拉丁字母,并删除变音符

\n
\n\n

参数

\n
    \n
  1. [string=''] (string)

    要处理的字符串

    \n
  2. \n
\n

返回值 (string)

\n

返回处理后的字符串

\n
\n

示例

\n
_.deburr('déjà vu');\n// => 'deja vu'\n
\n
\n
\n\n
" } ,{ "href":"/endsWith", - "html":"

endsWith source npm

\n
_.endsWith([string=''], [target], [position=string.length])
\n\n

检查给定的字符是否是字符串的结尾

\n
\n\n

参数

\n
    \n
  1. [string=''] (string)

    要检索的字符串

    \n
  2. \n
  3. [target] (string)

    要检索字符

    \n
  4. \n
  5. [position=string.length] (number)

    检索的位置

    \n
  6. \n
\n

返回值 (boolean)

\n

如果是结尾返回 true,否则返回 false

\n
\n

示例

\n
_.endsWith('abc', 'c');\n// => true\n\n_.endsWith('abc', 'b');\n// => false\n\n_.endsWith('abc', 'b', 2);\n// => true\n
\n
\n
\n\n
" } + "html":"

endsWith source npm

\n
_.endsWith([string=''], [target], [position=string.length])
\n\n

检查给定的字符是否是字符串的结尾

\n
\n\n

参数

\n
    \n
  1. [string=''] (string)

    要检索的字符串

    \n
  2. \n
  3. [target] (string)

    要检索字符

    \n
  4. \n
  5. [position=string.length] (number)

    检索的位置

    \n
  6. \n
\n

返回值 (boolean)

\n

如果是结尾返回 true,否则返回 false

\n
\n

示例

\n
_.endsWith('abc', 'c');\n// => true\n\n_.endsWith('abc', 'b');\n// => false\n\n_.endsWith('abc', 'b', 2);\n// => true\n
\n
\n
\n\n
" } ,{ "href":"/escape", - "html":"

escape source npm

\n
_.escape([string=''])
\n\n

转义字符 "&", "<", ">", '"', "'", 以及 "`" 为HTML实体字符。\n
\n
\n注意: 不会转义其他字符,如果需要,可以使用第三方库,例如 he。\n
\n
\n虽然 ">" 是对称转义的,像是 ">" 和 "/" 没有特殊的意义,所以不需要在 HTML 中转义。\n除非它们是标签的一部分,或者是不带引号的属性值。\n查看 Mathias Bynens 的文章\n(under "semi-related fun fact") 了解详情\n
\n
\n在 IE < 9 中转义引号,因为会中断属性值或 HTML 注释,查看\nHTML5 安全列表#59,\n#102, #108, 以及\n#133 了解详情\n
\n
\n当解析为 HTML 时应该总是 引用属性值\n以减少 XSS 的可能性。

\n
\n\n

参数

\n
    \n
  1. [string=''] (string)

    要转义的字符串

    \n
  2. \n
\n

返回值 (string)

\n

返回转义后的字符串

\n
\n

示例

\n
_.escape('fred, barney, & pebbles');\n// => 'fred, barney, &amp; pebbles'\n
\n
\n
\n\n
" } + "html":"

escape source npm

\n
_.escape([string=''])
\n\n

转义字符 "&", "<", ">", '"', "'", 以及 "`" 为HTML实体字符。\n
\n
\n注意: 不会转义其他字符,如果需要,可以使用第三方库,例如 he。\n
\n
\n虽然 ">" 是对称转义的,像是 ">" 和 "/" 没有特殊的意义,所以不需要在 HTML 中转义。\n除非它们是标签的一部分,或者是不带引号的属性值。\n查看 Mathias Bynens 的文章\n(under "semi-related fun fact") 了解详情\n
\n
\n在 IE < 9 中转义引号,因为会中断属性值或 HTML 注释,查看\nHTML5 安全列表#59,\n#102, #108, 以及\n#133 了解详情\n
\n
\n当解析为 HTML 时应该总是 引用属性值\n以减少 XSS 的可能性。

\n
\n\n

参数

\n
    \n
  1. [string=''] (string)

    要转义的字符串

    \n
  2. \n
\n

返回值 (string)

\n

返回转义后的字符串

\n
\n

示例

\n
_.escape('fred, barney, & pebbles');\n// => 'fred, barney, &amp; pebbles'\n
\n
\n
\n\n
" } ,{ "href":"/escapeRegExp", - "html":"

escapeRegExp source npm

\n
_.escapeRegExp([string=''])
\n\n

转义RegExp 中特殊的字符 "^", "$", "\\", ".", "*", "+",\n"?", "(", ")", "[", "]", "{", "}", 以及 "|"。

\n
\n\n

参数

\n
    \n
  1. [string=''] (string)

    要转义的字符串

    \n
  2. \n
\n

返回值 (string)

\n

返回转义后的字符串

\n
\n

示例

\n
_.escapeRegExp('[lodash](https://lodash.com/)');\n// => '\\[lodash\\]\\(https://lodash\\.com/\\)'\n
\n
\n
\n\n
" } + "html":"

escapeRegExp source npm

\n
_.escapeRegExp([string=''])
\n\n

转义RegExp 中特殊的字符 "^", "$", "\\", ".", "*", "+",\n"?", "(", ")", "[", "]", "{", "}", 以及 "|"。

\n
\n\n

参数

\n
    \n
  1. [string=''] (string)

    要转义的字符串

    \n
  2. \n
\n

返回值 (string)

\n

返回转义后的字符串

\n
\n

示例

\n
_.escapeRegExp('[lodash](https://lodash.com/)');\n// => '\\[lodash\\]\\(https://lodash\\.com/\\)'\n
\n
\n
\n\n
" } ,{ "href":"/kebabCase", - "html":"

kebabCase source npm

\n
_.kebabCase([string=''])
\n\n

转换字符串为 kebab case

\n
\n\n

参数

\n
    \n
  1. [string=''] (string)

    要转换的字符串

    \n
  2. \n
\n

返回值 (string)

\n

返回转换后的字符串

\n
\n

示例

\n
_.kebabCase('Foo Bar');\n// => 'foo-bar'\n\n_.kebabCase('fooBar');\n// => 'foo-bar'\n\n_.kebabCase('__foo_bar__');\n// => 'foo-bar'\n
\n
\n
\n\n
" } + "html":"

kebabCase source npm

\n
_.kebabCase([string=''])
\n\n

转换字符串为 kebab case

\n
\n\n

参数

\n
    \n
  1. [string=''] (string)

    要转换的字符串

    \n
  2. \n
\n

返回值 (string)

\n

返回转换后的字符串

\n
\n

示例

\n
_.kebabCase('Foo Bar');\n// => 'foo-bar'\n\n_.kebabCase('fooBar');\n// => 'foo-bar'\n\n_.kebabCase('__foo_bar__');\n// => 'foo-bar'\n
\n
\n
\n\n
" } ,{ "href":"/lowerCase", - "html":"

lowerCase source npm

\n
_.lowerCase([string=''])
\n\n

以空格分开单词并转换为小写。

\n
\n\n

参数

\n
    \n
  1. [string=''] (string)

    要转换的字符串

    \n
  2. \n
\n

返回值 (string)

\n

返回小写的字符串

\n
\n

示例

\n
_.lowerCase('--Foo-Bar');\n// => 'foo bar'\n\n_.lowerCase('fooBar');\n// => 'foo bar'\n\n_.lowerCase('__FOO_BAR__');\n// => 'foo bar'\n
\n
\n
\n\n
" } + "html":"

lowerCase source npm

\n
_.lowerCase([string=''])
\n\n

以空格分开单词并转换为小写。

\n
\n\n

参数

\n
    \n
  1. [string=''] (string)

    要转换的字符串

    \n
  2. \n
\n

返回值 (string)

\n

返回小写的字符串

\n
\n

示例

\n
_.lowerCase('--Foo-Bar');\n// => 'foo bar'\n\n_.lowerCase('fooBar');\n// => 'foo bar'\n\n_.lowerCase('__FOO_BAR__');\n// => 'foo bar'\n
\n
\n
\n\n
" } ,{ "href":"/lowerFirst", - "html":"

lowerFirst source npm

\n
_.lowerFirst([string=''])
\n\n

转换首字母为小写。

\n
\n\n

参数

\n
    \n
  1. [string=''] (string)

    要转换的字符串

    \n
  2. \n
\n

返回值 (string)

\n

返回转换后的字符串

\n
\n

示例

\n
_.lowerFirst('Fred');\n// => 'fred'\n\n_.lowerFirst('FRED');\n// => 'fRED'\n
\n
\n
\n\n
" } + "html":"

lowerFirst source npm

\n
_.lowerFirst([string=''])
\n\n

转换首字母为小写。

\n
\n\n

参数

\n
    \n
  1. [string=''] (string)

    要转换的字符串

    \n
  2. \n
\n

返回值 (string)

\n

返回转换后的字符串

\n
\n

示例

\n
_.lowerFirst('Fred');\n// => 'fred'\n\n_.lowerFirst('FRED');\n// => 'fRED'\n
\n
\n
\n\n
" } ,{ "href":"/pad", - "html":"

pad source npm

\n
_.pad([string=''], [length=0], [chars=' '])
\n\n

如果字符串长度小于 length 则从左到右填充字符。\n如果没法平均分配,则截断超出的长度。

\n
\n\n

参数

\n
    \n
  1. [string=''] (string)

    要填充的字符串

    \n
  2. \n
  3. [length=0] (number)

    填充的长度

    \n
  4. \n
  5. [chars=' '] (string)

    填充字符

    \n
  6. \n
\n

返回值 (string)

\n

返回填充后的字符串

\n
\n

示例

\n
_.pad('abc', 8);\n// => '  abc   '\n\n_.pad('abc', 8, '_-');\n// => '_-abc_-_'\n\n_.pad('abc', 3);\n// => 'abc'\n
\n
\n
\n\n
" } + "html":"

pad source npm

\n
_.pad([string=''], [length=0], [chars=' '])
\n\n

如果字符串长度小于 length 则从左到右填充字符。\n如果没法平均分配,则截断超出的长度。

\n
\n\n

参数

\n
    \n
  1. [string=''] (string)

    要填充的字符串

    \n
  2. \n
  3. [length=0] (number)

    填充的长度

    \n
  4. \n
  5. [chars=' '] (string)

    填充字符

    \n
  6. \n
\n

返回值 (string)

\n

返回填充后的字符串

\n
\n

示例

\n
_.pad('abc', 8);\n// => '  abc   '\n\n_.pad('abc', 8, '_-');\n// => '_-abc_-_'\n\n_.pad('abc', 3);\n// => 'abc'\n
\n
\n
\n\n
" } ,{ "href":"/padEnd", - "html":"

padEnd source npm

\n
_.padEnd([string=''], [length=0], [chars=' '])
\n\n

如果字符串长度小于 length 则在右侧填充字符。 如果超出长度则截断超出的部分。

\n
\n\n

参数

\n
    \n
  1. [string=''] (string)

    要填充的字符串

    \n
  2. \n
  3. [length=0] (number)

    填充的长度

    \n
  4. \n
  5. [chars=' '] (string)

    填充字符

    \n
  6. \n
\n

返回值 (string)

\n

Returns 返回填充后的字符串

\n
\n

示例

\n
_.padEnd('abc', 6);\n// => 'abc   '\n\n_.padEnd('abc', 6, '_-');\n// => 'abc_-_'\n\n_.padEnd('abc', 3);\n// => 'abc'\n
\n
\n
\n\n
" } + "html":"

padEnd source npm

\n
_.padEnd([string=''], [length=0], [chars=' '])
\n\n

如果字符串长度小于 length 则在右侧填充字符。 如果超出长度则截断超出的部分。

\n
\n\n

参数

\n
    \n
  1. [string=''] (string)

    要填充的字符串

    \n
  2. \n
  3. [length=0] (number)

    填充的长度

    \n
  4. \n
  5. [chars=' '] (string)

    填充字符

    \n
  6. \n
\n

返回值 (string)

\n

Returns 返回填充后的字符串

\n
\n

示例

\n
_.padEnd('abc', 6);\n// => 'abc   '\n\n_.padEnd('abc', 6, '_-');\n// => 'abc_-_'\n\n_.padEnd('abc', 3);\n// => 'abc'\n
\n
\n
\n\n
" } ,{ "href":"/padStart", - "html":"

padStart source npm

\n
_.padStart([string=''], [length=0], [chars=' '])
\n\n

如果字符串长度小于 length 则在左侧填充字符。 如果超出长度则截断超出的部分。

\n
\n\n

参数

\n
    \n
  1. [string=''] (string)

    要填充的字符串

    \n
  2. \n
  3. [length=0] (number)

    填充的长度

    \n
  4. \n
  5. [chars=' '] (string)

    填充字符

    \n
  6. \n
\n

返回值 (string)

\n

Returns 返回填充后的字符串

\n
\n

示例

\n
_.padStart('abc', 6);\n// => '   abc'\n\n_.padStart('abc', 6, '_-');\n// => '_-_abc'\n\n_.padStart('abc', 3);\n// => 'abc'\n
\n
\n
\n\n
" } + "html":"

padStart source npm

\n
_.padStart([string=''], [length=0], [chars=' '])
\n\n

如果字符串长度小于 length 则在左侧填充字符。 如果超出长度则截断超出的部分。

\n
\n\n

参数

\n
    \n
  1. [string=''] (string)

    要填充的字符串

    \n
  2. \n
  3. [length=0] (number)

    填充的长度

    \n
  4. \n
  5. [chars=' '] (string)

    填充字符

    \n
  6. \n
\n

返回值 (string)

\n

Returns 返回填充后的字符串

\n
\n

示例

\n
_.padStart('abc', 6);\n// => '   abc'\n\n_.padStart('abc', 6, '_-');\n// => '_-_abc'\n\n_.padStart('abc', 3);\n// => 'abc'\n
\n
\n
\n\n
" } ,{ "href":"/parseInt", - "html":"

parseInt source npm

\n
_.parseInt(string, [radix])
\n\n

以指定的基数转换字符串为整数。\n如果基数是 undefined 或者 0,则基数默认是10,如果字符串是16进制,则基数为16。\n
\n
\n注意: 这个方法与 ES5 implementation\n的 parseInt 一致

\n
\n\n

参数

\n
    \n
  1. string (string)

    要转换的字符串

    \n
  2. \n
  3. [radix] (number)

    基数

    \n
  4. \n
\n

返回值 (number)

\n

返回转换后的整数

\n
\n

示例

\n
_.parseInt('08');\n// => 8\n\n_.map(['6', '08', '10'], _.parseInt);\n// => [6, 8, 10]\n
\n
\n
\n\n
" } + "html":"

parseInt source npm

\n
_.parseInt(string, [radix])
\n\n

以指定的基数转换字符串为整数。\n如果基数是 undefined 或者 0,则基数默认是10,如果字符串是16进制,则基数为16。\n
\n
\n注意: 这个方法与 ES5 implementation\n的 parseInt 一致

\n
\n\n

参数

\n
    \n
  1. string (string)

    要转换的字符串

    \n
  2. \n
  3. [radix] (number)

    基数

    \n
  4. \n
\n

返回值 (number)

\n

返回转换后的整数

\n
\n

示例

\n
_.parseInt('08');\n// => 8\n\n_.map(['6', '08', '10'], _.parseInt);\n// => [6, 8, 10]\n
\n
\n
\n\n
" } ,{ "href":"/repeat", - "html":"

repeat source npm

\n
_.repeat([string=''], [n=0])
\n\n

重复 N 次字符串

\n
\n\n

参数

\n
    \n
  1. [string=''] (string)

    要重复的字符串

    \n
  2. \n
  3. [n=0] (number)

    重复的次数

    \n
  4. \n
\n

返回值 (string)

\n

返回重复的字符串

\n
\n

示例

\n
_.repeat('*', 3);\n// => '***'\n\n_.repeat('abc', 2);\n// => 'abcabc'\n\n_.repeat('abc', 0);\n// => ''\n
\n
\n
\n\n
" } + "html":"

repeat source npm

\n
_.repeat([string=''], [n=0])
\n\n

重复 N 次字符串

\n
\n\n

参数

\n
    \n
  1. [string=''] (string)

    要重复的字符串

    \n
  2. \n
  3. [n=0] (number)

    重复的次数

    \n
  4. \n
\n

返回值 (string)

\n

返回重复的字符串

\n
\n

示例

\n
_.repeat('*', 3);\n// => '***'\n\n_.repeat('abc', 2);\n// => 'abcabc'\n\n_.repeat('abc', 0);\n// => ''\n
\n
\n
\n\n
" } ,{ "href":"/replace", - "html":"

replace source npm

\n
_.replace([string=''], pattern, 要替换的内容)
\n\n

替换字符串中匹配的内容为给定的内容\n
\n
\n注意: 这个方法基于 String#replace

\n
\n\n

参数

\n
    \n
  1. [string=''] (string)

    待替换的字符串

    \n
  2. \n
  3. pattern (RegExp|string)

    要匹配的内容

    \n
  4. \n
  5. 要替换的内容 (Function|string)
     
  6. \n
\n

返回值 (string)

\n

返回替换完成的字符串

\n
\n

示例

\n
_.replace('Hi Fred', 'Fred', 'Barney');\n// => 'Hi Barney'\n
\n
\n
\n\n
" } + "html":"

replace source npm

\n
_.replace([string=''], pattern, 要替换的内容)
\n\n

替换字符串中匹配的内容为给定的内容\n
\n
\n注意: 这个方法基于 String#replace

\n
\n\n

参数

\n
    \n
  1. [string=''] (string)

    待替换的字符串

    \n
  2. \n
  3. pattern (RegExp|string)

    要匹配的内容

    \n
  4. \n
  5. 要替换的内容 (Function|string)
     
  6. \n
\n

返回值 (string)

\n

返回替换完成的字符串

\n
\n

示例

\n
_.replace('Hi Fred', 'Fred', 'Barney');\n// => 'Hi Barney'\n
\n
\n
\n\n
" } ,{ "href":"/snakeCase", - "html":"

snakeCase source npm

\n
_.snakeCase([string=''])
\n\n

转换字符串为 snake case

\n
\n\n

参数

\n
    \n
  1. [string=''] (string)

    要转换的字符串

    \n
  2. \n
\n

返回值 (string)

\n

返回转换后的字符串

\n
\n

示例

\n
_.snakeCase('Foo Bar');\n// => 'foo_bar'\n\n_.snakeCase('fooBar');\n// => 'foo_bar'\n\n_.snakeCase('--foo-bar');\n// => 'foo_bar'\n
\n
\n
\n\n
" } + "html":"

snakeCase source npm

\n
_.snakeCase([string=''])
\n\n

转换字符串为 snake case

\n
\n\n

参数

\n
    \n
  1. [string=''] (string)

    要转换的字符串

    \n
  2. \n
\n

返回值 (string)

\n

返回转换后的字符串

\n
\n

示例

\n
_.snakeCase('Foo Bar');\n// => 'foo_bar'\n\n_.snakeCase('fooBar');\n// => 'foo_bar'\n\n_.snakeCase('--foo-bar');\n// => 'foo_bar'\n
\n
\n
\n\n
" } ,{ "href":"/split", - "html":"

split source npm

\n
_.split([string=''], [separator], [limit])
\n\n

separator 拆分字符串\n
\n
\n注意: 这个方法基于 String#split

\n
\n\n

参数

\n
    \n
  1. [string=''] (string)

    要拆分的字符串

    \n
  2. \n
  3. [separator] (RegExp|string)

    拆分的分隔符

    \n
  4. \n
  5. [limit] (number)

    限制的数量

    \n
  6. \n
\n

返回值 (Array)

\n

返回拆分部分的字符串的数组

\n
\n

示例

\n
_.split('a-b-c', '-', 2);\n// => ['a', 'b']\n
\n
\n
\n\n
" } + "html":"

split source npm

\n
_.split([string=''], [separator], [limit])
\n\n

separator 拆分字符串\n
\n
\n注意: 这个方法基于 String#split

\n
\n\n

参数

\n
    \n
  1. [string=''] (string)

    要拆分的字符串

    \n
  2. \n
  3. [separator] (RegExp|string)

    拆分的分隔符

    \n
  4. \n
  5. [limit] (number)

    限制的数量

    \n
  6. \n
\n

返回值 (Array)

\n

返回拆分部分的字符串的数组

\n
\n

示例

\n
_.split('a-b-c', '-', 2);\n// => ['a', 'b']\n
\n
\n
\n\n
" } ,{ "href":"/startCase", - "html":"

startCase source npm

\n
_.startCase([string=''])
\n\n

转换字符串为 start case

\n
\n\n

参数

\n
    \n
  1. [string=''] (string)

    要转换的字符串

    \n
  2. \n
\n

返回值 (string)

\n

返回转换后的字符串

\n
\n

示例

\n
_.startCase('--foo-bar');\n// => 'Foo Bar'\n\n_.startCase('fooBar');\n// => 'Foo Bar'\n\n_.startCase('__foo_bar__');\n// => 'Foo Bar'\n
\n
\n
\n\n
" } + "html":"

startCase source npm

\n
_.startCase([string=''])
\n\n

转换字符串为 start case

\n
\n\n

参数

\n
    \n
  1. [string=''] (string)

    要转换的字符串

    \n
  2. \n
\n

返回值 (string)

\n

返回转换后的字符串

\n
\n

示例

\n
_.startCase('--foo-bar');\n// => 'Foo Bar'\n\n_.startCase('fooBar');\n// => 'Foo Bar'\n\n_.startCase('__foo_bar__');\n// => 'Foo Bar'\n
\n
\n
\n\n
" } ,{ "href":"/startsWith", - "html":"

startsWith source npm

\n
_.startsWith([string=''], [target], [position=0])
\n\n

检查字符串是否以 target 开头。

\n
\n\n

参数

\n
    \n
  1. [string=''] (string)

    要检索的字符串

    \n
  2. \n
  3. [target] (string)

    要检查的字符串

    \n
  4. \n
  5. [position=0] (number)

    检索的位置

    \n
  6. \n
\n

返回值 (boolean)

\n

如果符合条件返回true,否则返回 false

\n
\n

示例

\n
_.startsWith('abc', 'a');\n// => true\n\n_.startsWith('abc', 'b');\n// => false\n\n_.startsWith('abc', 'b', 1);\n// => true\n
\n
\n
\n\n
" } + "html":"

startsWith source npm

\n
_.startsWith([string=''], [target], [position=0])
\n\n

检查字符串是否以 target 开头。

\n
\n\n

参数

\n
    \n
  1. [string=''] (string)

    要检索的字符串

    \n
  2. \n
  3. [target] (string)

    要检查的字符串

    \n
  4. \n
  5. [position=0] (number)

    检索的位置

    \n
  6. \n
\n

返回值 (boolean)

\n

如果符合条件返回true,否则返回 false

\n
\n

示例

\n
_.startsWith('abc', 'a');\n// => true\n\n_.startsWith('abc', 'b');\n// => false\n\n_.startsWith('abc', 'b', 1);\n// => true\n
\n
\n
\n\n
" } ,{ "href":"/template", - "html":"

template source npm

\n
_.template([string=''], [options])
\n\n

创建一个预编译模板方法,可以插入数据到模板中 "interpolate" 分隔符相应的位置。\nHTML会在 "escape" 分隔符中转换为相应实体。\n在 "evaluate" 分隔符中允许执行JavaScript代码。\n在模板中可以自由访问变量。\n如果设置了选项对象,则会优先覆盖 _.templateSettings 的值。\n
\n
\n注意: 在开发过程中可以使用\nsourceURLs\n便于调试。\n
\n
\n了解更多预编译模板的信息查看\nlodash的自定义构建文档\n
\n
\n了解更多 Chrome 沙箱扩展的信息查看\nChrome的扩展文档

\n
\n\n

参数

\n
    \n
  1. [string=''] (string)

    模板字符串

    \n
  2. \n
  3. [options] (Object)

    选项对象

    \n
  4. \n
  5. [options.escape] (RegExp)

    "escape" 分隔符

    \n
  6. \n
  7. [options.evaluate] (RegExp)

    "evaluate" 分隔符

    \n
  8. \n
  9. [options.imports] (Object)

    导入对象到模板中作为自由变量

    \n
  10. \n
  11. [options.interpolate] (RegExp)

    "interpolate" 分隔符

    \n
  12. \n
  13. [options.sourceURL] (string)

    模板编译的来源URL

    \n
  14. \n
  15. [options.variable] (string)

    数据对象的变量名

    \n
  16. \n
\n

返回值 (Function)

\n

返回编译模板函数

\n
\n

示例

\n
// 使用 \"interpolate\" 分隔符创建编译模板\nvar compiled = _.template('hello <%= user %>!');\ncompiled({ 'user': 'fred' });\n// => 'hello fred!'\n\n// 使用 HTML \"escape\" 转义数据的值\nvar compiled = _.template('<b><%- value %></b>');\ncompiled({ 'value': '<script>' });\n// => '<b>&lt;script&gt;</b>'\n\n// 使用 \"evaluate\" 分隔符执行 JavaScript 和 生成HTML代码\nvar compiled = _.template('<% _.forEach(users, function(user) { %><li><%- user %></li><% }); %>');\ncompiled({ 'users': ['fred', 'barney'] });\n// => '<li>fred</li><li>barney</li>'\n\n// 在 \"evaluate\" 分隔符中使用内部的 `print` 函数\nvar compiled = _.template('<% print(\"hello \" + user); %>!');\ncompiled({ 'user': 'barney' });\n// => 'hello barney!'\n\n// 使用 ES 分隔符代替默认的 \"interpolate\" 分隔符\nvar compiled = _.template('hello ${ user }!');\ncompiled({ 'user': 'pebbles' });\n// => 'hello pebbles!'\n\n// 使用自定义的模板分隔符\n_.templateSettings.interpolate = /{{([\\s\\S]+?)}}/g;\nvar compiled = _.template('hello {{ user }}!');\ncompiled({ 'user': 'mustache' });\n// => 'hello mustache!'\n\n// 使用反斜杠符号作为纯文本处理\nvar compiled = _.template('<%= \"\\\\<%- value %\\\\>\" %>');\ncompiled({ 'value': 'ignored' });\n// => '<%- value %>'\n\n// 使用 `imports` 选项导入 `jq` 作为 `jQuery` 的别名\nvar text = '<% jq.each(users, function(user) { %><li><%- user %></li><% }); %>';\nvar compiled = _.template(text, { 'imports': { 'jq': jQuery } });\ncompiled({ 'users': ['fred', 'barney'] });\n// => '<li>fred</li><li>barney</li>'\n\n// 使用 `sourceURL` 选项指定模板的来源URL\nvar compiled = _.template('hello <%= user %>!', { 'sourceURL': '/basic/greeting.jst' });\ncompiled(data);\n// => 在开发工具的 Sources 选项卡 或 Resources 面板中找到 \"greeting.jst\"\n\n// 使用 `variable` 选项确保在编译模板中不声明变量\nvar compiled = _.template('hi <%= data.user %>!', { 'variable': 'data' });\ncompiled.source;\n// => function(data) {\n//   var __t, __p = '';\n//   __p += 'hi ' + ((__t = ( data.user )) == null ? '' : __t) + '!';\n//   return __p;\n// }\n\n// 使用 `source` 特性内联编译模板\n// 便以查看行号、错误信息、堆栈\nfs.writeFileSync(path.join(cwd, 'jst.js'), '\\\n  var JST = {\\\n    \"main\": ' + _.template(mainText).source + '\\\n  };\\\n');\n
\n
\n
\n\n
" } + "html":"

template source npm

\n
_.template([string=''], [options])
\n\n

创建一个预编译模板方法,可以插入数据到模板中 "interpolate" 分隔符相应的位置。\nHTML会在 "escape" 分隔符中转换为相应实体。\n在 "evaluate" 分隔符中允许执行JavaScript代码。\n在模板中可以自由访问变量。\n如果设置了选项对象,则会优先覆盖 _.templateSettings 的值。\n
\n
\n注意: 在开发过程中可以使用\nsourceURLs\n便于调试。\n
\n
\n了解更多预编译模板的信息查看\nlodash的自定义构建文档\n
\n
\n了解更多 Chrome 沙箱扩展的信息查看\nChrome的扩展文档

\n
\n\n

参数

\n
    \n
  1. [string=''] (string)

    模板字符串

    \n
  2. \n
  3. [options] (Object)

    选项对象

    \n
  4. \n
  5. [options.escape] (RegExp)

    "escape" 分隔符

    \n
  6. \n
  7. [options.evaluate] (RegExp)

    "evaluate" 分隔符

    \n
  8. \n
  9. [options.imports] (Object)

    导入对象到模板中作为自由变量

    \n
  10. \n
  11. [options.interpolate] (RegExp)

    "interpolate" 分隔符

    \n
  12. \n
  13. [options.sourceURL] (string)

    模板编译的来源URL

    \n
  14. \n
  15. [options.variable] (string)

    数据对象的变量名

    \n
  16. \n
\n

返回值 (Function)

\n

返回编译模板函数

\n
\n

示例

\n
// 使用 \"interpolate\" 分隔符创建编译模板\nvar compiled = _.template('hello <%= user %>!');\ncompiled({ 'user': 'fred' });\n// => 'hello fred!'\n\n// 使用 HTML \"escape\" 转义数据的值\nvar compiled = _.template('<b><%- value %></b>');\ncompiled({ 'value': '<script>' });\n// => '<b>&lt;script&gt;</b>'\n\n// 使用 \"evaluate\" 分隔符执行 JavaScript 和 生成HTML代码\nvar compiled = _.template('<% _.forEach(users, function(user) { %><li><%- user %></li><% }); %>');\ncompiled({ 'users': ['fred', 'barney'] });\n// => '<li>fred</li><li>barney</li>'\n\n// 在 \"evaluate\" 分隔符中使用内部的 `print` 函数\nvar compiled = _.template('<% print(\"hello \" + user); %>!');\ncompiled({ 'user': 'barney' });\n// => 'hello barney!'\n\n// 使用 ES 分隔符代替默认的 \"interpolate\" 分隔符\nvar compiled = _.template('hello ${ user }!');\ncompiled({ 'user': 'pebbles' });\n// => 'hello pebbles!'\n\n// 使用自定义的模板分隔符\n_.templateSettings.interpolate = /{{([\\s\\S]+?)}}/g;\nvar compiled = _.template('hello {{ user }}!');\ncompiled({ 'user': 'mustache' });\n// => 'hello mustache!'\n\n// 使用反斜杠符号作为纯文本处理\nvar compiled = _.template('<%= \"\\\\<%- value %\\\\>\" %>');\ncompiled({ 'value': 'ignored' });\n// => '<%- value %>'\n\n// 使用 `imports` 选项导入 `jq` 作为 `jQuery` 的别名\nvar text = '<% jq.each(users, function(user) { %><li><%- user %></li><% }); %>';\nvar compiled = _.template(text, { 'imports': { 'jq': jQuery } });\ncompiled({ 'users': ['fred', 'barney'] });\n// => '<li>fred</li><li>barney</li>'\n\n// 使用 `sourceURL` 选项指定模板的来源URL\nvar compiled = _.template('hello <%= user %>!', { 'sourceURL': '/basic/greeting.jst' });\ncompiled(data);\n// => 在开发工具的 Sources 选项卡 或 Resources 面板中找到 \"greeting.jst\"\n\n// 使用 `variable` 选项确保在编译模板中不声明变量\nvar compiled = _.template('hi <%= data.user %>!', { 'variable': 'data' });\ncompiled.source;\n// => function(data) {\n//   var __t, __p = '';\n//   __p += 'hi ' + ((__t = ( data.user )) == null ? '' : __t) + '!';\n//   return __p;\n// }\n\n// 使用 `source` 特性内联编译模板\n// 便以查看行号、错误信息、堆栈\nfs.writeFileSync(path.join(cwd, 'jst.js'), '\\\n  var JST = {\\\n    \"main\": ' + _.template(mainText).source + '\\\n  };\\\n');\n
\n
\n
\n\n
" } ,{ "href":"/toLower", - "html":"

toLower source npm

\n
_.toLower([string=''])
\n\n

转换整体的字符串为小写

\n
\n\n

参数

\n
    \n
  1. [string=''] (string)

    要转换的字符串

    \n
  2. \n
\n

返回值 (string)

\n

返回小写的字符串

\n
\n

示例

\n
_.toLower('--Foo-Bar');\n// => '--foo-bar'\n\n_.toLower('fooBar');\n// => 'foobar'\n\n_.toLower('__FOO_BAR__');\n// => '__foo_bar__'\n
\n
\n
\n\n
" } + "html":"

toLower source npm

\n
_.toLower([string=''])
\n\n

转换整体的字符串为小写

\n
\n\n

参数

\n
    \n
  1. [string=''] (string)

    要转换的字符串

    \n
  2. \n
\n

返回值 (string)

\n

返回小写的字符串

\n
\n

示例

\n
_.toLower('--Foo-Bar');\n// => '--foo-bar'\n\n_.toLower('fooBar');\n// => 'foobar'\n\n_.toLower('__FOO_BAR__');\n// => '__foo_bar__'\n
\n
\n
\n\n
" } ,{ "href":"/toUpper", - "html":"

toUpper source npm

\n
_.toUpper([string=''])
\n\n

转换整体的字符串为大写

\n
\n\n

参数

\n
    \n
  1. [string=''] (string)

    要转换的字符串

    \n
  2. \n
\n

返回值 (string)

\n

返回大写的字符串

\n
\n

示例

\n
_.toUpper('--foo-bar');\n// => '--FOO-BAR'\n\n_.toUpper('fooBar');\n// => 'FOOBAR'\n\n_.toUpper('__foo_bar__');\n// => '__FOO_BAR__'\n
\n
\n
\n\n
" } + "html":"

toUpper source npm

\n
_.toUpper([string=''])
\n\n

转换整体的字符串为大写

\n
\n\n

参数

\n
    \n
  1. [string=''] (string)

    要转换的字符串

    \n
  2. \n
\n

返回值 (string)

\n

返回大写的字符串

\n
\n

示例

\n
_.toUpper('--foo-bar');\n// => '--FOO-BAR'\n\n_.toUpper('fooBar');\n// => 'FOOBAR'\n\n_.toUpper('__foo_bar__');\n// => '__FOO_BAR__'\n
\n
\n
\n\n
" } ,{ "href":"/trim", - "html":"

trim source npm

\n
_.trim([string=''], [chars=whitespace])
\n\n

从字符串中移除前面和后面的空白 或 指定的字符。

\n
\n\n

参数

\n
    \n
  1. [string=''] (string)

    要处理的字符串

    \n
  2. \n
  3. [chars=whitespace] (string)

    要处理的字符

    \n
  4. \n
\n

返回值 (string)

\n

返回处理后的字符串

\n
\n

示例

\n
_.trim('  abc  ');\n// => 'abc'\n\n_.trim('-_-abc-_-', '_-');\n// => 'abc'\n\n_.map(['  foo  ', '  bar  '], _.trim);\n// => ['foo', 'bar']\n
\n
\n
\n\n
" } + "html":"

trim source npm

\n
_.trim([string=''], [chars=whitespace])
\n\n

从字符串中移除前面和后面的空白 或 指定的字符。

\n
\n\n

参数

\n
    \n
  1. [string=''] (string)

    要处理的字符串

    \n
  2. \n
  3. [chars=whitespace] (string)

    要处理的字符

    \n
  4. \n
\n

返回值 (string)

\n

返回处理后的字符串

\n
\n

示例

\n
_.trim('  abc  ');\n// => 'abc'\n\n_.trim('-_-abc-_-', '_-');\n// => 'abc'\n\n_.map(['  foo  ', '  bar  '], _.trim);\n// => ['foo', 'bar']\n
\n
\n
\n\n
" } ,{ "href":"/trimEnd", - "html":"

trimEnd source npm

\n
_.trimEnd([string=''], [chars=whitespace])
\n\n

移除字符串后面的空白 或 指定的字符。

\n
\n\n

参数

\n
    \n
  1. [string=''] (string)

    要处理的字符串

    \n
  2. \n
  3. [chars=whitespace] (string)

    要处理的字符

    \n
  4. \n
\n

返回值 (string)

\n

返回处理后的字符串

\n
\n

示例

\n
_.trimEnd('  abc  ');\n// => '  abc'\n\n_.trimEnd('-_-abc-_-', '_-');\n// => '-_-abc'\n
\n
\n
\n\n
" } + "html":"

trimEnd source npm

\n
_.trimEnd([string=''], [chars=whitespace])
\n\n

移除字符串后面的空白 或 指定的字符。

\n
\n\n

参数

\n
    \n
  1. [string=''] (string)

    要处理的字符串

    \n
  2. \n
  3. [chars=whitespace] (string)

    要处理的字符

    \n
  4. \n
\n

返回值 (string)

\n

返回处理后的字符串

\n
\n

示例

\n
_.trimEnd('  abc  ');\n// => '  abc'\n\n_.trimEnd('-_-abc-_-', '_-');\n// => '-_-abc'\n
\n
\n
\n\n
" } ,{ "href":"/trimStart", - "html":"

trimStart source npm

\n
_.trimStart([string=''], [chars=whitespace])
\n\n

移除字符串中前面的空白 或 指定的字符。

\n
\n\n

参数

\n
    \n
  1. [string=''] (string)

    要处理的字符串

    \n
  2. \n
  3. [chars=whitespace] (string)

    要处理的字符

    \n
  4. \n
\n

返回值 (string)

\n

返回处理后的字符串

\n
\n

示例

\n
_.trimStart('  abc  ');\n// => 'abc  '\n\n_.trimStart('-_-abc-_-', '_-');\n// => 'abc-_-'\n
\n
\n
\n\n
" } + "html":"

trimStart source npm

\n
_.trimStart([string=''], [chars=whitespace])
\n\n

移除字符串中前面的空白 或 指定的字符。

\n
\n\n

参数

\n
    \n
  1. [string=''] (string)

    要处理的字符串

    \n
  2. \n
  3. [chars=whitespace] (string)

    要处理的字符

    \n
  4. \n
\n

返回值 (string)

\n

返回处理后的字符串

\n
\n

示例

\n
_.trimStart('  abc  ');\n// => 'abc  '\n\n_.trimStart('-_-abc-_-', '_-');\n// => 'abc-_-'\n
\n
\n
\n\n
" } ,{ "href":"/truncate", - "html":"

truncate source npm

\n
_.truncate([string=''], [options])
\n\n

截断字符串,如果字符串超出了限定的最大值。\n被截断的字符串后面会以 omission 代替,omission 默认是 "..."。

\n
\n\n

参数

\n
    \n
  1. [string=''] (string)

    要截断的字符串

    \n
  2. \n
  3. [options] (Object)

    选项对象

    \n
  4. \n
  5. [options.length=30] (number)

    允许的最大长度

    \n
  6. \n
  7. [options.omission='...'] (string)

    超出后的代替字符

    \n
  8. \n
  9. [options.separator] (RegExp|string)

    截断点

    \n
  10. \n
\n

返回值 (string)

\n

返回截断后的字符串

\n
\n

示例

\n
_.truncate('hi-diddly-ho there, neighborino');\n// => 'hi-diddly-ho there, neighbo...'\n\n_.truncate('hi-diddly-ho there, neighborino', {\n  'length': 24,\n  'separator': ' '\n});\n// => 'hi-diddly-ho there,...'\n\n_.truncate('hi-diddly-ho there, neighborino', {\n  'length': 24,\n  'separator': /,? +/\n});\n// => 'hi-diddly-ho there...'\n\n_.truncate('hi-diddly-ho there, neighborino', {\n  'omission': ' [...]'\n});\n// => 'hi-diddly-ho there, neig [...]'\n
\n
\n
\n\n
" } + "html":"

truncate source npm

\n
_.truncate([string=''], [options])
\n\n

截断字符串,如果字符串超出了限定的最大值。\n被截断的字符串后面会以 omission 代替,omission 默认是 "..."。

\n
\n\n

参数

\n
    \n
  1. [string=''] (string)

    要截断的字符串

    \n
  2. \n
  3. [options] (Object)

    选项对象

    \n
  4. \n
  5. [options.length=30] (number)

    允许的最大长度

    \n
  6. \n
  7. [options.omission='...'] (string)

    超出后的代替字符

    \n
  8. \n
  9. [options.separator] (RegExp|string)

    截断点

    \n
  10. \n
\n

返回值 (string)

\n

返回截断后的字符串

\n
\n

示例

\n
_.truncate('hi-diddly-ho there, neighborino');\n// => 'hi-diddly-ho there, neighbo...'\n\n_.truncate('hi-diddly-ho there, neighborino', {\n  'length': 24,\n  'separator': ' '\n});\n// => 'hi-diddly-ho there,...'\n\n_.truncate('hi-diddly-ho there, neighborino', {\n  'length': 24,\n  'separator': /,? +/\n});\n// => 'hi-diddly-ho there...'\n\n_.truncate('hi-diddly-ho there, neighborino', {\n  'omission': ' [...]'\n});\n// => 'hi-diddly-ho there, neig [...]'\n
\n
\n
\n\n
" } ,{ "href":"/unescape", - "html":"

unescape source npm

\n
_.unescape([string=''])
\n\n

反向版 _.escape。\n这个方法转换 HTML 实体 \n&amp;, &lt;, &gt;, &quot;, &#39;, 以及 &#96; 为对应的字符。\n
\n
\n注意: 不会转换其他的 HTML 实体,需要转换可以使用类似 he 的第三方库。

\n
\n\n

参数

\n
    \n
  1. [string=''] (string)

    要转换的字符串

    \n
  2. \n
\n

返回值 (string)

\n

返回转换后的字符串

\n
\n

示例

\n
_.unescape('fred, barney, &amp; pebbles');\n// => 'fred, barney, & pebbles'\n
\n
\n
\n\n
" } + "html":"

unescape source npm

\n
_.unescape([string=''])
\n\n

反向版 _.escape。\n这个方法转换 HTML 实体 \n&amp;, &lt;, &gt;, &quot;, &#39;, 以及 &#96; 为对应的字符。\n
\n
\n注意: 不会转换其他的 HTML 实体,需要转换可以使用类似 he 的第三方库。

\n
\n\n

参数

\n
    \n
  1. [string=''] (string)

    要转换的字符串

    \n
  2. \n
\n

返回值 (string)

\n

返回转换后的字符串

\n
\n

示例

\n
_.unescape('fred, barney, &amp; pebbles');\n// => 'fred, barney, & pebbles'\n
\n
\n
\n\n
" } ,{ "href":"/upperCase", - "html":"

upperCase source npm

\n
_.upperCase([string=''])
\n\n

转换字符串为空格分割的大写单词

\n
\n\n

参数

\n
    \n
  1. [string=''] (string)

    要转换的字符串

    \n
  2. \n
\n

返回值 (string)

\n

返回大写单词

\n
\n

示例

\n
_.upperCase('--foo-bar');\n// => 'FOO BAR'\n\n_.upperCase('fooBar');\n// => 'FOO BAR'\n\n_.upperCase('__foo_bar__');\n// => 'FOO BAR'\n
\n
\n
\n\n
" } + "html":"

upperCase source npm

\n
_.upperCase([string=''])
\n\n

转换字符串为空格分割的大写单词

\n
\n\n

参数

\n
    \n
  1. [string=''] (string)

    要转换的字符串

    \n
  2. \n
\n

返回值 (string)

\n

返回大写单词

\n
\n

示例

\n
_.upperCase('--foo-bar');\n// => 'FOO BAR'\n\n_.upperCase('fooBar');\n// => 'FOO BAR'\n\n_.upperCase('__foo_bar__');\n// => 'FOO BAR'\n
\n
\n
\n\n
" } ,{ "href":"/upperFirst", - "html":"

upperFirst source npm

\n
_.upperFirst([string=''])
\n\n

转换首字母为大写。

\n
\n\n

参数

\n
    \n
  1. [string=''] (string)

    要转换的字符串

    \n
  2. \n
\n

返回值 (string)

\n

返回转换后的字符串

\n
\n

示例

\n
_.upperFirst('fred');\n// => 'Fred'\n\n_.upperFirst('FRED');\n// => 'FRED'\n
\n
\n
\n\n
" } + "html":"

upperFirst source npm

\n
_.upperFirst([string=''])
\n\n

转换首字母为大写。

\n
\n\n

参数

\n
    \n
  1. [string=''] (string)

    要转换的字符串

    \n
  2. \n
\n

返回值 (string)

\n

返回转换后的字符串

\n
\n

示例

\n
_.upperFirst('fred');\n// => 'Fred'\n\n_.upperFirst('FRED');\n// => 'FRED'\n
\n
\n
\n\n
" } ,{ "href":"/words", - "html":"

words source npm

\n
_.words([string=''], [pattern])
\n\n

拆分字符串中的词为数组

\n
\n\n

参数

\n
    \n
  1. [string=''] (string)

    要处理的字符串

    \n
  2. \n
  3. [pattern] (RegExp|string)

    匹配模式

    \n
  4. \n
\n

返回值 (Array)

\n

然后拆分后的数组

\n
\n

示例

\n
_.words('fred, barney, & pebbles');\n// => ['fred', 'barney', 'pebbles']\n\n_.words('fred, barney, & pebbles', /[^, ]+/g);\n// => ['fred', 'barney', '&', 'pebbles']\n
\n
\n
\n\n
" } + "html":"

words source npm

\n
_.words([string=''], [pattern])
\n\n

拆分字符串中的词为数组

\n
\n\n

参数

\n
    \n
  1. [string=''] (string)

    要处理的字符串

    \n
  2. \n
  3. [pattern] (RegExp|string)

    匹配模式

    \n
  4. \n
\n

返回值 (Array)

\n

然后拆分后的数组

\n
\n

示例

\n
_.words('fred, barney, & pebbles');\n// => ['fred', 'barney', 'pebbles']\n\n_.words('fred, barney, & pebbles', /[^, ]+/g);\n// => ['fred', 'barney', '&', 'pebbles']\n
\n
\n
\n\n
" } ,{ "href":"/attempt", - "html":"

attempt source npm

\n
_.attempt(func)
\n\n

Attempts to invoke func, returning either the result or the caught error\nobject. Any additional arguments are provided to func when it's invoked.

\n
\n\n

参数

\n
    \n
  1. func (Function)

    The function to attempt.

    \n
  2. \n
\n

返回值 (*)

\n

Returns the func result or error object.

\n
\n

示例

\n
// avoid throwing errors for invalid selectors\nvar elements = _.attempt(function(selector) {\n  return document.querySelectorAll(selector);\n}, '>_>');\n\nif (_.isError(elements)) {\n  elements = [];\n}\n
\n
\n
\n\n
" } + "html":"

attempt source npm

\n
_.attempt(func)
\n\n

尝试调用函数,返回结果 或者 错误对象。\n任何附加的参数都会在调用时传给函数。

\n
\n\n

参数

\n
    \n
  1. func (Function)

    要调用的函数

    \n
  2. \n
\n

返回值 (*)

\n

返回函数结果或者错误对象

\n
\n

示例

\n
// 避免因为错误的选择器而抛出\nvar elements = _.attempt(function(selector) {\n  return document.querySelectorAll(selector);\n}, '>_>');\n\nif (_.isError(elements)) {\n  elements = [];\n}\n
\n
\n
\n\n
" } ,{ "href":"/bindAll", - "html":"

bindAll source npm

\n
_.bindAll(object, methodNames)
\n\n

Binds methods of an object to the object itself, overwriting the existing\nmethod.\n
\n
\n注意: This method doesn't set the "length" property of bound functions.

\n
\n\n

参数

\n
    \n
  1. object (Object)

    The object to bind and assign the bound methods to.

    \n
  2. \n
  3. methodNames (...(string|string[])

    The object method names to bind, specified individually or in arrays.

    \n
  4. \n
\n

返回值 (Object)

\n

返回对象

\n
\n

示例

\n
var view = {\n  'label': 'docs',\n  'onClick': function() {\n    console.log('clicked ' + this.label);\n  }\n};\n\n_.bindAll(view, 'onClick');\njQuery(element).on('click', view.onClick);\n// => logs 'clicked docs' when clicked\n
\n
\n
\n\n
" } + "html":"

bindAll source npm

\n
_.bindAll(object, methodNames)
\n\n

绑定对象的方法到对象本身,覆盖已存在的方法。\n
\n
\n注意: 这个方法不会设置 "length" 属性到约束的函数。

\n
\n\n

参数

\n
    \n
  1. object (Object)

    要绑定的对象

    \n
  2. \n
  3. methodNames (...(string|string[])

    要绑定的方法名 单独指定或指定在数组中。

    \n
  4. \n
\n

返回值 (Object)

\n

返回对象

\n
\n

示例

\n
var view = {\n  'label': 'docs',\n  'onClick': function() {\n    console.log('clicked ' + this.label);\n  }\n};\n\n_.bindAll(view, 'onClick');\njQuery(element).on('click', view.onClick);\n// => logs 'clicked docs' when clicked\n
\n
\n
\n\n
" } ,{ "href":"/cond", - "html":"

cond source npm

\n
_.cond(pairs)
\n\n

Creates a function that iterates over pairs invoking the corresponding\nfunction of the first predicate to return truthy. The predicate-function\npairs are invoked with the this binding and arguments of the created\nfunction.

\n
\n\n

参数

\n
    \n
  1. pairs (Array)

    The predicate-function pairs.

    \n
  2. \n
\n

返回值 (Function)

\n

Returns the new function.

\n
\n

示例

\n
var func = _.cond([\n  [_.matches({ 'a': 1 }),           _.constant('matches A')],\n  [_.conforms({ 'b': _.isNumber }), _.constant('matches B')],\n  [_.constant(true),                _.constant('no match')]\n])\n\nfunc({ 'a': 1, 'b': 2 });\n// => 'matches A'\n\nfunc({ 'a': 0, 'b': 1 });\n// => 'matches B'\n\nfunc({ 'a': '1', 'b': '2' });\n// => 'no match'\n
\n
\n
\n\n
" } + "html":"

cond source npm

\n
_.cond(pairs)
\n\n

创建一个函数。\n这个函数会遍历 pairs,并执行最先返回真值对应的函数,并绑定 this 及传入创建函数的参数。

\n
\n\n

参数

\n
    \n
  1. pairs (Array)

    判断函数对

    \n
  2. \n
\n

返回值 (Function)

\n

返回新的函数

\n
\n

示例

\n
var func = _.cond([\n  [_.matches({ 'a': 1 }),           _.constant('matches A')],\n  [_.conforms({ 'b': _.isNumber }), _.constant('matches B')],\n  [_.constant(true),                _.constant('no match')]\n])\n\nfunc({ 'a': 1, 'b': 2 });\n// => 输出:'matches A'\n\nfunc({ 'a': 0, 'b': 1 });\n// => 输出:'matches B'\n\nfunc({ 'a': '1', 'b': '2' });\n// => 输出:'no match'\n
\n
\n
\n\n
" } ,{ "href":"/conforms", - "html":"

conforms source npm

\n
_.conforms(source)
\n\n

Creates a function that invokes the predicate properties of source with\nthe corresponding property values of a given object, returning true if\nall predicates return truthy否则返回 false

\n
\n\n

参数

\n
    \n
  1. source (Object)

    The object of property predicates to conform to.

    \n
  2. \n
\n

返回值 (Function)

\n

Returns the new function.

\n
\n

示例

\n
var users = [\n  { 'user': 'barney', 'age': 36 },\n  { 'user': 'fred',   'age': 40 }\n];\n\n_.filter(users, _.conforms({ 'age': _.partial(_.gt, _, 38) }));\n// => [{ 'user': 'fred', 'age': 40 }]\n
\n
\n
\n\n
" } + "html":"

conforms source npm

\n
_.conforms(source)
\n\n

创建一个函数。\n这个函数会调用 source 的属性名对应的 predicate 与传入对象相对应属性名的值进行 predicate 处理。\n如果都符合返回 true,否则返回 false

\n
\n\n

参数

\n
    \n
  1. source (Object)

    包含 predicates 属性值的对象

    \n
  2. \n
\n

返回值 (Function)

\n

返回新的函数

\n
\n

示例

\n
var users = [\n  { 'user': 'barney', 'age': 36 },\n  { 'user': 'fred',   'age': 40 }\n];\n\n_.filter(users, _.conforms({ 'age': _.partial(_.gt, _, 38) }));\n// => [{ 'user': 'fred', 'age': 40 }]\n
\n
\n
\n\n
" } ,{ "href":"/constant", - "html":"

constant source npm

\n
_.constant(value)
\n\n

Creates a function that returns value.

\n
\n\n

参数

\n
    \n
  1. value (*)

    The value to return from the new function.

    \n
  2. \n
\n

返回值 (Function)

\n

Returns the new function.

\n
\n

示例

\n
var object = { 'user': 'fred' };\nvar getter = _.constant(object);\n\ngetter() === object;\n// => true\n
\n
\n
\n\n
" } + "html":"

constant source npm

\n
_.constant(value)
\n\n

创建一个返回 value 的函数

\n
\n\n

参数

\n
    \n
  1. value (*)

    要返回的值

    \n
  2. \n
\n

返回值 (Function)

\n

返回新的函数

\n
\n

示例

\n
var object = { 'user': 'fred' };\nvar getter = _.constant(object);\n\ngetter() === object;\n// => true\n
\n
\n
\n\n
" } ,{ "href":"/flow", - "html":"

flow source npm

\n
_.flow([funcs])
\n\n

Creates a function that returns the result of invoking the provided\nfunctions with the this binding of the created function, where each\nsuccessive invocation is supplied the return value of the previous.

\n
\n\n

参数

\n
    \n
  1. [funcs] (...(Function|Function[])

    Functions to invoke.

    \n
  2. \n
\n

返回值 (Function)

\n

Returns the new function.

\n
\n

示例

\n
function square(n) {\n  return n * n;\n}\n\nvar addSquare = _.flow(_.add, square);\naddSquare(1, 2);\n// => 9\n
\n
\n
\n\n
" } + "html":"

flow source npm

\n
_.flow([funcs])
\n\n

创建一个函数。\n返回的结果是调用提供函数的结果,this 会绑定到创建函数。\n每一个连续调用,传入的参数都是前一个函数返回的结果。

\n
\n\n

参数

\n
    \n
  1. [funcs] (...(Function|Function[])

    要调用的函数

    \n
  2. \n
\n

返回值 (Function)

\n

返回新的函数

\n
\n

示例

\n
function square(n) {\n  return n * n;\n}\n\nvar addSquare = _.flow(_.add, square);\naddSquare(1, 2);\n// => 9\n
\n
\n
\n\n
" } ,{ "href":"/flowRight", - "html":"

flowRight source npm

\n
_.flowRight([funcs])
\n\n

这个方法类似 _.flow except that it creates a function that\ninvokes the provided functions from right to left.

\n
\n\n

参数

\n
    \n
  1. [funcs] (...(Function|Function[])

    Functions to invoke.

    \n
  2. \n
\n

返回值 (Function)

\n

Returns the new function.

\n
\n

示例

\n
function square(n) {\n  return n * n;\n}\n\nvar addSquare = _.flowRight(square, _.add);\naddSquare(1, 2);\n// => 9\n
\n
\n
\n\n
" } + "html":"

flowRight source npm

\n
_.flowRight([funcs])
\n\n

这个方法类似 _.flow,除了它调用函数的顺序是从右往左的。

\n
\n\n

参数

\n
    \n
  1. [funcs] (...(Function|Function[])

    要调用的函数

    \n
  2. \n
\n

返回值 (Function)

\n

返回新的函数

\n
\n

示例

\n
function square(n) {\n  return n * n;\n}\n\nvar addSquare = _.flowRight(square, _.add);\naddSquare(1, 2);\n// => 9\n
\n
\n
\n\n
" } ,{ "href":"/identity", - "html":"

identity source npm

\n
_.identity(value)
\n\n

This method returns the first argument provided to it.

\n
\n\n

参数

\n
    \n
  1. value (*)

    Any value.

    \n
  2. \n
\n

返回值 (*)

\n

Returns value.

\n
\n

示例

\n
var object = { 'user': 'fred' };\n\n_.identity(object) === object;\n// => true\n
\n
\n
\n\n
" } + "html":"

identity source npm

\n
_.identity(value)
\n\n

这个方法返回首个提供的参数

\n
\n\n

参数

\n
    \n
  1. value (*)

    任何值

    \n
  2. \n
\n

返回值 (*)

\n

返回 value

\n
\n

示例

\n
var object = { 'user': 'fred' };\n\n_.identity(object) === object;\n// => true\n
\n
\n
\n\n
" } ,{ "href":"/iteratee", - "html":"

iteratee source npm

\n
_.iteratee([func=_.identity])
\n\n

创建一个调用 func 的函数。 with the arguments of the created\nfunction. If func is a property name the created callback returns the\nproperty value for a given element. If func is an object the created\ncallback returns true for elements that contain the equivalent object properties, otherwise it returns false.

\n
\n\n

参数

\n
    \n
  1. [func=_.identity] (*)

    The value to convert to a callback.

    \n
  2. \n
\n

返回值 (Function)

\n

Returns the callback.

\n
\n

示例

\n
var users = [\n  { 'user': 'barney', 'age': 36 },\n  { 'user': 'fred',   'age': 40 }\n];\n\n// wrap to create custom callback shorthands\n_.iteratee = _.wrap(_.iteratee, function(callback, func, thisArg) {\n  var match = /^(.+?)__([gl]t)(.+)$/.exec(func);\n  if (!match) {\n    return callback(func, thisArg);\n  }\n  return function(object) {\n    return match[2] == 'gt'\n      ? object[match[1]] > match[3]\n      : object[match[1]] < match[3];\n  };\n});\n\n_.filter(users, 'age__gt36');\n// => [{ 'user': 'fred', 'age': 40 }]\n
\n
\n
\n\n
" } + "html":"

iteratee source npm

\n
_.iteratee([func=_.identity])
\n\n

创建一个调用 func 的函数。\n如果 func 是一个属性名,传入包含这个属性名的对象,回调返回对应属性名的值。\n如果 func 是一个对象,传入的元素有相同的对象属性,回调返回 true。\n其他情况返回 false

\n
\n\n

参数

\n
    \n
  1. [func=_.identity] (*)

    转换成 callback 的值

    \n
  2. \n
\n

返回值 (Function)

\n

返回 callback.

\n
\n

示例

\n
var users = [\n  { 'user': 'barney', 'age': 36 },\n  { 'user': 'fred',   'age': 40 }\n];\n\n// 使用 wrap 创建一个自定义回调速写\n_.iteratee = _.wrap(_.iteratee, function(callback, func, thisArg) {\n  var match = /^(.+?)__([gl]t)(.+)$/.exec(func);\n  if (!match) {\n    return callback(func, thisArg);\n  }\n  return function(object) {\n    return match[2] == 'gt'\n      ? object[match[1]] > match[3]\n      : object[match[1]] < match[3];\n  };\n});\n\n_.filter(users, 'age__gt36');\n// => [{ 'user': 'fred', 'age': 40 }]\n
\n
\n
\n\n
" } ,{ "href":"/matches", - "html":"

matches source npm

\n
_.matches(source)
\n\n

Creates a function that performs a deep partial comparison between a given\nobject and source, returning true if the given object has equivalent\nproperty values否则返回 false\n
\n
\n注意: This method supports comparing the same values as _.isEqual.

\n
\n\n

参数

\n
    \n
  1. source (Object)

    The object of property values to match.

    \n
  2. \n
\n

返回值 (Function)

\n

Returns the new function.

\n
\n

示例

\n
var users = [\n  { 'user': 'barney', 'age': 36, 'active': true },\n  { 'user': 'fred',   'age': 40, 'active': false }\n];\n\n_.filter(users, _.matches({ 'age': 40, 'active': false }));\n// => [{ 'user': 'fred', 'age': 40, 'active': false }]\n
\n
\n
\n\n
" } + "html":"

matches source npm

\n
_.matches(source)
\n\n

创建一个深比较的方法来比较给定的对象和 source 对象。\n如果给定的对象拥有相同的属性值返回 true,否则返回 false\n
\n
\n注意: 这个方法支持以 _.isEqual 的方式比较相同的值。

\n
\n\n

参数

\n
    \n
  1. source (Object)

    要匹配的源对象

    \n
  2. \n
\n

返回值 (Function)

\n

返回新的函数

\n
\n

示例

\n
var users = [\n  { 'user': 'barney', 'age': 36, 'active': true },\n  { 'user': 'fred',   'age': 40, 'active': false }\n];\n\n_.filter(users, _.matches({ 'age': 40, 'active': false }));\n// => [{ 'user': 'fred', 'age': 40, 'active': false }]\n
\n
\n
\n\n
" } ,{ "href":"/matchesProperty", - "html":"

matchesProperty source npm

\n
_.matchesProperty(path, srcValue)
\n\n

Creates a function that performs a deep partial comparison between the\nvalue at path of a given object to srcValue, returning true if the\nobject value is equivalent否则返回 false\n
\n
\n注意: This method supports comparing the same values as _.isEqual.

\n
\n\n

参数

\n
    \n
  1. path (Array|string)

    The path of the property to get.

    \n
  2. \n
  3. srcValue (*)

    The value to match.

    \n
  4. \n
\n

返回值 (Function)

\n

Returns the new function.

\n
\n

示例

\n
var users = [\n  { 'user': 'barney' },\n  { 'user': 'fred' }\n];\n\n_.find(users, _.matchesProperty('user', 'fred'));\n// => { 'user': 'fred' }\n
\n
\n
\n\n
" } + "html":"

matchesProperty source npm

\n
_.matchesProperty(path, srcValue)
\n\n

创建一个深比较的方法来比较给定对象的 path 的值是否是 srcValue。\n如果是返回 true,否则返回 false\n
\n
\n注意: 这个方法支持以 _.isEqual 的方式比较相同的值。

\n
\n\n

参数

\n
    \n
  1. path (Array|string)

    给定对象的属性路径名

    \n
  2. \n
  3. srcValue (*)

    要匹配的值

    \n
  4. \n
\n

返回值 (Function)

\n

返回新的函数

\n
\n

示例

\n
var users = [\n  { 'user': 'barney' },\n  { 'user': 'fred' }\n];\n\n_.find(users, _.matchesProperty('user', 'fred'));\n// => { 'user': 'fred' }\n
\n
\n
\n\n
" } ,{ "href":"/method", - "html":"

method source npm

\n
_.method(path, [args])
\n\n

Creates a function that invokes the method at path of a given object.\nAny additional arguments are provided to the invoked method.

\n
\n\n

参数

\n
    \n
  1. path (Array|string)

    The path of the method to invoke.

    \n
  2. \n
  3. [args] (...*)

    The arguments to invoke the method with.

    \n
  4. \n
\n

返回值 (Function)

\n

Returns the new function.

\n
\n

示例

\n
var objects = [\n  { 'a': { 'b': { 'c': _.constant(2) } } },\n  { 'a': { 'b': { 'c': _.constant(1) } } }\n];\n\n_.map(objects, _.method('a.b.c'));\n// => [2, 1]\n\n_.invokeMap(_.sortBy(objects, _.method(['a', 'b', 'c'])), 'a.b.c');\n// => [1, 2]\n
\n
\n
\n\n
" } + "html":"

method source npm

\n
_.method(path, [args])
\n\n

创建一个调用给定对象 path 上的函数。\n任何附加的参数都会传入这个调用函数中。

\n
\n\n

参数

\n
    \n
  1. path (Array|string)

    调用函数所在对象的路径

    \n
  2. \n
  3. [args] (...*)

    传递给调用函数的参数

    \n
  4. \n
\n

返回值 (Function)

\n

返回新的函数

\n
\n

示例

\n
var objects = [\n  { 'a': { 'b': { 'c': _.constant(2) } } },\n  { 'a': { 'b': { 'c': _.constant(1) } } }\n];\n\n_.map(objects, _.method('a.b.c'));\n// => [2, 1]\n\n_.invokeMap(_.sortBy(objects, _.method(['a', 'b', 'c'])), 'a.b.c');\n// => [1, 2]\n
\n
\n
\n\n
" } ,{ "href":"/methodOf", - "html":"

methodOf source npm

\n
_.methodOf(object, [args])
\n\n

The opposite of _.method; this method creates a function that invokes\nthe method at a given path of object. Any additional arguments are\nprovided to the invoked method.

\n
\n\n

参数

\n
    \n
  1. object (Object)

    要检索的对象

    \n
  2. \n
  3. [args] (...*)

    The arguments to invoke the method with.

    \n
  4. \n
\n

返回值 (Function)

\n

Returns the new function.

\n
\n

示例

\n
var array = _.times(3, _.constant),\n    object = { 'a': array, 'b': array, 'c': array };\n\n_.map(['a[2]', 'c[0]'], _.methodOf(object));\n// => [2, 0]\n\n_.map([['a', '2'], ['c', '0']], _.methodOf(object));\n// => [2, 0]\n
\n
\n
\n\n
" } + "html":"

methodOf source npm

\n
_.methodOf(object, [args])
\n\n

反向版 _.method。\n这个创建一个函数调用给定 objectpath 上的方法,\n任何附加的参数都会传入这个调用函数中。

\n
\n\n

参数

\n
    \n
  1. object (Object)

    要检索的对象

    \n
  2. \n
  3. [args] (...*)

    传递给调用函数的参数

    \n
  4. \n
\n

返回值 (Function)

\n

返回新的函数

\n
\n

示例

\n
var array = _.times(3, _.constant),\n    object = { 'a': array, 'b': array, 'c': array };\n\n_.map(['a[2]', 'c[0]'], _.methodOf(object));\n// => [2, 0]\n\n_.map([['a', '2'], ['c', '0']], _.methodOf(object));\n// => [2, 0]\n
\n
\n
\n\n
" } ,{ "href":"/mixin", - "html":"

mixin source npm

\n
_.mixin([object=lodash], source, [options])
\n\n

Adds all own enumerable function properties of a source object to the\ndestination object. If object is a function then methods are added to\nits prototype as well.\n
\n
\n注意: Use _.runInContext to create a pristine lodash function to\navoid conflicts caused by modifying the original.

\n
\n\n

参数

\n
    \n
  1. [object=lodash] (Function|Object)

    目标对象

    \n
  2. \n
  3. source (Object)

    The object of functions to add.

    \n
  4. \n
  5. [options] (Object)

    The options object.

    \n
  6. \n
  7. [options.chain=true] (boolean)

    Specify whether the functions added are chainable.

    \n
  8. \n
\n

返回值 (Function|Object)

\n

返回对象

\n
\n

示例

\n
function vowels(string) {\n  return _.filter(string, function(v) {\n    return /[aeiou]/i.test(v);\n  });\n}\n\n_.mixin({ 'vowels': vowels });\n_.vowels('fred');\n// => ['e']\n\n_('fred').vowels().value();\n// => ['e']\n\n_.mixin({ 'vowels': vowels }, { 'chain': false });\n_('fred').vowels();\n// => ['e']\n
\n
\n
\n\n
" } + "html":"

mixin source npm

\n
_.mixin([object=lodash], source, [options])
\n\n

添加来源对象自身的所有可枚举函数属性到目标对象。\n如果 object 是个函数,那么函数方法将被添加到原型链上。\n
\n
\n注意: 使用 _.runInContext 来创建原始的 lodash 函数来避免修改造成的冲突。

\n
\n\n

参数

\n
    \n
  1. [object=lodash] (Function|Object)

    目标对象

    \n
  2. \n
  3. source (Object)

    来源对象

    \n
  4. \n
  5. [options] (Object)

    选项对象

    \n
  6. \n
  7. [options.chain=true] (boolean)

    是否开启链式操作

    \n
  8. \n
\n

返回值 (Function|Object)

\n

返回对象

\n
\n

示例

\n
function vowels(string) {\n  return _.filter(string, function(v) {\n    return /[aeiou]/i.test(v);\n  });\n}\n\n_.mixin({ 'vowels': vowels });\n_.vowels('fred');\n// => ['e']\n\n_('fred').vowels().value();\n// => ['e']\n\n_.mixin({ 'vowels': vowels }, { 'chain': false });\n_('fred').vowels();\n// => ['e']\n
\n
\n
\n\n
" } ,{ "href":"/noConflict", - "html":"

noConflict source npm

\n
_.noConflict()
\n\n

Reverts the _ variable to its previous value and returns a reference to\nthe lodash function.

\n
\n\n

返回值 (Function)

\n

Returns the lodash function.

\n
\n

示例

\n
var lodash = _.noConflict();\n
\n
\n
\n\n
" } + "html":"

noConflict source npm

\n
_.noConflict()
\n\n

释放 _ 为原来的值,并返回一个 lodash 的引用

\n
\n\n

返回值 (Function)

\n

返回 lodash 函数

\n
\n

示例

\n
var lodash = _.noConflict();\n
\n
\n
\n\n
" } ,{ "href":"/noop", - "html":"

noop source npm

\n
_.noop()
\n\n

A no-operation function that returns undefined regardless of the\narguments it receives.

\n
\n\n

示例

\n
var object = { 'user': 'fred' };\n\n_.noop(object) === undefined;\n// => true\n
\n
\n
\n\n
" } + "html":"

noop source npm

\n
_.noop()
\n\n

无论传递什么参数,都返回 undefined

\n
\n\n

示例

\n
var object = { 'user': 'fred' };\n\n_.noop(object) === undefined;\n// => true\n
\n
\n
\n\n
" } ,{ "href":"/nthArg", - "html":"

nthArg source npm

\n
_.nthArg([n=0])
\n\n

Creates a function that returns its nth argument.

\n
\n\n

参数

\n
    \n
  1. [n=0] (number)

    The index of the argument to return.

    \n
  2. \n
\n

返回值 (Function)

\n

Returns the new function.

\n
\n

示例

\n
var func = _.nthArg(1);\n\nfunc('a', 'b', 'c');\n// => 'b'\n
\n
\n
\n\n
" } + "html":"

nthArg source npm

\n
_.nthArg([n=0])
\n\n

创建一个返回第 N 个参数的函数。

\n
\n\n

参数

\n
    \n
  1. [n=0] (number)

    要返回参数的索引

    \n
  2. \n
\n

返回值 (Function)

\n

返回新的函数

\n
\n

示例

\n
var func = _.nthArg(1);\n\nfunc('a', 'b', 'c');\n// => 'b'\n
\n
\n
\n\n
" } ,{ "href":"/over", - "html":"

over source npm

\n
_.over(iteratees)
\n\n

Creates a function that invokes iteratees with the arguments provided\nto the created function and returns their results.

\n
\n\n

参数

\n
    \n
  1. iteratees (...(Function|Function[])

    The iteratees to invoke.

    \n
  2. \n
\n

返回值 (Function)

\n

Returns the new function.

\n
\n

示例

\n
var func = _.over(Math.max, Math.min);\n\nfunc(1, 2, 3, 4);\n// => [4, 1]\n
\n
\n
\n\n
" } + "html":"

over source npm

\n
_.over(iteratees)
\n\n

创建一个传入提供的参数的函数并调用 iteratees 返回结果的函数。

\n
\n\n

参数

\n
    \n
  1. iteratees (...(Function|Function[])

    要调用的 iteratees

    \n
  2. \n
\n

返回值 (Function)

\n

返回新的函数

\n
\n

示例

\n
var func = _.over(Math.max, Math.min);\n\nfunc(1, 2, 3, 4);\n// => [4, 1]\n
\n
\n
\n\n
" } ,{ "href":"/overEvery", - "html":"

overEvery source npm

\n
_.overEvery(predicates)
\n\n

Creates a function that checks if all of the predicates return\ntruthy when invoked with the arguments provided to the created function.

\n
\n\n

参数

\n
    \n
  1. predicates (...(Function|Function[])

    The predicates to check.

    \n
  2. \n
\n

返回值 (Function)

\n

Returns the new function.

\n
\n

示例

\n
var func = _.overEvery(Boolean, isFinite);\n\nfunc('1');\n// => true\n\nfunc(null);\n// => false\n\nfunc(NaN);\n// => false\n
\n
\n
\n\n
" } + "html":"

overEvery source npm

\n
_.overEvery(predicates)
\n\n

创建一个传入提供的参数的函数并调用 iteratees 判断是否 全部 都为真值的函数。

\n
\n\n

参数

\n
    \n
  1. predicates (...(Function|Function[])

    要调用的 predicates

    \n
  2. \n
\n

返回值 (Function)

\n

返回新的函数

\n
\n

示例

\n
var func = _.overEvery(Boolean, isFinite);\n\nfunc('1');\n// => true\n\nfunc(null);\n// => false\n\nfunc(NaN);\n// => false\n
\n
\n
\n\n
" } ,{ "href":"/overSome", - "html":"

overSome source npm

\n
_.overSome(predicates)
\n\n

Creates a function that checks if any of the predicates return\ntruthy when invoked with the arguments provided to the created function.

\n
\n\n

参数

\n
    \n
  1. predicates (...(Function|Function[])

    The predicates to check.

    \n
  2. \n
\n

返回值 (Function)

\n

Returns the new function.

\n
\n

示例

\n
var func = _.overSome(Boolean, isFinite);\n\nfunc('1');\n// => true\n\nfunc(null);\n// => true\n\nfunc(NaN);\n// => false\n
\n
\n
\n\n
" } + "html":"

overSome source npm

\n
_.overSome(predicates)
\n\n

创建一个传入提供的参数的函数并调用 iteratees 判断是否 存在 有真值的函数。

\n
\n\n

参数

\n
    \n
  1. predicates (...(Function|Function[])

    要调用的 predicates

    \n
  2. \n
\n

返回值 (Function)

\n

返回新的函数

\n
\n

示例

\n
var func = _.overSome(Boolean, isFinite);\n\nfunc('1');\n// => true\n\nfunc(null);\n// => true\n\nfunc(NaN);\n// => false\n
\n
\n
\n\n
" } ,{ "href":"/property", - "html":"

property source npm

\n
_.property(path)
\n\n

Creates a function that returns the value at path of a given object.

\n
\n\n

参数

\n
    \n
  1. path (Array|string)

    The path of the property to get.

    \n
  2. \n
\n

返回值 (Function)

\n

Returns the new function.

\n
\n

示例

\n
var objects = [\n  { 'a': { 'b': { 'c': 2 } } },\n  { 'a': { 'b': { 'c': 1 } } }\n];\n\n_.map(objects, _.property('a.b.c'));\n// => [2, 1]\n\n_.map(_.sortBy(objects, _.property(['a', 'b', 'c'])), 'a.b.c');\n// => [1, 2]\n
\n
\n
\n\n
" } + "html":"

property source npm

\n
_.property(path)
\n\n

创建一个返回给定对象的 path 的值的函数。

\n
\n\n

参数

\n
    \n
  1. path (Array|string)

    要得到值的属性路径

    \n
  2. \n
\n

返回值 (Function)

\n

返回新的函数

\n
\n

示例

\n
var objects = [\n  { 'a': { 'b': { 'c': 2 } } },\n  { 'a': { 'b': { 'c': 1 } } }\n];\n\n_.map(objects, _.property('a.b.c'));\n// => [2, 1]\n\n_.map(_.sortBy(objects, _.property(['a', 'b', 'c'])), 'a.b.c');\n// => [1, 2]\n
\n
\n
\n\n
" } ,{ "href":"/propertyOf", - "html":"

propertyOf source npm

\n
_.propertyOf(object)
\n\n

The opposite of _.property; this method creates a function that returns\nthe value at a given path of object.

\n
\n\n

参数

\n
    \n
  1. object (Object)

    要检索的对象

    \n
  2. \n
\n

返回值 (Function)

\n

Returns the new function.

\n
\n

示例

\n
var array = [0, 1, 2],\n    object = { 'a': array, 'b': array, 'c': array };\n\n_.map(['a[2]', 'c[0]'], _.propertyOf(object));\n// => [2, 0]\n\n_.map([['a', '2'], ['c', '0']], _.propertyOf(object));\n// => [2, 0]\n
\n
\n
\n\n
" } + "html":"

propertyOf source npm

\n
_.propertyOf(object)
\n\n

反向版 _.property。\n这个方法创建的函数返回给定 path 在对象上的值。

\n
\n\n

参数

\n
    \n
  1. object (Object)

    要检索的对象

    \n
  2. \n
\n

返回值 (Function)

\n

返回新的函数

\n
\n

示例

\n
var array = [0, 1, 2],\n    object = { 'a': array, 'b': array, 'c': array };\n\n_.map(['a[2]', 'c[0]'], _.propertyOf(object));\n// => [2, 0]\n\n_.map([['a', '2'], ['c', '0']], _.propertyOf(object));\n// => [2, 0]\n
\n
\n
\n\n
" } ,{ "href":"/range", - "html":"

range source npm

\n
_.range([start=0], end, [step=1])
\n\n

Creates an array of numbers (positive and/or negative) progressing from\nstart up to, but not including, end. A step of -1 is used if a negative\nstart is specified without an end or step. If end is not specified\nit's set to start with start then set to 0. If end is less than\nstart a zero-length range is created unless a negative step is specified.\n
\n
\n注意: JavaScript follows the IEEE-754 standard for resolving\nfloating-point values which can produce unexpected results.

\n
\n\n

参数

\n
    \n
  1. [start=0] (number)

    The start of the range.

    \n
  2. \n
  3. end (number)

    The end of the range.

    \n
  4. \n
  5. [step=1] (number)

    The value to increment or decrement by.

    \n
  6. \n
\n

返回值 (Array)

\n

Returns the new array of numbers.

\n
\n

示例

\n
_.range(4);\n// => [0, 1, 2, 3]\n\n_.range(-4);\n// => [0, -1, -2, -3]\n\n_.range(1, 5);\n// => [1, 2, 3, 4]\n\n_.range(0, 20, 5);\n// => [0, 5, 10, 15]\n\n_.range(0, -4, -1);\n// => [0, -1, -2, -3]\n\n_.range(1, 4, 0);\n// => [1, 1, 1]\n\n_.range(0);\n// => []\n
\n
\n
\n\n
" } + "html":"

range source npm

\n
_.range([start=0], end, [step=1])
\n\n

创建一个包含从 startend,但不包含 end 本身范围数字的数组。\n如果 start 是负数,而 endstep 没有指定,那么 step-1 为开始。\n如果 end 没有指定,start 设置为 0。\n如果 end 小于 start,会创建一个空数组,除非指定了 step。\n
\n
\n注意: JavaScript 遵循 IEEE-754 标准处理无法预料的浮点数结果。

\n
\n\n

参数

\n
    \n
  1. [start=0] (number)

    开始的范围

    \n
  2. \n
  3. end (number)

    结束的范围

    \n
  4. \n
  5. [step=1] (number)

    范围的增量 或者 减量

    \n
  6. \n
\n

返回值 (Array)

\n

返回范围内数字组成的新数组

\n
\n

示例

\n
_.range(4);\n// => [0, 1, 2, 3]\n\n_.range(-4);\n// => [0, -1, -2, -3]\n\n_.range(1, 5);\n// => [1, 2, 3, 4]\n\n_.range(0, 20, 5);\n// => [0, 5, 10, 15]\n\n_.range(0, -4, -1);\n// => [0, -1, -2, -3]\n\n_.range(1, 4, 0);\n// => [1, 1, 1]\n\n_.range(0);\n// => []\n
\n
\n
\n\n
" } ,{ "href":"/rangeRight", - "html":"

rangeRight source npm

\n
_.rangeRight([start=0], end, [step=1])
\n\n

这个方法类似 _.range except that it populates values in\ndescending order.

\n
\n\n

参数

\n
    \n
  1. [start=0] (number)

    The start of the range.

    \n
  2. \n
  3. end (number)

    The end of the range.

    \n
  4. \n
  5. [step=1] (number)

    The value to increment or decrement by.

    \n
  6. \n
\n

返回值 (Array)

\n

Returns the new array of numbers.

\n
\n

示例

\n
_.rangeRight(4);\n// => [3, 2, 1, 0]\n\n_.rangeRight(-4);\n// => [-3, -2, -1, 0]\n\n_.rangeRight(1, 5);\n// => [4, 3, 2, 1]\n\n_.rangeRight(0, 20, 5);\n// => [15, 10, 5, 0]\n\n_.rangeRight(0, -4, -1);\n// => [-3, -2, -1, 0]\n\n_.rangeRight(1, 4, 0);\n// => [1, 1, 1]\n\n_.rangeRight(0);\n// => []\n
\n
\n
\n\n
" } + "html":"

rangeRight source npm

\n
_.rangeRight([start=0], end, [step=1])
\n\n

这个方法类似 _.range,\n除了它是降序生成值的。

\n
\n\n

参数

\n
    \n
  1. [start=0] (number)

    开始的范围

    \n
  2. \n
  3. end (number)

    结束的范围

    \n
  4. \n
  5. [step=1] (number)

    范围的增量 或者 减量

    \n
  6. \n
\n

返回值 (Array)

\n

返回范围内数字组成的新数组

\n
\n

示例

\n
_.rangeRight(4);\n// => [3, 2, 1, 0]\n\n_.rangeRight(-4);\n// => [-3, -2, -1, 0]\n\n_.rangeRight(1, 5);\n// => [4, 3, 2, 1]\n\n_.rangeRight(0, 20, 5);\n// => [15, 10, 5, 0]\n\n_.rangeRight(0, -4, -1);\n// => [-3, -2, -1, 0]\n\n_.rangeRight(1, 4, 0);\n// => [1, 1, 1]\n\n_.rangeRight(0);\n// => []\n
\n
\n
\n\n
" } ,{ "href":"/runInContext", "html":"

runInContext source npm

\n
_.runInContext([context=root])
\n\n

Create a new pristine lodash function 使用 context object.

\n
\n\n

参数

\n
    \n
  1. [context=root] (Object)

    The context object.

    \n
  2. \n
\n

返回值 (Function)

\n

Returns a new lodash function.

\n
\n

示例

\n
_.mixin({ 'foo': _.constant('foo') });\n\nvar lodash = _.runInContext();\nlodash.mixin({ 'bar': lodash.constant('bar') });\n\n_.isFunction(_.foo);\n// => true\n_.isFunction(_.bar);\n// => false\n\nlodash.isFunction(lodash.foo);\n// => false\nlodash.isFunction(lodash.bar);\n// => true\n\n// using `context` to mock `Date#getTime` use in `_.now`\nvar mock = _.runInContext({\n  'Date': function() {\n    return { 'getTime': getTimeMock };\n  }\n});\n\n// or creating a suped-up `defer` in Node.js\nvar defer = _.runInContext({ 'setTimeout': setImmediate }).defer;\n
\n
\n
\n\n
" } ,{ "href":"/times", - "html":"

times source npm

\n
_.times(n, [iteratee=_.identity])
\n\n

Invokes the iteratee function n times, returning an array of the results\nof each invocation. The iteratee is invoked with one argument; (index).

\n
\n\n

参数

\n
    \n
  1. n (number)

    The number of times to invoke iteratee.

    \n
  2. \n
  3. [iteratee=_.identity] (Function)

    这个函数会处理每一个元素

    \n
  4. \n
\n

返回值 (Array)

\n

Returns the array of results.

\n
\n

示例

\n
_.times(3, String);\n// => ['0', '1', '2']\n\n _.times(4, _.constant(true));\n// => [true, true, true, true]\n
\n
\n
\n\n
" } + "html":"

times source npm

\n
_.times(n, [iteratee=_.identity])
\n\n

调用 iteratee N 次,每次调用返回的结果存入到数组中。\niteratee 会传入1个参数:(index)。

\n
\n\n

参数

\n
    \n
  1. n (number)

    要调用 iteratee 的次数

    \n
  2. \n
  3. [iteratee=_.identity] (Function)

    这个函数会处理每一个元素

    \n
  4. \n
\n

返回值 (Array)

\n

返回调用结果的数组

\n
\n

示例

\n
_.times(3, String);\n// => ['0', '1', '2']\n\n _.times(4, _.constant(true));\n// => [true, true, true, true]\n
\n
\n
\n\n
" } ,{ "href":"/toPath", - "html":"

toPath source npm

\n
_.toPath(value)
\n\n

Converts value to a property path array.

\n
\n\n

参数

\n
    \n
  1. value (*)

    The value to convert.

    \n
  2. \n
\n

返回值 (Array)

\n

Returns the new property path array.

\n
\n

示例

\n
_.toPath('a.b.c');\n// => ['a', 'b', 'c']\n\n_.toPath('a[0].b.c');\n// => ['a', '0', 'b', 'c']\n\nvar path = ['a', 'b', 'c'],\n    newPath = _.toPath(path);\n\nconsole.log(newPath);\n// => ['a', 'b', 'c']\n\nconsole.log(path === newPath);\n// => false\n
\n
\n
\n\n
" } + "html":"

toPath source npm

\n
_.toPath(value)
\n\n

创建 value 为属性路径的数组

\n
\n\n

参数

\n
    \n
  1. value (*)

    要转换的值

    \n
  2. \n
\n

返回值 (Array)

\n

返回包含属性路径的数组

\n
\n

示例

\n
_.toPath('a.b.c');\n// => ['a', 'b', 'c']\n\n_.toPath('a[0].b.c');\n// => ['a', '0', 'b', 'c']\n\nvar path = ['a', 'b', 'c'],\n    newPath = _.toPath(path);\n\nconsole.log(newPath);\n// => ['a', 'b', 'c']\n\nconsole.log(path === newPath);\n// => false\n
\n
\n
\n\n
" } ,{ "href":"/uniqueId", - "html":"

uniqueId source npm

\n
_.uniqueId([prefix])
\n\n

Generates a unique ID. If prefix is provided the ID is appended to it.

\n
\n\n

参数

\n
    \n
  1. [prefix] (string)

    The value to prefix the ID with.

    \n
  2. \n
\n

返回值 (string)

\n

Returns the unique ID.

\n
\n

示例

\n
_.uniqueId('contact_');\n// => 'contact_104'\n\n_.uniqueId();\n// => '105'\n
\n
\n
\n\n
" } + "html":"

uniqueId source npm

\n
_.uniqueId([prefix])
\n\n

创建唯一ID。\n如果提供了 prefix,会被添加到ID前缀上。

\n
\n\n

参数

\n
    \n
  1. [prefix] (string)

    要添加到ID前缀的值

    \n
  2. \n
\n

返回值 (string)

\n

返回唯一ID

\n
\n

示例

\n
_.uniqueId('contact_');\n// => 'contact_104'\n\n_.uniqueId();\n// => '105'\n
\n
\n
\n\n
" } ] \ No newline at end of file diff --git a/parseInt.html b/parseInt.html index 472258a..7e71f3a 100644 --- a/parseInt.html +++ b/parseInt.html @@ -392,7 +392,7 @@
-

parseInt source npm

+

parseInt source npm

_.parseInt(string, [radix])

以指定的基数转换字符串为整数。 diff --git a/partial.html b/partial.html index b504929..cdb63c3 100644 --- a/partial.html +++ b/partial.html @@ -392,17 +392,13 @@

-

partial source npm

+

partial source npm

_.partial(func, [partials])

创建一个函数。 该函数调用 func,并传入预设的参数。 这个方法类似 _.bind,除了它不会绑定 this。 -
-
-
-
-这个 .partial.placeholder 的值,默认是以 作为附加部分参数的占位符。 +这个 _.partial.placeholder 的值,默认是以 _ 作为附加部分参数的占位符。

注意: 这个方法不会设置 "length" 到函数上。

diff --git a/partialRight.html b/partialRight.html index 3db4eb7..128e2b0 100644 --- a/partialRight.html +++ b/partialRight.html @@ -392,14 +392,10 @@
-

partialRight source npm

+

partialRight source npm

_.partialRight(func, [partials])

这个函数类似 _.partial,除了它是从右到左预设参数的。 -
-
-
-
这个 .partialRight.placeholder 的值,默认是以 作为附加部分参数的占位符。

diff --git a/pick.html b/pick.html index b1d1f2c..facbeee 100644 --- a/pick.html +++ b/pick.html @@ -392,7 +392,7 @@

-

pick source npm

+

pick source npm

_.pick(object, [props])

创建一个从 object 中选中的属性的对象。

diff --git a/pickBy.html b/pickBy.html index 4c3d525..5a474a8 100644 --- a/pickBy.html +++ b/pickBy.html @@ -392,7 +392,7 @@
-

pickBy source npm

+

pickBy source npm

_.pickBy(object, [predicate=_.identity])

创建一个从 object 中经 predicate 判断为真值的属性为对象。 diff --git a/property.html b/property.html index 30f784f..923f28b 100644 --- a/property.html +++ b/property.html @@ -392,19 +392,19 @@

-

property source npm

+

property source npm

_.property(path)
-

Creates a function that returns the value at path of a given object.

+

创建一个返回给定对象的 path 的值的函数。

参数

    -
  1. path (Array|string)

    The path of the property to get.

    +
  2. path (Array|string)

    要得到值的属性路径

返回值 (Function)

-

Returns the new function.

+

返回新的函数

示例

var objects = [
diff --git a/propertyOf.html b/propertyOf.html
index b59496c..0f0a026 100644
--- a/propertyOf.html
+++ b/propertyOf.html
@@ -392,11 +392,11 @@
 
 
-

propertyOf source npm

+

propertyOf source npm

_.propertyOf(object)
-

The opposite of _.property; this method creates a function that returns -the value at a given path of object.

+

反向版 _.property。 +这个方法创建的函数返回给定 path 在对象上的值。

参数

@@ -405,7 +405,7 @@

参数

返回值 (Function)

-

Returns the new function.

+

返回新的函数

示例

var array = [0, 1, 2],
diff --git a/random.html b/random.html
index 6bb1ab0..f6b83fb 100644
--- a/random.html
+++ b/random.html
@@ -392,7 +392,7 @@
 
 
-

random source npm

+

random source npm

_.random([min=0], [max=1], [floating])

产生一个包括 minmax 之间的数。 diff --git a/range.html b/range.html index 7b9cf32..c0a99e8 100644 --- a/range.html +++ b/range.html @@ -392,31 +392,29 @@

-

range source npm

+

range source npm

_.range([start=0], end, [step=1])
-

Creates an array of numbers (positive and/or negative) progressing from -start up to, but not including, end. A step of -1 is used if a negative -start is specified without an end or step. If end is not specified -it's set to start with start then set to 0. If end is less than -start a zero-length range is created unless a negative step is specified. +

创建一个包含从 startend,但不包含 end 本身范围数字的数组。 +如果 start 是负数,而 endstep 没有指定,那么 step-1 为开始。 +如果 end 没有指定,start 设置为 0。 +如果 end 小于 start,会创建一个空数组,除非指定了 step

-注意: JavaScript follows the IEEE-754 standard for resolving -floating-point values which can produce unexpected results.

+注意: JavaScript 遵循 IEEE-754 标准处理无法预料的浮点数结果。

参数

    -
  1. [start=0] (number)

    The start of the range.

    +
  2. [start=0] (number)

    开始的范围

  3. -
  4. end (number)

    The end of the range.

    +
  5. end (number)

    结束的范围

  6. -
  7. [step=1] (number)

    The value to increment or decrement by.

    +
  8. [step=1] (number)

    范围的增量 或者 减量

返回值 (Array)

-

Returns the new array of numbers.

+

返回范围内数字组成的新数组

示例

_.range(4);
diff --git a/rangeRight.html b/rangeRight.html
index 01f8466..063cf0c 100644
--- a/rangeRight.html
+++ b/rangeRight.html
@@ -392,24 +392,24 @@
 
 
-

rangeRight source npm

+

rangeRight source npm

_.rangeRight([start=0], end, [step=1])
-

这个方法类似 _.range except that it populates values in -descending order.

+

这个方法类似 _.range, +除了它是降序生成值的。

参数

    -
  1. [start=0] (number)

    The start of the range.

    +
  2. [start=0] (number)

    开始的范围

  3. -
  4. end (number)

    The end of the range.

    +
  5. end (number)

    结束的范围

  6. -
  7. [step=1] (number)

    The value to increment or decrement by.

    +
  8. [step=1] (number)

    范围的增量 或者 减量

返回值 (Array)

-

Returns the new array of numbers.

+

返回范围内数字组成的新数组

示例

_.rangeRight(4);
diff --git a/rearg.html b/rearg.html
index d598111..29bfdd9 100644
--- a/rearg.html
+++ b/rearg.html
@@ -392,7 +392,7 @@
 
 
-

rearg source npm

+

rearg source npm

_.rearg(func, indexes)

创建一个调用 func 的函数。 diff --git a/repeat.html b/repeat.html index f0cef2c..20430cf 100644 --- a/repeat.html +++ b/repeat.html @@ -392,7 +392,7 @@

-

repeat source npm

+

repeat source npm

_.repeat([string=''], [n=0])

重复 N 次字符串

diff --git a/replace.html b/replace.html index 1089b88..d929f9e 100644 --- a/replace.html +++ b/replace.html @@ -392,7 +392,7 @@
-

replace source npm

+

replace source npm

_.replace([string=''], pattern, 要替换的内容)

替换字符串中匹配的内容为给定的内容 diff --git a/rest.html b/rest.html index 17eb7a9..d5432de 100644 --- a/rest.html +++ b/rest.html @@ -392,7 +392,7 @@

-

rest source npm

+

rest source npm

_.rest(func, [start=func.length-1])

创建一个调用 func 的函数。 diff --git a/result.html b/result.html index 2dbc546..c240ddf 100644 --- a/result.html +++ b/result.html @@ -392,7 +392,7 @@

-

result source npm

+

result source npm

_.result(object, path, [defaultValue])

这个方法类似 _.get。 diff --git a/round.html b/round.html index ac299f4..95c6175 100644 --- a/round.html +++ b/round.html @@ -392,7 +392,7 @@

-

round source npm

+

round source npm

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

根据 precision 四舍五入 number。

diff --git a/set.html b/set.html index 5e3daa2..82b9cb1 100644 --- a/set.html +++ b/set.html @@ -392,7 +392,7 @@
-

set source npm

+

set source npm

_.set(object, path, value)

设置值到对象对应的属性路径上,如果没有则创建这部分路径。 diff --git a/setWith.html b/setWith.html index 50b4ed3..8bdbbac 100644 --- a/setWith.html +++ b/setWith.html @@ -392,7 +392,7 @@

-

setWith source npm

+

setWith source npm

_.setWith(object, path, value, [customizer])

这个方法类似 _.set。 diff --git a/snakeCase.html b/snakeCase.html index c92fda6..1a39326 100644 --- a/snakeCase.html +++ b/snakeCase.html @@ -392,7 +392,7 @@

-

snakeCase source npm

+

snakeCase source npm

_.snakeCase([string=''])

转换字符串为 snake case

diff --git a/split.html b/split.html index 07bb580..782af2a 100644 --- a/split.html +++ b/split.html @@ -392,7 +392,7 @@
-

split source npm

+

split source npm

_.split([string=''], [separator], [limit])

separator 拆分字符串 diff --git a/spread.html b/spread.html index 6ed9a07..2b07711 100644 --- a/spread.html +++ b/spread.html @@ -392,7 +392,7 @@

-

spread source npm

+

spread source npm

_.spread(func)

创建一个调用 func 的函数。 this 绑定到这个函数上。 diff --git a/startCase.html b/startCase.html index 2a9ef27..3ddcc45 100644 --- a/startCase.html +++ b/startCase.html @@ -392,7 +392,7 @@

-

startCase source npm

+

startCase source npm

_.startCase([string=''])

转换字符串为 start case

diff --git a/startsWith.html b/startsWith.html index 7cff23e..5ad943e 100644 --- a/startsWith.html +++ b/startsWith.html @@ -392,7 +392,7 @@
-

startsWith source npm

+

startsWith source npm

_.startsWith([string=''], [target], [position=0])

检查字符串是否以 target 开头。

diff --git a/subtract.html b/subtract.html index 1adbc61..0d5932a 100644 --- a/subtract.html +++ b/subtract.html @@ -392,7 +392,7 @@
-

subtract source npm

+

subtract source npm

_.subtract(minuend, subtrahend)

两双相减

diff --git a/sum.html b/sum.html index ead61cc..cf828cf 100644 --- a/sum.html +++ b/sum.html @@ -392,7 +392,7 @@
-

sum source npm

+

sum source npm

_.sum(array)

计算 array 中值的总和

diff --git a/sumBy.html b/sumBy.html index 3952d3f..9643ed4 100644 --- a/sumBy.html +++ b/sumBy.html @@ -392,7 +392,7 @@
-

sumBy source npm

+

sumBy source npm

_.sumBy(array, [iteratee=_.identity])

这个方法类似 _.sum。 diff --git a/template.html b/template.html index 978af77..f8ed657 100644 --- a/template.html +++ b/template.html @@ -392,7 +392,7 @@

-

template source npm

+

template source npm

_.template([string=''], [options])

创建一个预编译模板方法,可以插入数据到模板中 "interpolate" 分隔符相应的位置。 diff --git a/throttle.html b/throttle.html index 33c02b4..38109d2 100644 --- a/throttle.html +++ b/throttle.html @@ -392,7 +392,7 @@

-

throttle source npm

+

throttle source npm

_.throttle(func, [wait=0], [options])

创建一个节流函数,在 wait 秒内最多执行 func 一次的函数。 diff --git a/times.html b/times.html index 734fe8c..477dc7a 100644 --- a/times.html +++ b/times.html @@ -392,22 +392,22 @@

-

times source npm

+

times source npm

_.times(n, [iteratee=_.identity])
-

Invokes the iteratee function n times, returning an array of the results -of each invocation. The iteratee is invoked with one argument; (index).

+

调用 iteratee N 次,每次调用返回的结果存入到数组中。 +iteratee 会传入1个参数:(index)。

参数

    -
  1. n (number)

    The number of times to invoke iteratee.

    +
  2. n (number)

    要调用 iteratee 的次数

  3. [iteratee=_.identity] (Function)

    这个函数会处理每一个元素

返回值 (Array)

-

Returns the array of results.

+

返回调用结果的数组

示例

_.times(3, String);
diff --git a/toArray.html b/toArray.html
index 03b0369..1d7cfe5 100644
--- a/toArray.html
+++ b/toArray.html
@@ -392,7 +392,7 @@
 
 
-

toArray source npm

+

toArray source npm

_.toArray(value)

转换 value 为数组

diff --git a/toInteger.html b/toInteger.html index af0cf21..4742cc0 100644 --- a/toInteger.html +++ b/toInteger.html @@ -392,7 +392,7 @@
-

toInteger source npm

+

toInteger source npm

_.toInteger(value)

转换 value 为整数 diff --git a/toLength.html b/toLength.html index a7986e9..64d21f7 100644 --- a/toLength.html +++ b/toLength.html @@ -392,7 +392,7 @@

-

toLength source npm

+

toLength source npm

_.toLength(value)

转换 value 为用作类数组对象的长度整数。 diff --git a/toLower.html b/toLower.html index ed3face..0e95855 100644 --- a/toLower.html +++ b/toLower.html @@ -392,7 +392,7 @@

-

toLower source npm

+

toLower source npm

_.toLower([string=''])

转换整体的字符串为小写

diff --git a/toNumber.html b/toNumber.html index 51edd3b..b3b8440 100644 --- a/toNumber.html +++ b/toNumber.html @@ -392,7 +392,7 @@
-

toNumber source npm

+

toNumber source npm

_.toNumber(value)

转换 value 为数值

diff --git a/toPairs.html b/toPairs.html index ca30fea..d0e919f 100644 --- a/toPairs.html +++ b/toPairs.html @@ -392,7 +392,7 @@
-

toPairs source npm

+

toPairs source npm

_.toPairs(object)

创建一个对象自身可枚举属性的键值对数组。

diff --git a/toPairsIn.html b/toPairsIn.html index 33fa4e4..3ae61cd 100644 --- a/toPairsIn.html +++ b/toPairsIn.html @@ -392,7 +392,7 @@
-

toPairsIn source npm

+

toPairsIn source npm

_.toPairsIn(object)

创建一个对象自身和继承的可枚举属性的键值对数组。

diff --git a/toPath.html b/toPath.html index dce5ec1..43fe4aa 100644 --- a/toPath.html +++ b/toPath.html @@ -392,19 +392,19 @@
-

toPath source npm

+

toPath source npm

_.toPath(value)
-

Converts value to a property path array.

+

创建 value 为属性路径的数组

参数

    -
  1. value (*)

    The value to convert.

    +
  2. value (*)

    要转换的值

返回值 (Array)

-

Returns the new property path array.

+

返回包含属性路径的数组

示例

_.toPath('a.b.c');
diff --git a/toPlainObject.html b/toPlainObject.html
index c94f2bc..2901834 100644
--- a/toPlainObject.html
+++ b/toPlainObject.html
@@ -392,7 +392,7 @@
 
 
-

toPlainObject source npm

+

toPlainObject source npm

_.toPlainObject(value)

转换 value 为普通对象。 diff --git a/toSafeInteger.html b/toSafeInteger.html index c54894e..051373c 100644 --- a/toSafeInteger.html +++ b/toSafeInteger.html @@ -392,7 +392,7 @@

-

toSafeInteger source npm

+

toSafeInteger source npm

_.toSafeInteger(value)

转换 value 为安全整数。 diff --git a/toString.html b/toString.html index 8f0bc48..93e72bf 100644 --- a/toString.html +++ b/toString.html @@ -392,7 +392,7 @@

-

toString source npm

+

toString source npm

_.toString(value)

如果 value 不是字符串,将其转换为字符串。 diff --git a/toUpper.html b/toUpper.html index c9c7a5d..003a245 100644 --- a/toUpper.html +++ b/toUpper.html @@ -392,7 +392,7 @@

-

toUpper source npm

+

toUpper source npm

_.toUpper([string=''])

转换整体的字符串为大写

diff --git a/transform.html b/transform.html index b1a4555..a6ccf3e 100644 --- a/transform.html +++ b/transform.html @@ -392,7 +392,7 @@
-

transform source npm

+

transform source npm

_.transform(object, [iteratee=_.identity], [accumulator])

_.reduce 的代替方法。 diff --git a/trim.html b/trim.html index bbacb35..ffb1856 100644 --- a/trim.html +++ b/trim.html @@ -392,7 +392,7 @@

-

trim source npm

+

trim source npm

_.trim([string=''], [chars=whitespace])

从字符串中移除前面和后面的空白 或 指定的字符。

diff --git a/trimEnd.html b/trimEnd.html index a899aaf..338d109 100644 --- a/trimEnd.html +++ b/trimEnd.html @@ -392,7 +392,7 @@
-

trimEnd source npm

+

trimEnd source npm

_.trimEnd([string=''], [chars=whitespace])

移除字符串后面的空白 或 指定的字符。

diff --git a/trimStart.html b/trimStart.html index c517b20..69372c8 100644 --- a/trimStart.html +++ b/trimStart.html @@ -392,7 +392,7 @@
-

trimStart source npm

+

trimStart source npm

_.trimStart([string=''], [chars=whitespace])

移除字符串中前面的空白 或 指定的字符。

diff --git a/truncate.html b/truncate.html index 8caa6cb..482e0f9 100644 --- a/truncate.html +++ b/truncate.html @@ -392,7 +392,7 @@
-

truncate source npm

+

truncate source npm

_.truncate([string=''], [options])

截断字符串,如果字符串超出了限定的最大值。 diff --git a/unary.html b/unary.html index 52c6dd4..391aa45 100644 --- a/unary.html +++ b/unary.html @@ -392,7 +392,7 @@

-

unary source npm

+

unary source npm

_.unary(func)

创建一个最多接受一个参数的函数,忽略多余的参数。

diff --git a/unescape.html b/unescape.html index 162e917..ce08a35 100644 --- a/unescape.html +++ b/unescape.html @@ -392,7 +392,7 @@
-

unescape source npm

+

unescape source npm

_.unescape([string=''])

反向版 _.escape。 diff --git a/uniqueId.html b/uniqueId.html index bf861af..fada2ad 100644 --- a/uniqueId.html +++ b/uniqueId.html @@ -392,19 +392,20 @@

-

uniqueId source npm

+

uniqueId source npm

_.uniqueId([prefix])
-

Generates a unique ID. If prefix is provided the ID is appended to it.

+

创建唯一ID。 +如果提供了 prefix,会被添加到ID前缀上。

参数

    -
  1. [prefix] (string)

    The value to prefix the ID with.

    +
  2. [prefix] (string)

    要添加到ID前缀的值

返回值 (string)

-

Returns the unique ID.

+

返回唯一ID

示例

_.uniqueId('contact_');
diff --git a/unset.html b/unset.html
index 372043e..909954f 100644
--- a/unset.html
+++ b/unset.html
@@ -392,7 +392,7 @@
 
 
-

unset source npm

+

unset source npm

_.unset(object, path)

移除对象路径的属性。

diff --git a/upperCase.html b/upperCase.html index db8d776..fcdf9b4 100644 --- a/upperCase.html +++ b/upperCase.html @@ -392,7 +392,7 @@
-

upperCase source npm

+

upperCase source npm

_.upperCase([string=''])

转换字符串为空格分割的大写单词

diff --git a/upperFirst.html b/upperFirst.html index e06e32e..9fa4b75 100644 --- a/upperFirst.html +++ b/upperFirst.html @@ -392,7 +392,7 @@
-

upperFirst source npm

+

upperFirst source npm

_.upperFirst([string=''])

转换首字母为大写。

diff --git a/values.html b/values.html index da7a345..93f77e5 100644 --- a/values.html +++ b/values.html @@ -392,7 +392,7 @@
-

values source npm

+

values source npm

_.values(object)

创建 object 自身可枚举属性的值为数组 diff --git a/valuesIn.html b/valuesIn.html index f9fd216..ac21475 100644 --- a/valuesIn.html +++ b/valuesIn.html @@ -392,7 +392,7 @@

-

valuesIn source npm

+

valuesIn source npm

_.valuesIn(object)

创建 object 自身和继承的可枚举属性的值为数组 diff --git a/words.html b/words.html index 99d4282..c246912 100644 --- a/words.html +++ b/words.html @@ -392,7 +392,7 @@

-

words source npm

+

words source npm

_.words([string=''], [pattern])

拆分字符串中的词为数组

diff --git a/wrap.html b/wrap.html index 6d43295..40f0876 100644 --- a/wrap.html +++ b/wrap.html @@ -392,7 +392,7 @@
-

wrap source npm

+

wrap source npm

_.wrap(value, wrapper)

创建一个函数。提供的 value 包装在 wrapper 函数的第一个参数里。