![]() |
![]() |
![]() |
![]() |
![]() |
This version of this document is no longer maintained. For the latest documentation, see http://www.qnx.com/developers/docs. |
Walk a file tree
#include <ftw.h> int nftw( const char *path, int (*fn)( const char *fname, const struct stat *sbuf, int flags, struct FTW *ftw), int depth, int flags);
If depth is zero or negative, the effect is the same as if it were 1. The depth must not be greater than the number of file descriptors currently available for use. The nftw() function is faster if depth is at least as large as the number of levels in the tree.
libc
Use the -l c option to qcc to link against this library. This library is usually included automatically.
![]() |
These functions are in libc.a, but not in libc.so (in order to save space). |
The nftw() function recursively descends the directory hierarchy identified by path. For each object in the hierarchy, nftw() calls the user-defined function fn(), passing to it:
The tree traversal continues until the tree is exhausted, an invocation of fn() returns a nonzero value, or some error is detected within nftw() (such as an I/O error). If the tree is exhausted, nftw() returns zero. If fn() returns a nonzero value, nftw() stops its tree traversal and returns whatever value was returned by fn().
When nftw() returns, it closes any file descriptors it opened; it doesn't close any file descriptors that may have been opened by fn().
nftw() is POSIX 1003.1 XSI; nftw64() is Large-file support
Safety: | |
---|---|
Cancellation point | Yes |
Interrupt handler | No |
Signal handler | Yes |
Thread | Yes |
Because nftw() is recursive, it might terminate with a memory fault when applied to very deep file structures.
This function uses malloc() to allocate dynamic storage during its operation. If nftw() is forcibly terminated, for example if longjmp() is executed by fn() or an interrupt routine, nftw() doesn't have a chance to free that storage, so it remains permanently allocated. A safe way to handle interrupts is to store the fact that an interrupt has occurred, and arrange to have fn() return a nonzero value at its next invocation.
ftw(), longjmp(), malloc(), stat()
![]() |
![]() |
![]() |
![]() |