#include <linklist.h> DLL_Return DLL_FindRecord(List *list, Info *record, Info *match, int (*pFun)(Info *, Info *)); DLL_Return DLL_FindNthRecord(List *list, Info *record, unsigned long skip); DLL_Return DLL_GetCurrentRecord(List *list, Info *record); DLL_Return DLL_GetPriorRecord(List *list, Info *record); DLL_Return DLL_GetNextRecord(List *list, Info *record);
Where the return value is
less than zero: arg1 < arg2, zero: arg1 == arg2, or greater than zero: arg1 > arg2.
Below is an example of this function:
int sort_foo(Info *record, Info *compare) { return(strcmp(rcrd->info_element, cmp->info_element)); }
The value DLL_NULL_FUNCTION, if returned, indicates that a NULL was passed as the fourth argument; DLL_NULL_LIST indicates that the list is empty; DLL_NOT_FOUND indicates that a record could not be found; and DLL_NORMAL indicates that the function succeeded in its task.
Carl J. Nobile 2012-01-17