Data Structures

Here are the data structures with brief descriptions:

_khttpd_Response	A class that wraps an HTTP response, and provides methods to set headers, etc
_khttpd_Server	A class implementing a general-purpose HTTP server, with file retrieval and hooks to integrate the handling of non-file requests
_klib_Array	A fixed-sized array of anything which is derived from klib_object
_klib_AssocArray	An associative array of klib_object, indexed by string keys
_klib_Error	An object representing an error -- instantiated by any klib method can fail (in lieu of proper exception handling in C)
_klib_HttpRequest	An object which models an HTTP request URI
_klib_HttpResponse	An object which models an HTTP response
_klib_Integer	An object which wraps a simple integer, so it can be used in a klib_List or klib_Array
_klib_JSONParser	An object which provides a JSON parser
_klib_List	A singly-linked list of any object derived from klib_Object
_klib_ListItem	Wraps individual objects in a klib_List
_klib_NVPair	A name-value pair, where the name is char*, and the value any subclass of klib_Object
_klib_Object	The basic basic structure underling all klib objects
_klib_Path	A filesystem path, modelled in a platform-agnostic way
_klib_PropsFile	A properties file -- essentially a klib_AssocArray with additional methods to read and write contents to and from a file
_klib_Socket	Wraps a TCP socket, providing convenience functions for reading and writing klib objects from a TCP stream
_klib_String	A variable-length text string in UTF-8 encoding. The string is automatically expanded if required. NULL is an acceptable value for a string, and operations done on NULL strings are generally safe -- the NULL value is silently converted to an empty string when this happens. This conversion is not done in the _new() methods -- a NULL passed to _new() cretes a valid NULL string. However, methods whose names end in _safe() will always upgrade a NULL string to an empty String, so that clients classes need not do specific NULL checks themselves
_kmediad_Album	An object that holds information about an album -- artist, composer etc
_kmediad_Database	A wrapper for the sqlite3 database that kmediad uses for media information. All media items are index according to their location in the media directory tree. Typically finding an item in the database involves creating a kmediad_MediaInfo object, initializing its path field, and calling kmediad_database_get_mi_from_path
_kmediad_MediaInfo	Models a single row in the media database table. The fields title, album, composer, etc., do what they say. The path field is the location of the item in the media directory tree; this is also used as an index to the media database
_kmediad_MediaScanner	A class that implements a scanner for directories containing media files. The scanner descends the directories recursively, parsing ID3 and FLAC tags, and extracting embedded album are. This class is intended to be used in a separate thread or process, as the operation is likely to take a long time on large collections
_kmediad_SearchConstraints	Models search constraints in a way that can be converted to and from a URI in a web browser or other client. Each constraint is represented by a kmediad_SearchOp object in the list 'ops'. The search contraints can be applied distjuncively (OR) or conjunctively (AND). Obviously this syntax is not as powerful as SQL, but it's safer and more elegant than passing SQL queries in HTTP requests
_kmediad_SearchOp	Models a single search operation, in a list of search operations
_kmediad_Server	The HTTP server implementation that is specific to kmediad
_XineInterface	A class that wraps the Xine media player engine, and provides convenience functions for interfacing it to klib applications
Cmd	An entry in the function table that maps command names used int the HTTP interface with methods calls on kmediad_CmdProc
kmediad_CmdProc	The command processor
kmediad_Gui	The graphical user interface
Tag	Models a single ID3 tag
TagData	A linked list of Tag objects