TocNameArrayFind()

word TocNameArrayGetElement(
        DBGroupAndItem 		array, 
        word 		element,
        void 		*buffer);

Use this routine to find a name in the name list maintained by a PrefTocList object.

Include: config.goh

TocNameArrayGetElement()

word TocNameArrayGetElement(
        DBGroupAndItem 		array, 
        word 		element,
        void 		*buffer);

Use this routine to retrieve a given element from a name array maintained by a PrefTocList object.

Include: config.goh

TocSortedNameArrayAdd()

word TocSortedNameArrayAdd(
        word 		arr, 
        const char 		*nameToAdd,
        NameArrayAddFlags 		flags,
        const void 		*data);

This routine adds a name to a sorted name array associated with a PrefTocList object.

Structures:

        typedef WordFlags NameArrayAddFlags;
        #define NAAF_SET_DATA_ON_REPLACE 0x8000

Include: config.goh

TocSortedNameArrayFind()

Boolean TocSortedNameArrayFind(
        word 				arr, 
        const char 				*nameToFind,
        SortedNameArrayFindFlags 				flags,
        void 				*buffer, 
        word 				*elementNum);

This routine looks up a name in a sorted name array associated with a PrefTocList object.

Structures:

        typedef WordFlags SortedNameArrayFindFlags;
        #define SNAFF_IGNORE_CASE 0x0080

Include: config.goh

TocUpdateCategory()

void TocUpdateCategory(
        TocUpdateCategoryParams *params);

Use this routine to update a PrefTocList object based upon the files in a given directory with a given token.

Structures:

        typedef struct {
        	TocUpdateCategoryFlags 				TUCP_flags;
        	TokenChars 				TUCP_tokenChars;
        	byte 				TUCP_fileArrayElementSize;
         
        	TocUpdateAddCallback 				*TUCP_addCallback;
        	byte 				TUCP_pad; /* Wants to be word-aligned */
        } TocUpdateCategoryParams;
         
        typedef word _pascal TocUpdateAddCallback(
        	const char *filename,
        	optr chunkArray);
        /* Return 0 if add aborted, else return offset of new element within
         * block */

Include: config.goh

TOKEN_CHARS()

dword	TOKEN_CHARS(a, b, c, d)

This macro creates a single dword value from four given characters. This is useful when creating a token characters value for a specific token. The first two characters passed may be chars, the second two should be cast to dwords. A simple example:

TOKEN_CHARS(`S', `A', (dword) `M', (dword) `P');

TokenCloseLocalTokenDB()

void	TokenCloseLocalTokenDB()

This routine closes the local token database.