LIBLIST library

Main Menu | CPOC | C68 for QDOS | History | Feedback

The LIBLIST library arose out of frustration I met when debugging a C program that was making extensive use of lists. All the books on C techniques often give code fragments, but I wondered if there was a standard library that could do all the mechanics automatically for me. I was unable to locate a generally available library that did it, so I therefore decided to write my own. The project grew beyond its original simple ideas to add some quite sophisticated capabilities.

The LIBLIST library described here is the result. It provides a generic way of handling all types of lists and related structures. The current version supports Single Linked lists, Double linked lists, Queues (FIFO), Stacks (LIFO), Binary Trees, Balanced Binary Trees and Hash Tables.

The LIBLIST library takes an object-oriented approach that provides clean separation between your application logic and any list handling related code. The user uses a simple "Methods and Properties" approach to handling lists, and is not be aware of any of the underlying complexities or control structures.

Online documentation This allows you to read the documentation online. You should be aware, however, that this quite extensive (123Kb) so you may prefer to download the compressed version below and read it off-line.

The following files are available for download:

LIBLIST library v1.5a - documentation in HTML format (31Kb) 23rd July 2000
Documentation in HTML format.
Any standard WWW browser should be capable of handling this file as no advanced HTML features are used.
LIBLIST library v1.5a - QDOS binaries (23Kb) 23rd July 2000
Libraries and associated header file compiled and ready for use with the "C68 for QDOS" system.
No documentation is included, so you will also need to download the documentation separately.
LIBLIST library v1.2 - Psion 3a (TopSpeed) binaries (27Kb)
Libraries and associated header file compiled and ready for use with the Psion 3a SIBO (TopSpeed) SDK.
No documentation is included, so you will also need to download the documentation separately.
LIBLIST library v1.5a - source only (115Kb) 23rd July 2000
For those who either have a machine for which there is no pre-prepared binary available for download, or if you simply like to have the source of a product, then this is all the files that you need to build a version of the LIBLIST library particular to your machine. You will require an ANSI C compiler.
No documentation is included, so you will also need to download the documentation separately.
LIBLIST library v1.5a - source and HTML documentation (161Kb) 23rd July 2000
Source (as above) but also includes a copy of the HTML documentation to avoid you having to download it separately.

I would welcome feedback on the LIBLIST library to tell me if others find it useful. Please feel free to make suggestions for improvement or enhancement. If you want to report a bug a bit of sample code that reproduces the bug would be helpful. If you simply think the LIBLIST library is great as it stands, then I would also be interested to know. I currently have no idea whether this library fulfills a real need or whether it was just me that encountered the problems that lead me to develop it in the first place.

Main Menu | CPOC | C68 for QDOS | History | Feedback