FreeSet

Free space allocated for multiple sets.

Short Name

FRESET()

Type

ISAM function

Declaration

COUNT FreeSet()

Description

FreeSet() should be called when it is desired to free the space allocated by AllocateSet() for multiple, simultaneous sets.

Ordinarily, the only time it is necessary to call FreeSet() is when you desire to increase the number of simultaneous sets from a previous optional call to AllocateSet(). In this case, you call FreeSet() to free the buffers and then AllocateSet() with the new upper limit on sets.

CloseISAM() frees all set buffers if they have not already been freed via FreeSet().

Return

FreeSet() should always returns NO_ERROR (0) value. Even if FreeSet() is called when no buffers are allocated, it will simply return a zero without attempting to free any space. See “c-tree Plus Error Codes” in the c-tree Plus Programmer’s Reference Guide for a complete listing of valid c-tree Plus error values.

Example

if (AllocateSet(5) == 0)

    printf("\nRoom for 5 sets\n");


FreeSet();


if (AllocateSet(10) == 0)

    printf("\nRoom for 10 sets\n");