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 DatabaseCondition::condition

Implements QueryConditionInterface::condition().

Parameters

$field: The name of the field to check. If you would like to add a more complex condition involving operators or functions, use where().

$value: The value to test the field against. In most cases, this is a scalar. For more complex options, it is an array. The meaning of each element in the array is dependent on the $operator.

$operator: The comparison operator, such as =, <, or >=. It also accepts more complex options such as IN, LIKE, or BETWEEN. Defaults to IN if $value is an array, and = otherwise.

Return value

QueryConditionInterface The called object.

Overrides QueryConditionInterface::condition

4 calls to DatabaseCondition::condition()
DatabaseCondition::exists in includes/database/query.inc
Implements QueryConditionInterface::exists().
DatabaseCondition::isNotNull in includes/database/query.inc
Implements QueryConditionInterface::isNotNull().
DatabaseCondition::isNull in includes/database/query.inc
Implements QueryConditionInterface::isNull().
DatabaseCondition::notExists in includes/database/query.inc
Implements QueryConditionInterface::notExists().

File

includes/database/query.inc, line 1746

Class

DatabaseCondition
Generic class for a series of conditions in a query.

Code

public function condition($field, $value = NULL, $operator = NULL) {
 if (!isset($operator)) {
 if (is_array ($value)) {
 $operator = 'IN';
 }
 elseif (!isset($value)) {
 $operator = 'IS NULL';
 }
 else {
 $operator = '=';
 }
 }
 $this->conditions [] = array(
 'field' => $field,
 'value' => $value,
 'operator' => $operator,
 );
 $this->changed  = TRUE;
 return $this;
}

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