function pager_find_page

Same name in other branches
  1. 8.9.x core/includes/pager.inc \pager_find_page()

Returns the current page being requested for display within a pager.

Parameters

$element: An optional integer to distinguish between multiple pagers on one page.

Return value

The number of the current requested page, within the pager represented by $element. This is determined from the URL query parameter $_GET['page'], or 0 by default. Note that this number may differ from the actual page being displayed. For example, if a search for "example text" brings up three pages of results, but a users visits search/node/example+text?page=10, this function will return 10, even though the default pager implementation adjusts for this and still displays the third page of search results at that URL.

See also

pager_default_initialize()

2 calls to pager_find_page()
EntityFieldQuery::initializePager in includes/entity.inc
Gets the total number of results and initializes a pager for the query.
pager_default_initialize in includes/pager.inc
Initializes a pager for theme('pager').

File

includes/pager.inc, line 202

Code

function pager_find_page($element = 0) {
    $page = isset($_GET['page']) ? $_GET['page'] : '';
    $page_array = explode(',', $page);
    if (!isset($page_array[$element])) {
        $page_array[$element] = 0;
    }
    return (int) $page_array[$element];
}

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