SList: a C library that implements Singly Linked Lists for classic Macintosh programs.

SList is free software; see the LICENSE file for copyright/licensing
---

# Install

This library has been built and tested using THINK C v5 on a Macintosh SE.

In order to install it, just import `slist.c` and `slist.h` to your project and include `slist.h` in your source files.

---

# Usage

## Creating a new list
```
// Create a new SList object.
SList* my_list = SList_new();
```

## Adding objects to the list
```
// Append an object at the end of the list.
slist_append(my_list, (Ptr)my_object);

// Insert an object at a given 0 based index position in the list. 
// (Third position in this case).
slist_insert_at(my_list, (Ptr)my_object, 2);

// Insert an object after the first occurence of another one.
slist_insert_after(my_list, (Ptr)my_object, (Ptr)other_object);
```

## Removing objects from the list
```
// Remove the first occurence of an object from the list.
slist_remove_value(my_list, (Ptr)my_object);

// Remove an object at a given 0 based index postion from the list. 
// (Third position in this case).
slist_remove_at(my_list, 2);

// Remove the last object from the list.
slist_remove_last(my_list);

// Remove all objects from the list.
slist_empty(my_list);
```

## Parsing a list
```
SL_FOREACH(item, list) {
		obj = (MyObject*)item->data;
}
```

You can customize the SL_FOREACH macro by re-implementing `SList.first()`, `SList.last()` and `SList.next()` for your own needs.