public function Merge::useDefaults

public Merge::useDefaults(array $fields)

Specifies fields for which the database-defaults should be used.

If you want to force a given field to use the database-defined default, not NULL or undefined, use this method to instruct the database to use default values explicitly. In most cases this will not be necessary unless you are inserting a row that is all default values, as you cannot specify no values in an INSERT query.

Specifying a field both in fields() and in useDefaults() is an error and will not execute.

Parameters

$fields: An array of values for which to use the default values specified in the table definition.

Return value

\Drupal\Core\Database\Query\Merge The called object.

File

core/lib/Drupal/Core/Database/Query/Merge.php, line 244

Class

Merge
General class for an abstracted MERGE query operation.

Namespace

Drupal\Core\Database\Query

Code

public function useDefaults(array $fields) {
  $this->defaultFields = $fields;
  return $this;
}

© 2001–2016 by the original authors
Licensed under the GNU General Public License, version 2 and later.
Drupal is a registered trademark of Dries Buytaert.
https://api.drupal.org/api/drupal/core!lib!Drupal!Core!Database!Query!Merge.php/function/Merge::useDefaults/8.1.x