<?php namespace CodeIgniter\Database\SQLite3; /** * CodeIgniter * * An open source application development framework for PHP * * This content is released under the MIT License (MIT) * * Copyright (c) 2014-2017 British Columbia Institute of Technology * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. * * @package CodeIgniter * @author CodeIgniter Dev Team * @copyright 2014-2017 British Columbia Institute of Technology (https://bcit.ca/) * @license https://opensource.org/licenses/MIT MIT License * @link https://codeigniter.com * @since Version 3.0.0 * @filesource */ use CodeIgniter\Database\BaseResult; use CodeIgniter\Database\ResultInterface; /** * Result for SQLite3 */ class Result extends BaseResult implements ResultInterface { /** * Gets the number of fields in the result set. * * @return integer */ public function getFieldCount(): int { return $this->resultID->numColumns(); } //-------------------------------------------------------------------- /** * Generates an array of column names in the result set. * * @return array */ public function getFieldNames(): array { $fieldNames = []; for ($i = 0, $c = $this->getFieldCount(); $i < $c; $i ++) { $fieldNames[] = $this->resultID->columnName($i); } return $fieldNames; } //-------------------------------------------------------------------- /** * Generates an array of objects representing field meta-data. * * @return array */ public function getFieldData(): array { static $data_types = [ SQLITE3_INTEGER => 'integer', SQLITE3_FLOAT => 'float', SQLITE3_TEXT => 'text', SQLITE3_BLOB => 'blob', SQLITE3_NULL => 'null', ]; $retval = []; for ($i = 0, $c = $this->getFieldCount(); $i < $c; $i ++) { $retval[$i] = new \stdClass(); $retval[$i]->name = $this->resultID->columnName($i); $type = $this->resultID->columnType($i); $retval[$i]->type = isset($data_types[$type]) ? $data_types[$type] : $type; $retval[$i]->max_length = null; } return $retval; } //-------------------------------------------------------------------- /** * Frees the current result. * * @return mixed */ public function freeResult() { if (is_object($this->resultID)) { $this->resultID->finalize(); $this->resultID = false; } } //-------------------------------------------------------------------- /** * Moves the internal pointer to the desired offset. This is called * internally before fetching results to make sure the result set * starts at zero. * * @param integer $n * * @return mixed * @throws \CodeIgniter\DatabaseException */ public function dataSeek($n = 0) { if ($n !== 0) { if ($this->db->DBDebug) { throw new DatabaseException('SQLite3 doesn\'t support seeking to other offset.'); } return false; } return $this->resultID->reset(); } //-------------------------------------------------------------------- /** * Returns the result set as an array. * * Overridden by driver classes. * * @return array */ protected function fetchAssoc() { return $this->resultID->fetchArray(SQLITE3_ASSOC); } //-------------------------------------------------------------------- /** * Returns the result set as an object. * * Overridden by child classes. * * @param string $className * * @return object */ protected function fetchObject($className = 'stdClass') { // No native support for fetching rows as objects if (($row = $this->fetchAssoc()) === false) { return false; } elseif ($className === 'stdClass') { return (object) $row; } $classObj = new $className(); $classSet = \Closure::bind(function ($key, $value) { $this->$key = $value; }, $classObj, $className ); foreach (array_keys($row) as $key) { $classSet($key, $row[$key]); } return $classObj; } //-------------------------------------------------------------------- }