RTEMS 4.10.2 On-Line Library

Chains Get the First Node

RTEMS C User's Guide

rtems_chain_node *rtems_chain_get(
  rtems_chain_control *the_chain
);

Returns a pointer a node. If a node was removed, then a pointer to that node is returned. If the chain was empty, then NULL is returned.

This function removes the first node from the chain and returns a pointer to that node. If the chain is empty, then NULL is returned.

Interrupts are disabled while obtaining the node to ensure the atomicity of the operation.

Use rtems_chain_get_unprotected() to avoid disabling of interrupts.

RTEMS C User's Guide