function PagerDefault::execute

Override the execute method.

Before we run the query, we need to add pager-based range() instructions to it.

Overrides SelectQueryExtender::execute

File

includes/pager.inc, line 59

Class

PagerDefault

Query extender for pager queries.

Code

public function execute() {
    // Add convenience tag to mark that this is an extended query. We have to
    // do this in the constructor to ensure that it is set before preExecute()
    // gets called.
    if (!$this->preExecute($this)) {
        return NULL;
    }
    // A NULL limit is the "kill switch" for pager queries.
    if (empty($this->limit)) {
        return;
    }
    $this->ensureElement();
    $total_items = $this->getCountQuery()
        ->execute()
        ->fetchField();
    $current_page = pager_default_initialize($total_items, $this->limit, $this->element);
    $this->range($current_page * $this->limit, $this->limit);
    // Now that we've added our pager-based range instructions, run the query normally.
    return $this->query
        ->execute();
}