# FS_FindDir

## Syntax

  `#include <nitro/fs.h>`
  `BOOL FS_FindDir( FSFile *p_dir, const char *path );`

## Arguments

p_dir | Address of the `FSFile` structure.
path | Directory's path name

## Return Values

If the directory list is correctly opened it returns TRUE. Otherwise it returns FALSE.

## Description

This function opens a directory list using a specified path name. For more information on path name formatting, see the description of the `FS_OpenFileEx` function. If you call the `FS_ReadDir` function using the directory list that was opened, you will be able to sequentially list the file entries in the directory as an `FSDirEntry` structure.

## Note

This function cannot be called from the interrupt handler (IRQ mode).
Also note that in some cases processing may not end if interrupts are left prohibited.

## See Also

`FSFile
FSDirEntry
FS_ReadDir
FS_TellDir
FS_SeekDir
FS_RewindDir
FS_OpenFileEx
FS_FILE_NAME_MAX`

## Revision History

2008/10/02 Updated the See Also list.
2004/09/24 Added the description in the Caution section regarding the conditions for calling this function.
2004/04/08 Revised description due to the integration of `FSDir` and `FSFile`.
2004/04/01 Initial version.

CONFIDENTIAL