On 2014-05-28 23:48, Gedare Bloom wrote:
+/**
>+ * @brief Returns true if this is the most recent resource of the node, and
>+ * false otherwise.
>+ *
>+ * Resources are organized in last in first out order (LIFO).
>+ *
>+ * @param[in] node The node containing the resource.
>+ * @param[in] resource The resource in question.
>+ */
>+RTEMS_INLINE_ROUTINE bool _Resource_Is_most_recent_resource_of_node(
>+ const Resource_Node *node,
>+ const Resource_Control *resource
>+)
At first this function name confused me when I saw it used. I'm not
sure if a better name exists but it may be worth considering. Also,
this whole Resource handler is a bit odd compared to other data
structures in RTEMS, in that the interface functions take a Node first
and a Control second. Usually the Control comes first.
The first parameter is usually the this object. So for the _Resource_Node_*()
functions this is a node. The term "recent" implies temporal order and thus is
well defined. If we use "first", "last", "top" or whatever then we would have
to explicitly specify the order which makes the name even longer.
--
Sebastian Huber, embedded brains GmbH
Address : Dornierstr. 4, D-82178 Puchheim, Germany
Phone : +49 89 189 47 41-16
Fax : +49 89 189 47 41-09
E-Mail : sebastian.hu...@embedded-brains.de
PGP : Public key available on request.
Diese Nachricht ist keine geschäftliche Mitteilung im Sinne des EHUG.
_______________________________________________
rtems-devel mailing list
rtems-devel@rtems.org
http://www.rtems.org/mailman/listinfo/rtems-devel
