function SelectQueryInterface::addExpression

Adds an expression to the list of "fields" to be SELECTed.

An expression can be any arbitrary string that is valid SQL. That includes various functions, which may in some cases be database-dependent. This method makes no effort to correct for database-specific functions.

Parameters

$expression: The expression string. May contain placeholders.

$alias: The alias for this expression. If not specified, one will be generated automatically in the form "expression_#". The alias will be checked for uniqueness, so the requested alias may not be the alias that is assigned in all cases.

$arguments: Any placeholder arguments needed for this expression.

Return value

The unique alias that was assigned for this expression.

2 methods override SelectQueryInterface::addExpression()
SelectQuery::addExpression in includes/database/select.inc
Adds an expression to the list of "fields" to be SELECTed.
SelectQueryExtender::addExpression in includes/database/select.inc
Adds an expression to the list of "fields" to be SELECTed.

File

includes/database/select.inc, line 237

Class

SelectQueryInterface
Interface definition for a Select Query object.

Code

public function addExpression($expression, $alias = NULL, $arguments = array());

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