Version 1
[yaffs-website] / node_modules / grunt-legacy-log-utils / node_modules / lodash / sample.js
diff --git a/node_modules/grunt-legacy-log-utils/node_modules/lodash/sample.js b/node_modules/grunt-legacy-log-utils/node_modules/lodash/sample.js
new file mode 100644 (file)
index 0000000..1a4d813
--- /dev/null
@@ -0,0 +1,25 @@
+var baseRandom = require('./_baseRandom'),
+    isArrayLike = require('./isArrayLike'),
+    values = require('./values');
+
+/**
+ * Gets a random element from `collection`.
+ *
+ * @static
+ * @memberOf _
+ * @category Collection
+ * @param {Array|Object} collection The collection to sample.
+ * @returns {*} Returns the random element.
+ * @example
+ *
+ * _.sample([1, 2, 3, 4]);
+ * // => 2
+ */
+function sample(collection) {
+  var array = isArrayLike(collection) ? collection : values(collection),
+      length = array.length;
+
+  return length > 0 ? array[baseRandom(0, length - 1)] : undefined;
+}
+
+module.exports = sample;