updated-packages

vendor/doctrine/dbal/lib/Doctrine/DBAL/Driver/ResultStatement.php

@@ -13,6 +13,8 @@ interface ResultStatement extends Traversable
     /**
      * Closes the cursor, enabling the statement to be executed again.
      *
+     * @deprecated Use Result::free() instead.
+     *
      * @return bool TRUE on success or FALSE on failure.
      */
     public function closeCursor();
@@ -29,7 +31,9 @@ interface ResultStatement extends Traversable
     /**
      * Sets the fetch mode to use while iterating this statement.
      *
-     * @param int   $fetchMode The fetch mode must be one of the {@link \Doctrine\DBAL\FetchMode} constants.
+     * @deprecated Use one of the fetch- or iterate-related methods.
+     *
+     * @param int   $fetchMode The fetch mode must be one of the {@link FetchMode} constants.
      * @param mixed $arg2
      * @param mixed $arg3
      *
@@ -40,9 +44,11 @@ interface ResultStatement extends Traversable
     /**
      * Returns the next row of a result set.
      *
+     * @deprecated Use fetchNumeric(), fetchAssociative() or fetchOne() instead.
+     *
      * @param int|null $fetchMode         Controls how the next row will be returned to the caller.
-     *                                    The value must be one of the {@link \Doctrine\DBAL\FetchMode} constants,
-     *                                    defaulting to {@link \Doctrine\DBAL\FetchMode::MIXED}.
+     *                                    The value must be one of the {@link FetchMode} constants,
+     *                                    defaulting to {@link FetchMode::MIXED}.
      * @param int      $cursorOrientation For a ResultStatement object representing a scrollable cursor,
      *                                    this value determines which row will be returned to the caller.
      *                                    This value must be one of the \PDO::FETCH_ORI_* constants,
@@ -67,20 +73,24 @@ interface ResultStatement extends Traversable
     /**
      * Returns an array containing all of the result set rows.
      *
-     * @param int|null     $fetchMode     Controls how the next row will be returned to the caller.
-     *                                    The value must be one of the {@link \Doctrine\DBAL\FetchMode} constants,
-     *                                    defaulting to {@link \Doctrine\DBAL\FetchMode::MIXED}.
-     * @param int|null     $fetchArgument This argument has a different meaning depending on the value of the $fetchMode parameter:
-     *                                    * {@link \Doctrine\DBAL\FetchMode::COLUMN}:
-     *                                      Returns the indicated 0-indexed column.
-     *                                    * {@link \Doctrine\DBAL\FetchMode::CUSTOM_OBJECT}:
-     *                                      Returns instances of the specified class, mapping the columns of each row
-     *                                      to named properties in the class.
-     *                                    * \PDO::FETCH_FUNC: Returns the results of calling the specified function, using each row's
-     *                                      columns as parameters in the call.
-     * @param mixed[]|null $ctorArgs      Controls how the next row will be returned to the caller.
-     *                                    The value must be one of the {@link \Doctrine\DBAL\FetchMode} constants,
-     *                                    defaulting to {@link \Doctrine\DBAL\FetchMode::MIXED}.
+     * @deprecated Use fetchAllNumeric(), fetchAllAssociative() or fetchFirstColumn() instead.
+     *
+     * @param int|null        $fetchMode     Controls how the next row will be returned to the caller.
+     *                                       The value must be one of the {@link FetchMode} constants,
+     *                                       defaulting to {@link FetchMode::MIXED}.
+     * @param int|string|null $fetchArgument This argument has a different meaning depending on the value
+     *                                       of the $fetchMode parameter:
+     *                                       * {@link FetchMode::COLUMN}:
+     *                                         Returns the indicated 0-indexed column.
+     *                                       * {@link FetchMode::CUSTOM_OBJECT}:
+     *                                         Returns instances of the specified class, mapping the columns of each row
+     *                                         to named properties in the class.
+     *                                       * {@link PDO::FETCH_FUNC}: Returns the results of calling
+     *                                         the specified function, using each row's
+     *                                         columns as parameters in the call.
+     * @param mixed[]|null    $ctorArgs      Controls how the next row will be returned to the caller.
+     *                                       The value must be one of the {@link FetchMode} constants,
+     *                                       defaulting to {@link FetchMode::MIXED}.
      *
      * @return mixed[]
      */
@@ -89,6 +99,8 @@ interface ResultStatement extends Traversable
     /**
      * Returns a single column from the next row of a result set or FALSE if there are no more rows.
      *
+     * @deprecated Use fetchOne() instead.
+     *
      * @param int $columnIndex 0-indexed number of the column you wish to retrieve from the row.
      *                         If no value is supplied, fetches the first column.
      *