Update list.c

Updating in line comments.
This commit is contained in:
Michael Tryby
2019-04-10 11:11:13 -04:00
parent 6537b4fca0
commit 3d62254eb8

View File

@@ -113,8 +113,8 @@ void *head_list(list_t *list, bool removeFromList)
assert(list->head != NULL);
listNode *node = list->head;
// Allocating and copying pointer to node data
void *element = (void *)malloc(list->elementSize);
// Copying pointer to node->data
memcpy(element, node->data, list->elementSize);
if(removeFromList) {
@@ -126,18 +126,25 @@ void *head_list(list_t *list, bool removeFromList)
free(node->data);
free(node);
}
// Now element points to data formerly pointed to by node
// Now element points to data formerly pointed to by node. Caller
// is responsible for freeing both pointer to data and data.
return element;
}
void *tail_list(list_t *list)
//
// Warning: Caller is responsible for freeing the node->data returned.
//
{
assert(list->tail != NULL);
listNode *node = list->tail;
// Allocating and copying pointer to node data
void *element = (void *)malloc(list->elementSize);
memcpy(element, node->data, list->elementSize);
// Pointer to element data gets returned. Caller is responsible
// for freeing pointer to data.
return element;
}