function node_load_multiple

Same name in other branches
  1. 8.9.x core/modules/node/node.module \node_load_multiple()

Loads node entities from the database.

This function should be used whenever you need to load more than one node from the database. Nodes are loaded into memory and will not require database access if loaded again during the same page request.

@todo Remove $conditions in Drupal 8.

Parameters

$nids: An array of node IDs.

$conditions: (deprecated) An associative array of conditions on the {node} table, where the keys are the database fields and the values are the values those fields must have. Instead, it is preferable to use EntityFieldQuery to retrieve a list of entity IDs loadable by this function.

$reset: Whether to reset the internal node_load cache.

Return value

An array of node objects indexed by nid.

See also

entity_load()

EntityFieldQuery

14 calls to node_load_multiple()
blog_page_last in modules/blog/blog.pages.inc
Menu callback; displays a Drupal page containing recent blog entries of all users.
blog_page_user in modules/blog/blog.pages.inc
Menu callback; displays a Drupal page containing recent blog entries of a given user.
DrupalWebTestCase::drupalGetNodeByTitle in modules/simpletest/drupal_web_test_case.php
Get a node from the database based on its title.
NodeLoadHooksTestCase::testHookNodeLoad in modules/node/node.test
Test that hook_node_load() is invoked correctly.
NodeLoadMultipleTestCase::testNodeMultipleLoad in modules/node/node.test
Create four nodes and ensure they're loaded correctly.

... See full list

File

modules/node/node.module, line 946

Code

function node_load_multiple($nids = array(), $conditions = array(), $reset = FALSE) {
    return entity_load('node', $nids, $conditions, $reset);
}

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