Changeset 72a3af3 in rtems

Timestamp:

01/23/12 14:55:42 (12 years ago)

Author:

Sebastian Huber <sebastian.huber@…>

Branches:

4.11, 5, master

Children:

184a612e

Parents:

52694844

git-author:

Sebastian Huber <sebastian.huber@…> (01/23/12 14:55:42)

git-committer:

Sebastian Huber <sebastian.huber@…> (02/02/12 10:09:30)

Message:

Extended API to support iteration of const chains.

Location:

cpukit

Files:

• sapi/inline/rtems/chain.inl (modified) (9 diffs)
• score/inline/rtems/score/chain.inl (modified) (6 diffs)

cpukit/sapi/inline/rtems/chain.inl

@@ -136 +136 @@
 }
 
+/** @brief Return pointer to immutable Chain Head
+ *
+ *  This function returns a pointer to the head node on the chain.
+ *
+ *  @param[in] the_chain is the chain to be operated upon.
+ *
+ *  @return This method returns the permanent head node of the chain.
+ */
+RTEMS_INLINE_ROUTINE const rtems_chain_node *rtems_chain_immutable_head(
+  const rtems_chain_control *the_chain
+)
+{
+  return _Chain_Immutable_head( the_chain );
+}
+
 /**
  *  @brief Return pointer to Chain Tail
  *
- *  This function returns a pointer to the last node on the chain.
+ *  This function returns a pointer to the tail node on the chain.
  *
  *  @param[in] the_chain is the chain to be operated upon.
@@ -152 +167 @@
 }
 
+/** @brief Return pointer to immutable Chain Tail
+ *
+ *  This function returns a pointer to the tail node on the chain.
+ *
+ *  @param[in] the_chain is the chain to be operated upon.
+ *
+ *  @return This method returns the permanent tail node of the chain.
+ */
+RTEMS_INLINE_ROUTINE const rtems_chain_node *rtems_chain_immutable_tail(
+  const rtems_chain_control *the_chain
+)
+{
+  return _Chain_Immutable_tail( the_chain );
+}
+
 /**
  *  @brief Return pointer to Chain's First node after the permanent head.
@@ -169 +199 @@
 }
 
+/** @brief Return pointer to immutable Chain's First node
+ *
+ *  This function returns a pointer to the first node on the chain after the
+ *  head.
+ *
+ *  @param[in] the_chain is the chain to be operated upon.
+ *
+ *  @return This method returns the first node of the chain.
+ */
+RTEMS_INLINE_ROUTINE const rtems_chain_node *rtems_chain_immutable_first(
+  const rtems_chain_control *the_chain
+)
+{
+  return _Chain_Immutable_first( the_chain );
+}
+
 /**
  *  @brief Return pointer to Chain's Last node before the permanent tail.
@@ -186 +232 @@
 }
 
+/** @brief Return pointer to immutable Chain's Last node
+ *
+ *  This function returns a pointer to the last node on the chain just before
+ *  the tail.
+ *
+ *  @param[in] the_chain is the chain to be operated upon.
+ *
+ *  @return This method returns the last node of the chain.
+ */
+RTEMS_INLINE_ROUTINE const rtems_chain_node *rtems_chain_immutable_last(
+  const rtems_chain_control *the_chain
+)
+{
+  return _Chain_Immutable_last( the_chain );
+}
+
 /**
  *  @brief Return pointer the next node from this node
@@ -202 +264 @@
 }
 
+/** @brief Return pointer the immutable next node from this node
+ *
+ *  This function returns a pointer to the next node after this node.
+ *
+ *  @param[in] the_node is the node to be operated upon.
+ *
+ *  @return This method returns the next node on the chain.
+ */
+RTEMS_INLINE_ROUTINE const rtems_chain_node *rtems_chain_immutable_next(
+  const rtems_chain_node *the_node
+)
+{
+  return _Chain_Immutable_next( the_node );
+}
+
 /**
  *  @brief Return pointer the previous node from this node
@@ -216 +293 @@
 {
   return _Chain_Previous( the_node );
+}
+
+/** @brief Return pointer the immutable previous node from this node
+ *
+ *  This function returns a pointer to the previous node on this chain.
+ *
+ *  @param[in] the_node is the node to be operated upon.
+ *
+ *  @return This method returns the previous node on the chain.
+ */
+RTEMS_INLINE_ROUTINE const rtems_chain_node *rtems_chain_immutable_previous(
+  const rtems_chain_node *the_node
+)
+{
+  return _Chain_Immutable_previous( the_node );
 }
 
@@ -250 +342 @@
  */
 RTEMS_INLINE_ROUTINE bool rtems_chain_is_empty(
-  rtems_chain_control *the_chain
+  const rtems_chain_control *the_chain
 )
 {
@@ -324 +416 @@
  */
 RTEMS_INLINE_ROUTINE bool rtems_chain_is_head(
-  rtems_chain_control    *the_chain,
+  const rtems_chain_control *the_chain,
   const rtems_chain_node *the_node
 )
@@ -341 +433 @@
  */
 RTEMS_INLINE_ROUTINE bool rtems_chain_is_tail(
-  rtems_chain_control    *the_chain,
+  const rtems_chain_control *the_chain,
   const rtems_chain_node *the_node
 )

cpukit/score/inline/rtems/score/chain.inl

@@ -143 +143 @@
 /** @brief Return pointer to Chain Tail
  *
- *  This function returns a pointer to the last node on the chain.
+ *  This function returns a pointer to the tail node on the chain.
  *
  *  @param[in] the_chain is the chain to be operated upon.
@@ -158 +158 @@
 /** @brief Return pointer to immutable Chain Tail
  *
- *  This function returns a pointer to the last node on the chain.
+ *  This function returns a pointer to the tail node on the chain.
  *
  *  @param[in] the_chain is the chain to be operated upon.
@@ -250 +250 @@
 }
 
+/** @brief Return pointer the immutable next node from this node
+ *
+ *  This function returns a pointer to the next node after this node.
+ *
+ *  @param[in] the_node is the node to be operated upon.
+ *
+ *  @return This method returns the next node on the chain.
+ */
+RTEMS_INLINE_ROUTINE const Chain_Node *_Chain_Immutable_next(
+  const Chain_Node *the_node
+)
+{
+  return the_node->next;
+}
+
 /** @brief Return pointer the previous node from this node
  *
@@ -265 +280 @@
 }
 
+/** @brief Return pointer the immutable previous node from this node
+ *
+ *  This function returns a pointer to the previous node on this chain.
+ *
+ *  @param[in] the_node is the node to be operated upon.
+ *
+ *  @return This method returns the previous node on the chain.
+ */
+RTEMS_INLINE_ROUTINE const Chain_Node *_Chain_Immutable_previous(
+  const Chain_Node *the_node
+)
+{
+  return the_node->previous;
+}
+
 /** @brief Is the Chain Empty
  *
@@ -348 +378 @@
  */
 RTEMS_INLINE_ROUTINE bool _Chain_Is_head(
-  Chain_Control *the_chain,
+  const Chain_Control *the_chain,
   const Chain_Node    *the_node
 )
 {
-  return (the_node == _Chain_Head(the_chain));
+  return (the_node == _Chain_Immutable_head( the_chain ));
 }
 
@@ -364 +394 @@
  */
 RTEMS_INLINE_ROUTINE bool _Chain_Is_tail(
-  Chain_Control *the_chain,
+  const Chain_Control *the_chain,
   const Chain_Node    *the_node
 )
 {
-  return (the_node == _Chain_Tail(the_chain));
+  return (the_node == _Chain_Immutable_tail( the_chain ));
 }