function db_query_range in Drupal 5

Same name in this branch

1. 5 includes/database.mysqli.inc \db_query_range()
2. 5 includes/database.mysql.inc \db_query_range()
3. 5 includes/database.pgsql.inc \db_query_range()

Same name and namespace in other branches

1. 8 core/includes/database.inc \db_query_range()
2. 4 includes/database.mysqli.inc \db_query_range()
3. 4 includes/database.mysql.inc \db_query_range()
4. 4 includes/database.pgsql.inc \db_query_range()
5. 6 includes/database.mysqli.inc \db_query_range()
6. 6 includes/database.mysql.inc \db_query_range()
7. 6 includes/database.pgsql.inc \db_query_range()
8. 7 includes/database/database.inc \db_query_range()

Runs a limited-range query in the active database.

Use this as a substitute for db_query() when a subset of the query is to be returned. User-supplied arguments to the query should be passed in as separate parameters so that they can be properly escaped to avoid SQL injection attacks.

Parameters

$query: A string containing an SQL query.

...: A variable number of arguments which are substituted into the query using printf() syntax. The query arguments can be enclosed in one array instead. Valid %-modifiers are: %s, %d, %f, %b (binary data, do not enclose in '') and %%.

NOTE: using this syntax will cast NULL and FALSE values to decimal 0, and TRUE values to decimal 1.

$from: The first result row to return.

$count: The maximum number of result rows to return.

Return value

A database query result resource, or FALSE if the query was not executed correctly.

Related topics

30 calls to db_query_range()

aggregator_block in modules/aggregator/aggregator.module

Implementation of hook_block().

aggregator_page_categories in modules/aggregator/aggregator.module

Menu callback; displays all the categories used by the aggregator.

aggregator_page_rss in modules/aggregator/aggregator.module

Menu callback; generate an RSS 0.92 feed of aggregator items or categories.

aggregator_page_sources in modules/aggregator/aggregator.module

Menu callback; displays all the feeds used by the aggregator.

blogapi_blogger_get_recent_posts in modules/blogapi/blogapi.module

Blogging API callback. Returns the latest few postings in a user's blog. $bodies TRUE <a href="http://movabletype.org/docs/mtmanual_programmatic.html#item_mt%2EgetRece... returns a bandwidth-friendly list</a>.

... See full list

File

includes/database.mysql.inc, line 308

Database interface code for MySQL database servers.

Code

function db_query_range($query) {
  $args = func_get_args();
  $count = array_pop($args);
  $from = array_pop($args);
  array_shift($args);
  $query = db_prefix_tables($query);
  if (isset($args[0]) and is_array($args[0])) {

    // 'All arguments in one array' syntax
    $args = $args[0];
  }
  _db_query_callback($args, TRUE);
  $query = preg_replace_callback(DB_QUERY_REGEXP, '_db_query_callback', $query);
  $query .= ' LIMIT ' . (int) $from . ', ' . (int) $count;
  return _db_query($query);
}