#include <stdio.h>
#include <stdlib.h>
#include <assert.h>
#pragma pack(1) // OPTIONAL: Makes the Valgrind messages more predictable

typedef struct _Node {
    int           value;
    struct _Node* next;
} Node;

void print_linked_list_of_ints(Node* head) {
    for(Node* curr = head; curr != NULL; curr = curr -> next) {
        printf("curr -> value == %d\n", curr -> value);
    }
}

void append(int value, Node** a_head, Node** a_tail) {
    // If head is NULL, tail must be, too.
    assert( (*a_tail == NULL) == (*a_head == NULL) );

    // create_list_node(value)
    Node* new_node = malloc(sizeof(*new_node));  // »add an object to HEAP
    new_node -> value = value;  // »fill in .value field  (12)
    new_node -> next  = NULL;   // »fill in .next  field  (NULL)

    if(*a_tail == NULL) {  // If list is empty
        *a_head = new_node;
    }
    else {  // Not empty....
        (*a_tail) -> next = new_node;
    }
    *a_tail = new_node;
}

void destroy_list(Node** a_head, Node** a_tail) {
    while(*a_head != NULL) {           // NOT:  while(*a_head) { … }
        Node* victim = *a_head;
        *a_head = (*a_head) -> next;
        free(victim);  // You would think that freeing the victim would
    }                  // let it get away.  This victim will not escape.
    *a_head = NULL;
    *a_tail = NULL;
}

int main(int argc, char* argv[]) {
    Node* head = NULL;
    Node* tail = NULL;
    append(10, &head, &tail); // &head is a Node**
    append(11, &head, &tail);
    append(12, &head, &tail);
    append(13, &head, &tail);
    append(14, &head, &tail);  // Vim tip:  Ctrl-A to add 1 to a number
    append(15, &head, &tail);  // Vim tip:  Don't try Ctrl-S.
    print_linked_list_of_ints(head);
    destroy_list(&head, &tail);  
    // TODO:  Free memory before we exit.
    return EXIT_SUCCESS;
}
/* vim: set tabstop=4 shiftwidth=4 fileencoding=utf-8 noexpandtab: */