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

Add iteration order note to _.pluck doc and adjust similar notes. [closes #703] [ci skip]

Browse Source
This commit is contained in:
John-David Dalton
2014-09-12 09:43:32 -07:00
parent 3b36145257
commit adcadf08d1
1 changed files with 15 additions and 11 deletions
Download Patch File Download Diff File Expand all files Collapse all files

26
lodash.js
View File

@@ -4945,7 +4945,7 @@
* // => logs each value and returns the array
*
* _.forEach({ 'one': 1, 'two': 2, 'three': 3 }, function(n, key) { console.log(n, key); });
* // => logs each value-key pair and returns the object (property order is not guaranteed)
* // => logs each value-key pair and returns the object (iteration order is not guaranteed)
*/
function forEach(collection, iteratee, thisArg) {
return (typeof iteratee == 'function' && typeof thisArg == 'undefined' && isArray(collection))
@@ -5116,7 +5116,7 @@
* // => [3, 6, 9]
*
* _.map({ 'one': 1, 'two': 2, 'three': 3 }, function(n) { return n * 3; });
* // => [3, 6, 9] (property order is not guaranteed)
* // => [3, 6, 9] (iteration order is not guaranteed)
*
* var users = [
* { 'user': 'barney', 'age': 36 },
@@ -5366,6 +5366,10 @@
*
* _.pluck(users, 'user');
* // => ['barney', 'fred']
*
* var userIndex = _.indexBy(users, 'user');
* _.pluck(userIndex, 'age');
* // => [36, 40] (iteration order is not guaranteed)
*/
function pluck(collection, key) {
return map(collection, property(key));
@@ -5397,7 +5401,7 @@
* result[key] = n * 3;
* return result;
* }, {});
* // => { 'a': 3, 'b': 6, 'c': 9 } (property order is not guaranteed)
* // => { 'a': 3, 'b': 6, 'c': 9 } (iteration order is not guaranteed)
*/
function reduce(collection, iteratee, accumulator, thisArg) {
var func = isArray(collection) ? arrayReduce : baseReduce;
@@ -7340,7 +7344,7 @@
* _.findKey(users, function(chr) {
* return chr.age < 40;
* });
* // => 'barney' (property order is not guaranteed)
* // => 'barney' (iteration order is not guaranteed)
*
* // using "_.where" callback shorthand
* _.findKey(users, { 'age': 1 });
@@ -7426,7 +7430,7 @@
* _.forIn(new Shape, function(value, key) {
* console.log(key);
* });
* // => logs 'x', 'y', and 'z' (property order is not guaranteed)
* // => logs 'x', 'y', and 'z' (iteration order is not guaranteed)
*/
function forIn(object, iteratee, thisArg) {
if (typeof iteratee != 'function' || typeof thisArg != 'undefined') {
@@ -7483,7 +7487,7 @@
* _.forOwn({ '0': 'zero', '1': 'one', 'length': 2 }, function(n, key) {
* console.log(key);
* });
* // => logs '0', '1', and 'length' (property order is not guaranteed)
* // => logs '0', '1', and 'length' (iteration order is not guaranteed)
*/
function forOwn(object, iteratee, thisArg) {
if (typeof iteratee != 'function' || typeof thisArg != 'undefined') {
@@ -7620,7 +7624,7 @@
* Shape.prototype.z = 0;
*
* _.keys(new Shape);
* // => ['x', 'y'] (property order is not guaranteed)
* // => ['x', 'y'] (iteration order is not guaranteed)
*/
var keys = !nativeKeys ? shimKeys : function(object) {
object = toObject(object);
@@ -7654,7 +7658,7 @@
* Shape.prototype.z = 0;
*
* _.keysIn(new Shape);
* // => ['x', 'y', 'z'] (property order is not guaranteed)
* // => ['x', 'y', 'z'] (iteration order is not guaranteed)
*/
function keysIn(object) {
if (object == null) {
@@ -7857,7 +7861,7 @@
* @example
*
* _.pairs({ 'barney': 36, 'fred': 40 });
* // => [['barney', 36], ['fred', 40]] (property order is not guaranteed)
* // => [['barney', 36], ['fred', 40]] (iteration order is not guaranteed)
*/
function pairs(object) {
var index = -1,
@@ -7981,7 +7985,7 @@
* Shape.prototype.z = 0;
*
* _.values(new Shape(2, 1));
* // => [2, 1] (property order is not guaranteed)
* // => [2, 1] (iteration order is not guaranteed)
*/
function values(object) {
return baseValues(object, keys);
@@ -8006,7 +8010,7 @@
* Shape.prototype.z = 0;
*
* _.valuesIn(new Shape(2, 1));
* // => [2, 1, 0] (property order is not guaranteed)
* // => [2, 1, 0] (iteration order is not guaranteed)
*/
function valuesIn(object) {
return baseValues(object, keysIn);