Error message

You are browsing documentation for drupal 7.x, which is not supported anymore. Read the updated version of this page for drupal 11.x (the latest version).

function InsertQuery::preExecute

Preprocesses and validates the query.

Return value

TRUE if the validation was successful, FALSE if not.

Throws

FieldsOverlapException

NoFieldsException

4 calls to InsertQuery::preExecute()
InsertQuery::execute in includes/database/query.inc
Executes the insert query.
InsertQuery_mysql::execute in includes/database/mysql/query.inc
Executes the insert query.
InsertQuery_pgsql::execute in includes/database/pgsql/query.inc
Executes the insert query.
InsertQuery_sqlite::execute in includes/database/sqlite/query.inc
Executes the insert query.

File

includes/database/query.inc, line 698

Class

InsertQuery
General class for an abstracted INSERT query.

Code

public function preExecute() {
 // Confirm that the user did not try to specify an identical
 // field and default field.
 if (array_intersect ($this->insertFields , $this->defaultFields )) {
 throw new FieldsOverlapException ('You may not specify the same field to have a value and a schema-default value.');
 }
 if (!empty($this->fromQuery )) {
 // We have to assume that the used aliases match the insert fields.
 // Regular fields are added to the query before expressions, maintain the
 // same order for the insert fields.
 // This behavior can be overridden by calling fields() manually as only the
 // first call to fields() does have an effect.
 $this->fields (array_merge (array_keys ($this->fromQuery 
 ->getFields ()), array_keys ($this->fromQuery 
 ->getExpressions ())));
 }
 else {
 // Don't execute query without fields.
 if (count ($this->insertFields ) + count ($this->defaultFields ) == 0) {
 throw new NoFieldsException ('There are no fields available to insert with.');
 }
 }
 // If no values have been added, silently ignore this query. This can happen
 // if values are added conditionally, so we don't want to throw an
 // exception.
 if (!isset($this->insertValues [0]) && count ($this->insertFields ) > 0 && empty($this->fromQuery )) {
 return FALSE;
 }
 return TRUE;
}

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