RTEMS Logo

RTEMS 4.10.2 On-Line Library


Chains Get the First Node

PREV UP NEXT Bookshelf RTEMS Ada User's Guide

28.4.14: Get the First Node

CALLING SEQUENCE:

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.

Use rtems.chain_get_unprotected() to avoid disabling of interrupts.


PREV UP NEXT Bookshelf RTEMS Ada User's Guide

Copyright © 1988-2008 OAR Corporation