DF_FILE_NEXT_EMPTY

See Also: Get_Attribute, Set_Attribute, DF_FILE_NEXT_OPENED, DF_FILE_NEXT_USED

The number of the next unused slot in the filelist (in ascending order).

Level

Table

Supported by

All Drivers

Type

Numeric, permanent

Access

Read / Write

Values

0 .. 4095

Remarks

This attribute returns the next unused slot in the filelist (in ascending order). A filelist slot is considered empty if the DF_FILE_ROOT_NAME attribute of that slot is empty. If there is no higher-numbered empty slot in the filelist, DF_FILE_NEXT_EMPTY is 0 (zero).

Function IsSlotFree Handle hTable Returns Boolean
    Handle hNext
    Get_Attribute DF_FILE_NEXT_EMPTY Of (hTable - 1) To hNext
    Function_Return (hTable = hNext)
End_Function // IsSlotFree

The sample function above determines if the slot for a given handle is free.