public function SelectQueryInterface::union

1 select.inc public SelectQueryInterface::union(SelectQueryInterface $query, $type = '')

Add another Select query to UNION to this one.

Union queries consist of two or more queries whose results are effectively concatenated together. Queries will be UNION'ed in the order they are specified, with this object's query coming first. Duplicate columns will be discarded. All forms of UNION are supported, using the second '$type' argument.

Note: All queries UNION'ed together must have the same field structure, in the same order. It is up to the caller to ensure that they match properly. If they do not, an SQL syntax error will result.

Parameters

$query: The query to UNION to this query.

$type: The type of UNION to add to the query. Defaults to plain UNION.

Return value

SelectQueryInterface: The called object.

2 methods override SelectQueryInterface::union()

SelectQuery::union in core/includes/database/select.inc: Implements SelectQueryInterface::union().
SelectQueryExtender::union in core/includes/database/select.inc: Add another Select query to UNION to this one.

File

core/includes/database/select.inc, line 451

Class

SelectQueryInterface: Interface definition for a Select Query object.

Code

public function union(SelectQueryInterface $query, $type = '');