/usr/share/php/Horde/Db/Adapter/Base/Result.php is in php-horde-db 2.3.1-1ubuntu2.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 | <?php
/**
* Copyright 2013-2016 Horde LLC (http://www.horde.org/)
*
* @author Jan Schneider <jan@horde.org>
* @license http://www.horde.org/licenses/bsd
* @category Horde
* @package Db
* @subpackage Adapter
*/
/**
* This class represents the result set of a SELECT query.
*
* @author Jan Schneider <jan@horde.org>
* @license http://www.horde.org/licenses/bsd
* @category Horde
* @package Db
* @subpackage Adapter
*/
abstract class Horde_Db_Adapter_Base_Result implements Iterator
{
/**
* @var Horde_Db_Adapter
*/
protected $_adapter;
/**
* @var string
*/
protected $_sql;
/**
* @var mixed
*/
protected $_arg1;
/**
* @var string
*/
protected $_arg2;
/**
* Result resource.
*
* @var resource
*/
protected $_result;
/**
* Current row.
*
* @var array
*/
protected $_current;
/**
* Current offset.
*
* @var integer
*/
protected $_index;
/**
* Are we at the end of the result?
*
* @var boolean
*/
protected $_eof;
/**
* Which kind of keys to use for results.
*/
protected $_fetchMode = Horde_Db::FETCH_ASSOC;
/**
* Constructor.
*
* @param Horde_Db_Adapter $adapter A driver instance.
* @param string $sql A SQL query.
* @param mixed $arg1 Either an array of bound parameters or
* a query name.
* @param string $arg2 If $arg1 contains bound parameters,
* the query name.
*/
public function __construct($adapter, $sql, $arg1 = null, $arg2 = null)
{
$this->_adapter = $adapter;
$this->_sql = $sql;
$this->_arg1 = $arg1;
$this->_arg2 = $arg2;
}
/**
* Destructor.
*/
public function __destruct()
{
if ($this->_result) {
unset($this->_result);
}
}
/**
* Implementation of the rewind() method for iterator.
*/
public function rewind()
{
if ($this->_result) {
unset($this->_result);
}
$this->_current = null;
$this->_index = null;
$this->_eof = true;
$this->_result = $this->_adapter->execute(
$this->_sql, $this->_arg1, $this->_arg2
);
$this->next();
}
/**
* Implementation of the current() method for Iterator.
*
* @return array The current row, or null if no rows.
*/
public function current()
{
if (is_null($this->_result)) {
$this->rewind();
}
return $this->_current;
}
/**
* Implementation of the key() method for Iterator.
*
* @return mixed The current row number (starts at 0), or null if no rows.
*/
public function key()
{
if (is_null($this->_result)) {
$this->rewind();
}
return $this->_index;
}
/**
* Implementation of the next() method for Iterator.
*
* @return array|null The next row in the resultset or null if there are
* no more results.
*/
public function next()
{
if (is_null($this->_result)) {
$this->rewind();
}
if ($this->_result) {
$row = $this->_fetchArray();
if (!$row) {
$this->_eof = true;
} else {
$this->_eof = false;
if (is_null($this->_index)) {
$this->_index = 0;
} else {
++$this->_index;
}
$this->_current = $row;
}
}
return $this->_current;
}
/**
* Implementation of the valid() method for Iterator.
*
* @return boolean Whether the iteration is valid.
*/
public function valid()
{
if (is_null($this->_result)) {
$this->rewind();
}
return !$this->_eof;
}
/**
* Returns the current row and advances the recordset one row.
*
* @param integer $fetchmode The default fetch mode for this result. One
* of the Horde_Db::FETCH_* constants.
*/
public function fetch($fetchmode = Horde_Db::FETCH_ASSOC)
{
if (!$this->valid()) {
return null;
}
$this->setFetchMode($fetchmode);
$row = $this->current();
$this->next();
return $row;
}
/**
* Sets the default fetch mode for this result.
*
* @param integer $fetchmode One of the Horde_Db::FETCH_* constants.
*/
public function setFetchMode($fetchmode)
{
$this->_fetchMode = $fetchmode;
}
/**
* Returns the number of columns in the result set.
*
* @return integer Number of columns.
*/
public function columnCount()
{
if (is_null($this->_result)) {
$this->rewind();
}
return $this->_columnCount();
}
/**
* Returns a row from a resultset.
*
* @return array|boolean The next row in the resultset or false if there
* are no more results.
*/
abstract protected function _fetchArray();
/**
* Returns the number of columns in the result set.
*
* @return integer Number of columns.
*/
abstract protected function _columnCount();
}
|