class InsertQuery_sqlite

SQLite specific implementation of InsertQuery.

We ignore all the default fields and use the clever SQLite syntax: INSERT INTO table DEFAULT VALUES for degenerated "default only" queries.

Hierarchy

Expanded class hierarchy of InsertQuery_sqlite

Related topics

Database abstraction layer
Allow the use of different database servers using the same code base.

File

includes/database/sqlite/query.inc, line 20

View source 
class InsertQuery_sqlite extends InsertQuery {
    public function execute() {
        if (!$this->preExecute()) {
            return NULL;
        }
        if (count($this->insertFields) || !empty($this->fromQuery)) {
            return parent::execute();
        }
        else {
            return $this->connection
                ->query('INSERT INTO {' . $this->table . '} DEFAULT VALUES', array(), $this->queryOptions);
        }
    }
    public function __toString() {
        // Create a sanitized comment string to prepend to the query.
        $comments = $this->connection
            ->makeComment($this->comments);
        // Produce as many generic placeholders as necessary.
        $placeholders = array();
        if (!empty($this->insertFields)) {
            $placeholders = array_fill(0, count($this->insertFields), '?');
        }
        // If we're selecting from a SelectQuery, finish building the query and
        // pass it back, as any remaining options are irrelevant.
        if (!empty($this->fromQuery)) {
            $insert_fields_string = $this->insertFields ? ' (' . implode(', ', $this->insertFields) . ') ' : ' ';
            return $comments . 'INSERT INTO {' . $this->table . '}' . $insert_fields_string . $this->fromQuery;
        }
        return $comments . 'INSERT INTO {' . $this->table . '} (' . implode(', ', $this->insertFields) . ') VALUES (' . implode(', ', $placeholders) . ')';
    }

}

Members

Title Modifiers Object type Summary Overriden Title Overrides
InsertQuery::$defaultFields protected property An array of fields that should be set to their database-defined defaults.
InsertQuery::$fromQuery protected property A SelectQuery object to fetch the rows that should be inserted.
InsertQuery::$insertFields protected property An array of fields on which to insert.
InsertQuery::$insertValues protected property A nested array of values to insert.
InsertQuery::$table protected property The table on which to insert.
InsertQuery::fields public function Adds a set of field->value pairs to be inserted.
InsertQuery::from public function Sets the fromQuery on this InsertQuery object.
InsertQuery::preExecute public function Preprocesses and validates the query.
InsertQuery::useDefaults public function Specifies fields for which the database defaults should be used.
InsertQuery::values public function Adds another set of values to the query to be inserted.
InsertQuery::__construct public function Constructs an InsertQuery object. Overrides Query::__construct
InsertQuery_sqlite::execute public function Executes the insert query. Overrides InsertQuery::execute
InsertQuery_sqlite::__toString public function Implements PHP magic __toString method to convert the query to a string. Overrides InsertQuery::__toString
Query::$comments protected property An array of comments that can be prepended to a query.
Query::$connection protected property The connection object on which to run this query.
Query::$connectionKey protected property The key of the connection object.
Query::$connectionTarget protected property The target of the connection object.
Query::$nextPlaceholder protected property The placeholder counter.
Query::$queryOptions protected property The query options to pass on to the connection object.
Query::$uniqueIdentifier protected property A unique identifier for this query object.
Query::comment public function Adds a comment to the query.
Query::getComments public function Returns a reference to the comments array for the query.
Query::nextPlaceholder public function Gets the next placeholder value for this query object. Overrides QueryPlaceholderInterface::nextPlaceholder
Query::uniqueIdentifier public function Returns a unique identifier for this object. Overrides QueryPlaceholderInterface::uniqueIdentifier
Query::__clone public function Implements the magic __clone function. 1
Query::__sleep public function Implements the magic __sleep function to disconnect from the database.
Query::__wakeup public function Implements the magic __wakeup function to reconnect to the database.

Buggy or inaccurate documentation? Please file an issue. Need support? Need help programming? Connect with the Drupal community.