Andrey Andreev | b76029d | 2012-01-26 15:13:19 +0200 | [diff] [blame] | 1 | <?php if ( ! defined('BASEPATH')) exit('No direct script access allowed'); |
Derek Allard | 2067d1a | 2008-11-13 22:59:24 +0000 | [diff] [blame] | 2 | /** |
| 3 | * CodeIgniter |
| 4 | * |
Phil Sturgeon | 07c1ac8 | 2012-03-09 17:03:37 +0000 | [diff] [blame] | 5 | * An open source application development framework for PHP 5.2.4 or newer |
Derek Allard | 2067d1a | 2008-11-13 22:59:24 +0000 | [diff] [blame] | 6 | * |
Derek Jones | f4a4bd8 | 2011-10-20 12:18:42 -0500 | [diff] [blame] | 7 | * NOTICE OF LICENSE |
Andrey Andreev | b76029d | 2012-01-26 15:13:19 +0200 | [diff] [blame] | 8 | * |
Derek Jones | f4a4bd8 | 2011-10-20 12:18:42 -0500 | [diff] [blame] | 9 | * Licensed under the Open Software License version 3.0 |
Andrey Andreev | b76029d | 2012-01-26 15:13:19 +0200 | [diff] [blame] | 10 | * |
Derek Jones | f4a4bd8 | 2011-10-20 12:18:42 -0500 | [diff] [blame] | 11 | * This source file is subject to the Open Software License (OSL 3.0) that is |
| 12 | * bundled with this package in the files license.txt / license.rst. It is |
| 13 | * also available through the world wide web at this URL: |
| 14 | * http://opensource.org/licenses/OSL-3.0 |
| 15 | * If you did not receive a copy of the license and are unable to obtain it |
| 16 | * through the world wide web, please send an email to |
| 17 | * licensing@ellislab.com so we can send you a copy immediately. |
| 18 | * |
Derek Allard | 2067d1a | 2008-11-13 22:59:24 +0000 | [diff] [blame] | 19 | * @package CodeIgniter |
Derek Jones | f4a4bd8 | 2011-10-20 12:18:42 -0500 | [diff] [blame] | 20 | * @author EllisLab Dev Team |
Greg Aker | 0defe5d | 2012-01-01 18:46:41 -0600 | [diff] [blame] | 21 | * @copyright Copyright (c) 2008 - 2012, EllisLab, Inc. (http://ellislab.com/) |
Derek Jones | f4a4bd8 | 2011-10-20 12:18:42 -0500 | [diff] [blame] | 22 | * @license http://opensource.org/licenses/OSL-3.0 Open Software License (OSL 3.0) |
Derek Allard | 2067d1a | 2008-11-13 22:59:24 +0000 | [diff] [blame] | 23 | * @link http://codeigniter.com |
| 24 | * @since Version 1.0 |
| 25 | * @filesource |
| 26 | */ |
| 27 | |
Derek Allard | 2067d1a | 2008-11-13 22:59:24 +0000 | [diff] [blame] | 28 | /** |
| 29 | * ODBC Result Class |
| 30 | * |
| 31 | * This class extends the parent result class: CI_DB_result |
| 32 | * |
| 33 | * @category Database |
Derek Jones | f4a4bd8 | 2011-10-20 12:18:42 -0500 | [diff] [blame] | 34 | * @author EllisLab Dev Team |
Derek Allard | 2067d1a | 2008-11-13 22:59:24 +0000 | [diff] [blame] | 35 | * @link http://codeigniter.com/user_guide/database/ |
| 36 | */ |
| 37 | class CI_DB_odbc_result extends CI_DB_result { |
Barry Mieny | dd67197 | 2010-10-04 16:33:58 +0200 | [diff] [blame] | 38 | |
Andrey Andreev | ef795ac | 2012-03-01 15:15:31 +0200 | [diff] [blame] | 39 | public $num_rows; |
| 40 | |
Derek Allard | 2067d1a | 2008-11-13 22:59:24 +0000 | [diff] [blame] | 41 | /** |
| 42 | * Number of rows in the result set |
| 43 | * |
Andrey Andreev | b76029d | 2012-01-26 15:13:19 +0200 | [diff] [blame] | 44 | * @return int |
Derek Allard | 2067d1a | 2008-11-13 22:59:24 +0000 | [diff] [blame] | 45 | */ |
Andrey Andreev | b76029d | 2012-01-26 15:13:19 +0200 | [diff] [blame] | 46 | public function num_rows() |
Derek Allard | 2067d1a | 2008-11-13 22:59:24 +0000 | [diff] [blame] | 47 | { |
Andrey Andreev | ef795ac | 2012-03-01 15:15:31 +0200 | [diff] [blame] | 48 | if (is_int($this->num_rows)) |
Andrey Andreev | 78b24bf | 2012-02-29 16:43:57 +0200 | [diff] [blame] | 49 | { |
| 50 | return $this->num_rows; |
| 51 | } |
| 52 | |
| 53 | // Work-around for ODBC subdrivers that don't support num_rows() |
| 54 | if (($this->num_rows = @odbc_num_rows($this->result_id)) === -1) |
| 55 | { |
Andrey Andreev | ef795ac | 2012-03-01 15:15:31 +0200 | [diff] [blame] | 56 | $this->num_rows = count($this->result_array()); |
Andrey Andreev | 78b24bf | 2012-02-29 16:43:57 +0200 | [diff] [blame] | 57 | } |
| 58 | |
| 59 | return $this->num_rows; |
Derek Allard | 2067d1a | 2008-11-13 22:59:24 +0000 | [diff] [blame] | 60 | } |
Barry Mieny | dd67197 | 2010-10-04 16:33:58 +0200 | [diff] [blame] | 61 | |
Derek Allard | 2067d1a | 2008-11-13 22:59:24 +0000 | [diff] [blame] | 62 | /** |
| 63 | * Number of fields in the result set |
| 64 | * |
Andrey Andreev | b76029d | 2012-01-26 15:13:19 +0200 | [diff] [blame] | 65 | * @return int |
Derek Allard | 2067d1a | 2008-11-13 22:59:24 +0000 | [diff] [blame] | 66 | */ |
Andrey Andreev | b76029d | 2012-01-26 15:13:19 +0200 | [diff] [blame] | 67 | public function num_fields() |
Derek Allard | 2067d1a | 2008-11-13 22:59:24 +0000 | [diff] [blame] | 68 | { |
| 69 | return @odbc_num_fields($this->result_id); |
| 70 | } |
| 71 | |
| 72 | // -------------------------------------------------------------------- |
| 73 | |
| 74 | /** |
| 75 | * Fetch Field Names |
| 76 | * |
| 77 | * Generates an array of column names |
| 78 | * |
Derek Allard | 2067d1a | 2008-11-13 22:59:24 +0000 | [diff] [blame] | 79 | * @return array |
| 80 | */ |
Andrey Andreev | b76029d | 2012-01-26 15:13:19 +0200 | [diff] [blame] | 81 | public function list_fields() |
Derek Allard | 2067d1a | 2008-11-13 22:59:24 +0000 | [diff] [blame] | 82 | { |
| 83 | $field_names = array(); |
Andrey Andreev | bb8a683 | 2012-02-14 12:17:13 +0200 | [diff] [blame] | 84 | $num_fields = $this->num_fields(); |
Andrey Andreev | 41e46a9 | 2012-03-01 14:58:17 +0200 | [diff] [blame] | 85 | |
Andrey Andreev | bb8a683 | 2012-02-14 12:17:13 +0200 | [diff] [blame] | 86 | if ($num_fields > 0) |
Derek Allard | 2067d1a | 2008-11-13 22:59:24 +0000 | [diff] [blame] | 87 | { |
Andrey Andreev | bb8a683 | 2012-02-14 12:17:13 +0200 | [diff] [blame] | 88 | for ($i = 1; $i <= $num_fields; $i++) |
| 89 | { |
Andrey Andreev | 41e46a9 | 2012-03-01 14:58:17 +0200 | [diff] [blame] | 90 | $field_names[] = odbc_field_name($this->result_id, $i); |
Andrey Andreev | bb8a683 | 2012-02-14 12:17:13 +0200 | [diff] [blame] | 91 | } |
Derek Allard | 2067d1a | 2008-11-13 22:59:24 +0000 | [diff] [blame] | 92 | } |
Barry Mieny | dd67197 | 2010-10-04 16:33:58 +0200 | [diff] [blame] | 93 | |
Derek Allard | 2067d1a | 2008-11-13 22:59:24 +0000 | [diff] [blame] | 94 | return $field_names; |
| 95 | } |
| 96 | |
| 97 | // -------------------------------------------------------------------- |
| 98 | |
| 99 | /** |
| 100 | * Field data |
| 101 | * |
| 102 | * Generates an array of objects containing field meta-data |
| 103 | * |
Derek Allard | 2067d1a | 2008-11-13 22:59:24 +0000 | [diff] [blame] | 104 | * @return array |
| 105 | */ |
Andrey Andreev | b76029d | 2012-01-26 15:13:19 +0200 | [diff] [blame] | 106 | public function field_data() |
Derek Allard | 2067d1a | 2008-11-13 22:59:24 +0000 | [diff] [blame] | 107 | { |
| 108 | $retval = array(); |
Andrey Andreev | bb8a683 | 2012-02-14 12:17:13 +0200 | [diff] [blame] | 109 | for ($i = 0, $odbc_index = 1, $c = $this->num_fields(); $i < $c; $i++, $odbc_index++) |
Derek Allard | 2067d1a | 2008-11-13 22:59:24 +0000 | [diff] [blame] | 110 | { |
Andrey Andreev | b76029d | 2012-01-26 15:13:19 +0200 | [diff] [blame] | 111 | $retval[$i] = new stdClass(); |
Andrey Andreev | bb8a683 | 2012-02-14 12:17:13 +0200 | [diff] [blame] | 112 | $retval[$i]->name = odbc_field_name($this->result_id, $odbc_index); |
| 113 | $retval[$i]->type = odbc_field_type($this->result_id, $odbc_index); |
| 114 | $retval[$i]->max_length = odbc_field_len($this->result_id, $odbc_index); |
Andrey Andreev | b76029d | 2012-01-26 15:13:19 +0200 | [diff] [blame] | 115 | $retval[$i]->primary_key = 0; |
| 116 | $retval[$i]->default = ''; |
Derek Allard | 2067d1a | 2008-11-13 22:59:24 +0000 | [diff] [blame] | 117 | } |
Barry Mieny | dd67197 | 2010-10-04 16:33:58 +0200 | [diff] [blame] | 118 | |
Derek Allard | 2067d1a | 2008-11-13 22:59:24 +0000 | [diff] [blame] | 119 | return $retval; |
| 120 | } |
| 121 | |
| 122 | // -------------------------------------------------------------------- |
| 123 | |
| 124 | /** |
| 125 | * Free the result |
| 126 | * |
Andrey Andreev | b76029d | 2012-01-26 15:13:19 +0200 | [diff] [blame] | 127 | * @return void |
Barry Mieny | dd67197 | 2010-10-04 16:33:58 +0200 | [diff] [blame] | 128 | */ |
Andrey Andreev | b76029d | 2012-01-26 15:13:19 +0200 | [diff] [blame] | 129 | public function free_result() |
Derek Allard | 2067d1a | 2008-11-13 22:59:24 +0000 | [diff] [blame] | 130 | { |
| 131 | if (is_resource($this->result_id)) |
| 132 | { |
| 133 | odbc_free_result($this->result_id); |
| 134 | $this->result_id = FALSE; |
| 135 | } |
| 136 | } |
| 137 | |
| 138 | // -------------------------------------------------------------------- |
| 139 | |
| 140 | /** |
| 141 | * Data Seek |
| 142 | * |
Andrey Andreev | b76029d | 2012-01-26 15:13:19 +0200 | [diff] [blame] | 143 | * Moves the internal pointer to the desired offset. We call |
Derek Allard | 2067d1a | 2008-11-13 22:59:24 +0000 | [diff] [blame] | 144 | * this internally before fetching results to make sure the |
| 145 | * result set starts at zero |
| 146 | * |
Andrey Andreev | 78ef5a5 | 2012-03-20 14:43:34 +0200 | [diff] [blame] | 147 | * @return bool |
Derek Allard | 2067d1a | 2008-11-13 22:59:24 +0000 | [diff] [blame] | 148 | */ |
Andrey Andreev | b76029d | 2012-01-26 15:13:19 +0200 | [diff] [blame] | 149 | protected function _data_seek($n = 0) |
Derek Allard | 2067d1a | 2008-11-13 22:59:24 +0000 | [diff] [blame] | 150 | { |
Andrey Andreev | b76029d | 2012-01-26 15:13:19 +0200 | [diff] [blame] | 151 | // Not supported |
Derek Allard | 2067d1a | 2008-11-13 22:59:24 +0000 | [diff] [blame] | 152 | return FALSE; |
| 153 | } |
| 154 | |
| 155 | // -------------------------------------------------------------------- |
| 156 | |
| 157 | /** |
| 158 | * Result - associative array |
| 159 | * |
| 160 | * Returns the result set as an array |
| 161 | * |
Derek Allard | 2067d1a | 2008-11-13 22:59:24 +0000 | [diff] [blame] | 162 | * @return array |
| 163 | */ |
Andrey Andreev | b76029d | 2012-01-26 15:13:19 +0200 | [diff] [blame] | 164 | protected function _fetch_assoc() |
Derek Allard | 2067d1a | 2008-11-13 22:59:24 +0000 | [diff] [blame] | 165 | { |
Andrey Andreev | 7e93489 | 2012-02-12 03:29:06 +0200 | [diff] [blame] | 166 | return function_exists('odbc_fetch_array') |
Andrey Andreev | b76029d | 2012-01-26 15:13:19 +0200 | [diff] [blame] | 167 | ? odbc_fetch_array($this->result_id) |
| 168 | : $this->_odbc_fetch_array($this->result_id); |
Derek Allard | 2067d1a | 2008-11-13 22:59:24 +0000 | [diff] [blame] | 169 | } |
| 170 | |
| 171 | // -------------------------------------------------------------------- |
| 172 | |
| 173 | /** |
| 174 | * Result - object |
| 175 | * |
| 176 | * Returns the result set as an object |
| 177 | * |
Derek Allard | 2067d1a | 2008-11-13 22:59:24 +0000 | [diff] [blame] | 178 | * @return object |
| 179 | */ |
Andrey Andreev | b76029d | 2012-01-26 15:13:19 +0200 | [diff] [blame] | 180 | protected function _fetch_object() |
Derek Allard | 2067d1a | 2008-11-13 22:59:24 +0000 | [diff] [blame] | 181 | { |
Andrey Andreev | b76029d | 2012-01-26 15:13:19 +0200 | [diff] [blame] | 182 | return function_exists('odbc_fetch_object') |
| 183 | ? odbc_fetch_object($this->result_id) |
| 184 | : $this->_odbc_fetch_object($this->result_id); |
Derek Allard | 2067d1a | 2008-11-13 22:59:24 +0000 | [diff] [blame] | 185 | } |
| 186 | |
Andrey Andreev | 78ef5a5 | 2012-03-20 14:43:34 +0200 | [diff] [blame] | 187 | // -------------------------------------------------------------------- |
Derek Allard | 2067d1a | 2008-11-13 22:59:24 +0000 | [diff] [blame] | 188 | |
| 189 | /** |
| 190 | * Result - object |
| 191 | * |
| 192 | * subsititutes the odbc_fetch_object function when |
| 193 | * not available (odbc_fetch_object requires unixODBC) |
| 194 | * |
Derek Allard | 2067d1a | 2008-11-13 22:59:24 +0000 | [diff] [blame] | 195 | * @return object |
| 196 | */ |
Andrey Andreev | 78ef5a5 | 2012-03-20 14:43:34 +0200 | [diff] [blame] | 197 | protected function _odbc_fetch_object(& $odbc_result) |
Andrey Andreev | b76029d | 2012-01-26 15:13:19 +0200 | [diff] [blame] | 198 | { |
Derek Allard | 2067d1a | 2008-11-13 22:59:24 +0000 | [diff] [blame] | 199 | $rs = array(); |
Andrey Andreev | b76029d | 2012-01-26 15:13:19 +0200 | [diff] [blame] | 200 | if ( ! odbc_fetch_into($odbc_result, $rs)) |
| 201 | { |
| 202 | return FALSE; |
Derek Allard | 2067d1a | 2008-11-13 22:59:24 +0000 | [diff] [blame] | 203 | } |
Andrey Andreev | b76029d | 2012-01-26 15:13:19 +0200 | [diff] [blame] | 204 | |
| 205 | $rs_obj = new stdClass(); |
| 206 | foreach ($rs as $k => $v) |
| 207 | { |
Andrey Andreev | d0b256f | 2012-02-13 12:20:11 +0200 | [diff] [blame] | 208 | $field_name = odbc_field_name($odbc_result, $k+1); |
Andrey Andreev | b76029d | 2012-01-26 15:13:19 +0200 | [diff] [blame] | 209 | $rs_obj->$field_name = $v; |
| 210 | } |
| 211 | |
Derek Allard | 2067d1a | 2008-11-13 22:59:24 +0000 | [diff] [blame] | 212 | return $rs_obj; |
| 213 | } |
| 214 | |
Andrey Andreev | 78ef5a5 | 2012-03-20 14:43:34 +0200 | [diff] [blame] | 215 | // -------------------------------------------------------------------- |
Derek Allard | 2067d1a | 2008-11-13 22:59:24 +0000 | [diff] [blame] | 216 | |
| 217 | /** |
| 218 | * Result - array |
| 219 | * |
| 220 | * subsititutes the odbc_fetch_array function when |
| 221 | * not available (odbc_fetch_array requires unixODBC) |
| 222 | * |
Derek Allard | 2067d1a | 2008-11-13 22:59:24 +0000 | [diff] [blame] | 223 | * @return array |
| 224 | */ |
Andrey Andreev | 78ef5a5 | 2012-03-20 14:43:34 +0200 | [diff] [blame] | 225 | protected function _odbc_fetch_array(& $odbc_result) |
Andrey Andreev | b76029d | 2012-01-26 15:13:19 +0200 | [diff] [blame] | 226 | { |
Derek Allard | 2067d1a | 2008-11-13 22:59:24 +0000 | [diff] [blame] | 227 | $rs = array(); |
Andrey Andreev | b76029d | 2012-01-26 15:13:19 +0200 | [diff] [blame] | 228 | if ( ! odbc_fetch_into($odbc_result, $rs)) |
| 229 | { |
| 230 | return FALSE; |
Derek Allard | 2067d1a | 2008-11-13 22:59:24 +0000 | [diff] [blame] | 231 | } |
Andrey Andreev | b76029d | 2012-01-26 15:13:19 +0200 | [diff] [blame] | 232 | |
| 233 | $rs_assoc = array(); |
| 234 | foreach ($rs as $k => $v) |
| 235 | { |
Andrey Andreev | d0b256f | 2012-02-13 12:20:11 +0200 | [diff] [blame] | 236 | $field_name = odbc_field_name($odbc_result, $k+1); |
Andrey Andreev | b76029d | 2012-01-26 15:13:19 +0200 | [diff] [blame] | 237 | $rs_assoc[$field_name] = $v; |
| 238 | } |
| 239 | |
Derek Allard | 2067d1a | 2008-11-13 22:59:24 +0000 | [diff] [blame] | 240 | return $rs_assoc; |
| 241 | } |
| 242 | |
Andrey Andreev | cc5af53 | 2012-03-05 14:02:15 +0200 | [diff] [blame] | 243 | // -------------------------------------------------------------------- |
Derek Allard | 2067d1a | 2008-11-13 22:59:24 +0000 | [diff] [blame] | 244 | |
Andrey Andreev | cc5af53 | 2012-03-05 14:02:15 +0200 | [diff] [blame] | 245 | /** |
| 246 | * Query result. Array version. |
| 247 | * |
| 248 | * @return array |
| 249 | */ |
| 250 | public function result_array() |
| 251 | { |
| 252 | if (count($this->result_array) > 0) |
| 253 | { |
| 254 | return $this->result_array; |
| 255 | } |
| 256 | elseif (($c = count($this->result_object)) > 0) |
| 257 | { |
| 258 | for ($i = 0; $i < $c; $i++) |
| 259 | { |
| 260 | $this->result_array[$i] = (array) $this->result_object[$i]; |
| 261 | } |
| 262 | } |
| 263 | elseif ($this->result_id === FALSE) |
| 264 | { |
| 265 | return array(); |
| 266 | } |
| 267 | else |
| 268 | { |
| 269 | while ($row = $this->_fetch_assoc()) |
| 270 | { |
| 271 | $this->result_array[] = $row; |
| 272 | } |
| 273 | } |
| 274 | |
| 275 | return $this->result_array; |
| 276 | } |
| 277 | |
Andrey Andreev | 9c68c31 | 2012-03-06 10:34:58 +0200 | [diff] [blame] | 278 | // -------------------------------------------------------------------- |
| 279 | |
| 280 | /** |
| 281 | * Query result. Object version. |
| 282 | * |
| 283 | * @return array |
| 284 | */ |
| 285 | public function result_object() |
| 286 | { |
| 287 | if (count($this->result_object) > 0) |
| 288 | { |
| 289 | return $this->result_object; |
| 290 | } |
| 291 | elseif (($c = count($this->result_array)) > 0) |
| 292 | { |
| 293 | for ($i = 0; $i < $c; $i++) |
| 294 | { |
| 295 | $this->result_object[$i] = (object) $this->result_array[$i]; |
| 296 | } |
| 297 | } |
| 298 | elseif ($this->result_id === FALSE) |
| 299 | { |
| 300 | return array(); |
| 301 | } |
| 302 | else |
| 303 | { |
| 304 | while ($row = $this->_fetch_object()) |
| 305 | { |
| 306 | $this->result_object[] = $row; |
| 307 | } |
| 308 | } |
| 309 | |
| 310 | return $this->result_object; |
| 311 | } |
| 312 | |
Derek Allard | 2067d1a | 2008-11-13 22:59:24 +0000 | [diff] [blame] | 313 | } |
| 314 | |
Derek Allard | 2067d1a | 2008-11-13 22:59:24 +0000 | [diff] [blame] | 315 | /* End of file odbc_result.php */ |
Andrey Andreev | 19aee03 | 2012-03-20 15:31:42 +0200 | [diff] [blame^] | 316 | /* Location: ./system/database/drivers/odbc/odbc_result.php */ |