# FS_SetCurrentDirectory

## Syntax

    #include <nitro/fs.h>

    BOOL FS_SetCurrentDirectory(const char *path);

## Arguments

path | Path that specifies the current directory.

## Return Values

Returns TRUE if the current directory was set properly; FALSE otherwise. In case of failure, use `FS_GetResultCode()` to get the error details.

## Description

Sets the current directory. The system will reference the current directory that was specified with this function when a relative path is specified in calls to FS library functions.

This function returns `TRUE` if the archive exists, even if the specified directory does not currently exist.

## Note

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

## See Also

`FS_OpenFileEx FS_OpenDirectory FS_CreateFile FS_DeleteFile FS_RenameFile FS_CreateDirectory FS_DeleteDirectory FS_RenameDirectory`

## Revision History

2008/09/08 Explained that directories that do not exist can be specified.
2007/11/01 Fixed a typo in the arguments.
2007/09/18 Initial version.

CONFIDENTIAL