Changeset 1644

Timestamp:

Aug 27, 2004, 1:17:54 PM (22 years ago)

Author:

Paul Price

Message:

Fixed order of arguments to match those for psMetadata, and removed
horrible "which" and "where" and replaced with "iterator" and
"location", which are more descriptive.

File:

• trunk/archive/pslib/include/psList.h (modified) (2 diffs)

trunk/archive/pslib/include/psList.h

@@ -42 +42 @@
 ;
 
-/** Destructor */
-void psListFree(psList *list,           ///< list to destroy
-                void (*elemFree)(void *)) ///< destructor for data on list
-;
-
 /**** List maintainence functions ****/
 
 /** Add to list */
 bool *psListAdd(psList *list,           ///< list to add to (may be NULL)
-                void *data,             ///< data item to add
-                int where)              ///< index, PS_LIST_HEAD, or PS_LIST_TAIL
+                int location,           ///< index, PS_LIST_HEAD, or PS_LIST_TAIL
+                void *data)             ///< data item to add
 ;
 
 /** Remove from a list */
 bool *psListRemove(psList *list,        ///< list to remove element from
-                   void *data,          ///< data item to remove
-                   int which)           ///< index of item, or PS_LIST_UNKNOWN, PS_LIST_NEXT, PS_LIST_PREV
+                   int location,        ///< index of item, or PS_LIST_UNKNOWN, PS_LIST_NEXT, PS_LIST_PREV
+                   void *data)          ///< data item to remove
 ;
 
 /** Retrieve from a list */
 void *psListGet(const psList *list,     ///< list to retrieve element from
-                int which)              ///< index of item, or PS_LIST_NEXT, PS_LIST_PREV, PS_LIST_UNKNOWN
+                int location)           ///< index of item, or PS_LIST_NEXT, PS_LIST_PREV, PS_LIST_UNKNOWN
 ;
 
@@ -81 +76 @@
 /** Set the iterator */
 void psListSetIterator(psList *list,    ///< list to retrieve element from
-                       int where,       ///< index, PS_LIST_HEAD, or PS_LIST_TAIL
-                       int which)       ///< the desired iterator
+                       int iterator,    ///< the desired iterator
+                       int location)    ///< index, PS_LIST_HEAD, or PS_LIST_TAIL
 ;
 
 /** Get next element relative to iter */
 void *psListGetNext(psList *list,       ///< list to retrieve element from
-                    int which)          ///< the desired iterator
+                    int iterator)       ///< the desired iterator
 ;
 
 /** Get prev element relative to iter */
 void *psListGetPrevious(psList *list,   ///< list to retrieve element from
-                        int which)      ///< the desired iterator
+                        int iterator)   ///< the desired iterator
 ;