Changeset 74 for trunk/src/helpers/linklist.c

Timestamp:

May 24, 2001, 5:21:06 PM (24 years ago)

Author:

umoeller

Message:

Misc updates

File:

• trunk/src/helpers/linklist.c (modified) (1 diff)

trunk/src/helpers/linklist.c

@@ -311 +311 @@
  *      This must only be used with heap lists created
  *      with lstCreate.
- */
-
-BOOL lstFree(PLINKLIST pList)
+ *
+ *      This uses a pointer to a PLINKLIST so that
+ *      the pointer is automatically reset to NULL
+ *      by this function AND to avoid confusion
+ *      with lstClear.
+ *
+ *@@changed V0.9.12 (2001-05-24) [umoeller]: changed prototype to use pointer to pointer
+ */
+
+BOOL lstFree(PLINKLIST *ppList)
 {
     BOOL brc = FALSE;
-
-    if (lstClear(pList))        // this checks for list integrity
-    {
-        // unset magic word; the pList pointer
-        // will point to invalid memory after
-        // freeing the list, and subsequent
-        // integrity checks must fail
-        pList->ulMagic = 0;
-        free(pList);
-
-        brc = TRUE;
-    }
+    PLINKLIST p;
+
+    if (    (ppList)
+         && (p = *ppList)
+       )
+        if (lstClear(p))        // this checks for list integrity
+        {
+            // unset magic word; the pList pointer
+            // will point to invalid memory after
+            // freeing the list, and subsequent
+            // integrity checks must fail
+            p->ulMagic = 0;
+            free(p);
+
+            *ppList = NULL;
+
+            brc = TRUE;
+        }
 
     return (brc);