7f7efbe026
All of these suppression prevent the detection of many common mistakes, and could easily prevent things like T231488. Especially if there are few issues of a given type, it's way better to suppress them inline, instead of disabling them for the whole core. This patch only touches the one with a lower count (although those counts may be out of date). Bug: T231636 Change-Id: Ica50297ec7c71a81ba2204f9763499da925067bd
82 lines
2.2 KiB
PHP
82 lines
2.2 KiB
PHP
<?php
|
|
|
|
namespace Wikimedia\Rdbms;
|
|
|
|
use Iterator;
|
|
use stdClass;
|
|
|
|
/**
|
|
* Result wrapper for grabbing data queried from an IDatabase object
|
|
*
|
|
* Note that using the Iterator methods in combination with the non-Iterator
|
|
* DB result iteration functions may cause rows to be skipped or repeated.
|
|
*
|
|
* By default, this will use the iteration methods of the IDatabase handle if provided.
|
|
* Subclasses can override methods to make it solely work on the result resource instead.
|
|
* If no database is provided, and the subclass does not override the DB iteration methods,
|
|
* then a RuntimeException will be thrown when iteration is attempted.
|
|
*
|
|
* The result resource field should not be accessed from non-Database related classes.
|
|
* It is database class specific and is stored here to associate iterators with queries.
|
|
*
|
|
* @ingroup Database
|
|
*/
|
|
interface IResultWrapper extends Iterator {
|
|
/**
|
|
* Get the number of rows in a result object
|
|
*
|
|
* @return int
|
|
*/
|
|
public function numRows();
|
|
|
|
/**
|
|
* Fetch the next row from the given result object, in object form. Fields can be retrieved with
|
|
* $row->fieldname, with fields acting like member variables. If no more rows are available,
|
|
* false is returned.
|
|
*
|
|
* @return stdClass|bool
|
|
* @throws DBUnexpectedError Thrown if the database returns an error
|
|
*/
|
|
public function fetchObject();
|
|
|
|
/**
|
|
* Fetch the next row from the given result object, in associative array form. Fields are
|
|
* retrieved with $row['fieldname']. If no more rows are available, false is returned.
|
|
*
|
|
* @return array|bool
|
|
* @throws DBUnexpectedError Thrown if the database returns an error
|
|
*/
|
|
public function fetchRow();
|
|
|
|
/**
|
|
* Change the position of the cursor in a result object.
|
|
* See mysql_data_seek()
|
|
*
|
|
* @param int $pos
|
|
*/
|
|
public function seek( $pos );
|
|
|
|
/**
|
|
* Free a result object
|
|
*
|
|
* This either saves memory in PHP (buffered queries) or on the server (unbuffered queries).
|
|
* In general, queries are not large enough in result sets for this to be worth calling.
|
|
*/
|
|
public function free();
|
|
|
|
/**
|
|
* @return stdClass|array|bool
|
|
*/
|
|
public function current();
|
|
|
|
/**
|
|
* @return int
|
|
*/
|
|
public function key();
|
|
|
|
/**
|
|
* @return stdClass
|
|
* @suppress PhanParamSignatureMismatchInternal
|
|
*/
|
|
function next();
|
|
}
|