Merge pull request #406 from bonroyage/master

Added cursor hint

src/Jenssegers/Mongodb/Query/Builder.php

@@ -28,6 +28,13 @@ class Builder extends BaseBuilder {
      * @var int
      */
     public $timeout;
+    
+    /**
+     * The cursor hint value.
+     *
+     * @var int
+     */
+    public $hint;
 
     /**
      * Indicate if we are executing a pagination query.
@@ -103,6 +110,19 @@ class Builder extends BaseBuilder {
 
         return $this;
     }
+    
+    /**
+     * Set the cursor hint.
+     *
+     * @param  mixed $index
+     * @return $this
+     */
+    public function hint($index)
+    {
+        $this->hint = $index;
+
+        return $this;
+    }
 
     /**
      * Execute a query for a single record by ID.
@@ -266,11 +286,12 @@ class Builder extends BaseBuilder {
             // Execute query and get MongoCursor
             $cursor = $this->collection->find($wheres, $columns);
 
-            // Apply order, offset and limit
+            // Apply order, offset, limit and hint
             if ($this->timeout) $cursor->timeout($this->timeout);
             if ($this->orders)  $cursor->sort($this->orders);
             if ($this->offset)  $cursor->skip($this->offset);
             if ($this->limit)   $cursor->limit($this->limit);
+            if ($this->hint)    $cursor->hint($this->hint);
 
             // Return results as an array with numeric keys
             return iterator_to_array($cursor, false);