Close the least recently used c-tree virtual file.
vtclose() frees an operating system file descriptor by closing the least recently used open c-tree virtual file. In other words, the c-tree virtual file that has not been accessed for the longest period of time will be closed to the operating system, freeing up an operating system file descriptor.
Each time this function is called, c-tree attempts to free one operating system file descriptor.
Note: This function can impose a layer of overhead in Standalone Multi-user systems, especially in heavily loaded network environments. Rather than virtually closing files, it is preferable to increase the number of available operating system file descriptors. This is typically done through the C compiler run-time on non-Unix systems and in the operating system kernel for most Unix systems.
Note: This function is intended for non-server operation, including local library support. If a client side application calls this function, it is ignored so the application does not require special treatment when linking with different c-tree libraries.
vtclose() returns either YES (1) or NO (0). YES signifies a file handle was made available, NO signifies a file handle could not be freed.
“Virtual Files” in the index.