Bump to v4.0.0.

sampleSize.js

@@ -0,0 +1,38 @@
+var baseClamp = require('./internal/baseClamp'),
+    baseRandom = require('./internal/baseRandom'),
+    toArray = require('./toArray'),
+    toInteger = require('./toInteger');
+
+/**
+ * Gets `n` random elements from `collection`.
+ *
+ * @static
+ * @memberOf _
+ * @category Collection
+ * @param {Array|Object} collection The collection to sample.
+ * @param {number} [n=0] The number of elements to sample.
+ * @returns {Array} Returns the random elements.
+ * @example
+ *
+ * _.sampleSize([1, 2, 3, 4], 2);
+ * // => [3, 1]
+ */
+function sampleSize(collection, n) {
+  var index = -1,
+      result = toArray(collection),
+      length = result.length,
+      lastIndex = length - 1;
+
+  n = baseClamp(toInteger(n), 0, length);
+  while (++index < n) {
+    var rand = baseRandom(index, lastIndex),
+        value = result[rand];
+
+    result[rand] = result[index];
+    result[index] = value;
+  }
+  result.length = n;
+  return result;
+}
+
+module.exports = sampleSize;