shift()

src/Discord/Helpers/CollectionTrait.php

@@ -113,6 +113,24 @@ public function pull($key, $default = null)
         return $default;
     }
 
+    /**
+     * Shifts an item from the collection.
+     *
+     * @return mixed
+     */
+    public function shift()
+    {
+        if (empty($this->items)) {
+            return null;
+        }
+
+        reset($this->items);
+        $key = key($this->items);
+        $value = array_shift($this->items);
+
+        return [$key => $value];
+    }
+
     /**
      * Fills an array of items into the collection.
      *