You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

193 lines
4.8 KiB

7 years ago
  1. <?php
  2. /**
  3. * CodeIgniter
  4. *
  5. * An open source application development framework for PHP
  6. *
  7. * This content is released under the MIT License (MIT)
  8. *
  9. * Copyright (c) 2014 - 2017, British Columbia Institute of Technology
  10. *
  11. * 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:
  17. *
  18. * 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
  31. * @copyright Copyright (c) 2008 - 2014, EllisLab, Inc. (https://ellislab.com/)
  32. * @copyright Copyright (c) 2014 - 2017, British Columbia Institute of Technology (http://bcit.ca/)
  33. * @license http://opensource.org/licenses/MIT MIT License
  34. * @link https://codeigniter.com
  35. * @since Version 2.0.3
  36. * @filesource
  37. */
  38. defined('BASEPATH') OR exit('No direct script access allowed');
  39. /**
  40. * SQLSRV Result Class
  41. *
  42. * This class extends the parent result class: CI_DB_result
  43. *
  44. * @category Database
  45. * @author EllisLab Dev Team
  46. * @link https://codeigniter.com/user_guide/database/
  47. */
  48. class CI_DB_sqlsrv_result extends CI_DB_result {
  49. /**
  50. * Scrollable flag
  51. *
  52. * @var mixed
  53. */
  54. public $scrollable;
  55. // --------------------------------------------------------------------
  56. /**
  57. * Constructor
  58. *
  59. * @param object $driver_object
  60. * @return void
  61. */
  62. public function __construct(&$driver_object)
  63. {
  64. parent::__construct($driver_object);
  65. $this->scrollable = $driver_object->scrollable;
  66. }
  67. // --------------------------------------------------------------------
  68. /**
  69. * Number of rows in the result set
  70. *
  71. * @return int
  72. */
  73. public function num_rows()
  74. {
  75. // sqlsrv_num_rows() doesn't work with the FORWARD and DYNAMIC cursors (FALSE is the same as FORWARD)
  76. if ( ! in_array($this->scrollable, array(FALSE, SQLSRV_CURSOR_FORWARD, SQLSRV_CURSOR_DYNAMIC), TRUE))
  77. {
  78. return parent::num_rows();
  79. }
  80. return is_int($this->num_rows)
  81. ? $this->num_rows
  82. : $this->num_rows = sqlsrv_num_rows($this->result_id);
  83. }
  84. // --------------------------------------------------------------------
  85. /**
  86. * Number of fields in the result set
  87. *
  88. * @return int
  89. */
  90. public function num_fields()
  91. {
  92. return @sqlsrv_num_fields($this->result_id);
  93. }
  94. // --------------------------------------------------------------------
  95. /**
  96. * Fetch Field Names
  97. *
  98. * Generates an array of column names
  99. *
  100. * @return array
  101. */
  102. public function list_fields()
  103. {
  104. $field_names = array();
  105. foreach (sqlsrv_field_metadata($this->result_id) as $offset => $field)
  106. {
  107. $field_names[] = $field['Name'];
  108. }
  109. return $field_names;
  110. }
  111. // --------------------------------------------------------------------
  112. /**
  113. * Field data
  114. *
  115. * Generates an array of objects containing field meta-data
  116. *
  117. * @return array
  118. */
  119. public function field_data()
  120. {
  121. $retval = array();
  122. foreach (sqlsrv_field_metadata($this->result_id) as $i => $field)
  123. {
  124. $retval[$i] = new stdClass();
  125. $retval[$i]->name = $field['Name'];
  126. $retval[$i]->type = $field['Type'];
  127. $retval[$i]->max_length = $field['Size'];
  128. }
  129. return $retval;
  130. }
  131. // --------------------------------------------------------------------
  132. /**
  133. * Free the result
  134. *
  135. * @return void
  136. */
  137. public function free_result()
  138. {
  139. if (is_resource($this->result_id))
  140. {
  141. sqlsrv_free_stmt($this->result_id);
  142. $this->result_id = FALSE;
  143. }
  144. }
  145. // --------------------------------------------------------------------
  146. /**
  147. * Result - associative array
  148. *
  149. * Returns the result set as an array
  150. *
  151. * @return array
  152. */
  153. protected function _fetch_assoc()
  154. {
  155. return sqlsrv_fetch_array($this->result_id, SQLSRV_FETCH_ASSOC);
  156. }
  157. // --------------------------------------------------------------------
  158. /**
  159. * Result - object
  160. *
  161. * Returns the result set as an object
  162. *
  163. * @param string $class_name
  164. * @return object
  165. */
  166. protected function _fetch_object($class_name = 'stdClass')
  167. {
  168. return sqlsrv_fetch_object($this->result_id, $class_name);
  169. }
  170. }