blob: daf3306f30b1fe3a218e1f02b7b76d7f163c6b6c [file] [log] [blame]
Andrey Andreevc5536aa2012-11-01 17:33:58 +02001<?php
Derek Allard2067d1a2008-11-13 22:59:24 +00002/**
3 * CodeIgniter
4 *
Andrey Andreevfe9309d2015-01-09 17:48:58 +02005 * An open source application development framework for PHP
Derek Allard2067d1a2008-11-13 22:59:24 +00006 *
Andrey Andreevbdb96ca2014-10-28 00:13:31 +02007 * This content is released under the MIT License (MIT)
Andrey Andreev02878c22012-03-20 14:16:53 +02008 *
Andrey Andreevcce6bd12018-01-09 11:32:02 +02009 * Copyright (c) 2014 - 2018, British Columbia Institute of Technology
Andrey Andreev02878c22012-03-20 14:16:53 +020010 *
Andrey Andreevbdb96ca2014-10-28 00:13:31 +020011 * Permission is hereby granted, free of charge, to any person obtaining a copy
12 * of this software and associated documentation files (the "Software"), to deal
13 * in the Software without restriction, including without limitation the rights
14 * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
15 * copies of the Software, and to permit persons to whom the Software is
16 * furnished to do so, subject to the following conditions:
Derek Jonesf4a4bd82011-10-20 12:18:42 -050017 *
Andrey Andreevbdb96ca2014-10-28 00:13:31 +020018 * The above copyright notice and this permission notice shall be included in
19 * all copies or substantial portions of the Software.
20 *
21 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
22 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
23 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
24 * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
25 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
26 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
27 * THE SOFTWARE.
28 *
29 * @package CodeIgniter
30 * @author EllisLab Dev Team
Andrey Andreev1924e872016-01-11 12:55:34 +020031 * @copyright Copyright (c) 2008 - 2014, EllisLab, Inc. (https://ellislab.com/)
Andrey Andreevcce6bd12018-01-09 11:32:02 +020032 * @copyright Copyright (c) 2014 - 2018, British Columbia Institute of Technology (http://bcit.ca/)
Andrey Andreevbdb96ca2014-10-28 00:13:31 +020033 * @license http://opensource.org/licenses/MIT MIT License
Andrey Andreevbd202c92016-01-11 12:50:18 +020034 * @link https://codeigniter.com
Andrey Andreevbdb96ca2014-10-28 00:13:31 +020035 * @since Version 1.3.0
Derek Allard2067d1a2008-11-13 22:59:24 +000036 * @filesource
37 */
Andrey Andreevc5536aa2012-11-01 17:33:58 +020038defined('BASEPATH') OR exit('No direct script access allowed');
Derek Allard2067d1a2008-11-13 22:59:24 +000039
Derek Allard2067d1a2008-11-13 22:59:24 +000040/**
41 * Postgres Result Class
42 *
43 * This class extends the parent result class: CI_DB_result
44 *
Andrey Andreevbdb96ca2014-10-28 00:13:31 +020045 * @package CodeIgniter
46 * @subpackage Drivers
Derek Allard2067d1a2008-11-13 22:59:24 +000047 * @category Database
Derek Jonesf4a4bd82011-10-20 12:18:42 -050048 * @author EllisLab Dev Team
Andrey Andreevbd202c92016-01-11 12:50:18 +020049 * @link https://codeigniter.com/user_guide/database/
Derek Allard2067d1a2008-11-13 22:59:24 +000050 */
51class CI_DB_postgre_result extends CI_DB_result {
52
53 /**
54 * Number of rows in the result set
55 *
Andrey Andreev02878c22012-03-20 14:16:53 +020056 * @return int
Derek Allard2067d1a2008-11-13 22:59:24 +000057 */
Andrey Andreev02878c22012-03-20 14:16:53 +020058 public function num_rows()
Derek Allard2067d1a2008-11-13 22:59:24 +000059 {
Andrey Andreevc7db6bb2012-07-05 15:11:20 +030060 return is_int($this->num_rows)
61 ? $this->num_rows
Andrey Andreev2bbbd1a2014-05-09 10:24:14 +030062 : $this->num_rows = pg_num_rows($this->result_id);
Derek Allard2067d1a2008-11-13 22:59:24 +000063 }
Barry Mienydd671972010-10-04 16:33:58 +020064
Derek Allard2067d1a2008-11-13 22:59:24 +000065 // --------------------------------------------------------------------
66
67 /**
68 * Number of fields in the result set
69 *
Andrey Andreev02878c22012-03-20 14:16:53 +020070 * @return int
Derek Allard2067d1a2008-11-13 22:59:24 +000071 */
Andrey Andreev02878c22012-03-20 14:16:53 +020072 public function num_fields()
Derek Allard2067d1a2008-11-13 22:59:24 +000073 {
Andrey Andreev2bbbd1a2014-05-09 10:24:14 +030074 return pg_num_fields($this->result_id);
Derek Allard2067d1a2008-11-13 22:59:24 +000075 }
76
77 // --------------------------------------------------------------------
78
79 /**
80 * Fetch Field Names
81 *
82 * Generates an array of column names
83 *
Derek Allard2067d1a2008-11-13 22:59:24 +000084 * @return array
85 */
Andrey Andreev02878c22012-03-20 14:16:53 +020086 public function list_fields()
Derek Allard2067d1a2008-11-13 22:59:24 +000087 {
88 $field_names = array();
Andrey Andreev22b9e5f2012-03-29 11:30:33 +030089 for ($i = 0, $c = $this->num_fields(); $i < $c; $i++)
Derek Allard2067d1a2008-11-13 22:59:24 +000090 {
91 $field_names[] = pg_field_name($this->result_id, $i);
92 }
Barry Mienydd671972010-10-04 16:33:58 +020093
Derek Allard2067d1a2008-11-13 22:59:24 +000094 return $field_names;
95 }
96
97 // --------------------------------------------------------------------
98
99 /**
100 * Field data
101 *
102 * Generates an array of objects containing field meta-data
103 *
Derek Allard2067d1a2008-11-13 22:59:24 +0000104 * @return array
105 */
Andrey Andreev02878c22012-03-20 14:16:53 +0200106 public function field_data()
Derek Allard2067d1a2008-11-13 22:59:24 +0000107 {
108 $retval = array();
Andrey Andreev22b9e5f2012-03-29 11:30:33 +0300109 for ($i = 0, $c = $this->num_fields(); $i < $c; $i++)
Derek Allard2067d1a2008-11-13 22:59:24 +0000110 {
Andrey Andreev22b9e5f2012-03-29 11:30:33 +0300111 $retval[$i] = new stdClass();
112 $retval[$i]->name = pg_field_name($this->result_id, $i);
113 $retval[$i]->type = pg_field_type($this->result_id, $i);
114 $retval[$i]->max_length = pg_field_size($this->result_id, $i);
Derek Allard2067d1a2008-11-13 22:59:24 +0000115 }
Barry Mienydd671972010-10-04 16:33:58 +0200116
Derek Allard2067d1a2008-11-13 22:59:24 +0000117 return $retval;
118 }
119
120 // --------------------------------------------------------------------
121
122 /**
123 * Free the result
124 *
Andrey Andreev02878c22012-03-20 14:16:53 +0200125 * @return void
Barry Mienydd671972010-10-04 16:33:58 +0200126 */
Andrey Andreev02878c22012-03-20 14:16:53 +0200127 public function free_result()
Derek Allard2067d1a2008-11-13 22:59:24 +0000128 {
129 if (is_resource($this->result_id))
130 {
131 pg_free_result($this->result_id);
132 $this->result_id = FALSE;
133 }
134 }
135
136 // --------------------------------------------------------------------
137
138 /**
139 * Data Seek
140 *
Andrey Andreev02878c22012-03-20 14:16:53 +0200141 * Moves the internal pointer to the desired offset. We call
Derek Allard2067d1a2008-11-13 22:59:24 +0000142 * this internally before fetching results to make sure the
Andrey Andreev8463b912012-11-02 02:16:28 +0200143 * result set starts at zero.
Derek Allard2067d1a2008-11-13 22:59:24 +0000144 *
Andrey Andreev8463b912012-11-02 02:16:28 +0200145 * @param int $n
Andrey Andreev8f3566f2012-04-12 14:30:05 +0300146 * @return bool
Derek Allard2067d1a2008-11-13 22:59:24 +0000147 */
Andrey Andreev69edc432012-12-04 13:32:16 +0200148 public function data_seek($n = 0)
Derek Allard2067d1a2008-11-13 22:59:24 +0000149 {
150 return pg_result_seek($this->result_id, $n);
151 }
152
153 // --------------------------------------------------------------------
154
155 /**
156 * Result - associative array
157 *
158 * Returns the result set as an array
159 *
Derek Allard2067d1a2008-11-13 22:59:24 +0000160 * @return array
161 */
Andrey Andreev02878c22012-03-20 14:16:53 +0200162 protected function _fetch_assoc()
Derek Allard2067d1a2008-11-13 22:59:24 +0000163 {
164 return pg_fetch_assoc($this->result_id);
165 }
Barry Mienydd671972010-10-04 16:33:58 +0200166
Derek Allard2067d1a2008-11-13 22:59:24 +0000167 // --------------------------------------------------------------------
168
169 /**
170 * Result - object
171 *
172 * Returns the result set as an object
173 *
Andrey Andreev8463b912012-11-02 02:16:28 +0200174 * @param string $class_name
Derek Allard2067d1a2008-11-13 22:59:24 +0000175 * @return object
176 */
Andrey Andreev9a4f3562012-07-06 11:57:37 +0300177 protected function _fetch_object($class_name = 'stdClass')
Derek Allard2067d1a2008-11-13 22:59:24 +0000178 {
Andrey Andreev9a4f3562012-07-06 11:57:37 +0300179 return pg_fetch_object($this->result_id, NULL, $class_name);
Derek Allard2067d1a2008-11-13 22:59:24 +0000180 }
Barry Mienydd671972010-10-04 16:33:58 +0200181
Derek Allard2067d1a2008-11-13 22:59:24 +0000182}