RTEMS Logo

RTEMS 4.9.2 On-Line Library


Chains Get the First Node

PREV UP NEXT Bookshelf RTEMS C User's Guide

28.4.14: Get the First Node

CALLING SEQUENCE:

rtems_chain_node *rtems_chain_get(
  rtems_chain_control *the_chain
);

RETURNS

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.

DESCRIPTION:

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.

NOTES:

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


PREV UP NEXT Bookshelf RTEMS C User's Guide

Copyright © 1988-2008 OAR Corporation