public function SelectQueryExtender::condition

Helper function: builds the most common conditional clauses.

This method can take a variable number of parameters. If called with two parameters, they are taken as $field and $value with $operator having a value of IN if $value is an array and = otherwise.

Do not use this method to test for NULL values. Instead, use QueryConditionInterface::isNull() or QueryConditionInterface::isNotNull().

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

See also

QueryConditionInterface::isNull()

QueryConditionInterface::isNotNull()

3 calls to SelectQueryExtender::condition()
SearchQuery::execute in drupal/modules/search/search.extender.inc
Executes the search.
SearchQuery::executeFirstPass in drupal/modules/search/search.extender.inc
Executes the first pass query.
SearchQuery::setOption in drupal/modules/search/search.extender.inc
Applies a search option and removes it from the search query string.

File

drupal/includes/database/select.inc, line 614

Class

SelectQueryExtender
The base extender class for Select queries.

Code

public function condition($field, $value = NULL, $operator = NULL) {
  $this->query
    ->condition($field, $value, $operator);
  return $this;
}