FatFs - f_chdir

## f_chdir

The f_chdir function changes the current directory of a drive.

    FRESULT f_chdir (
      const XCHAR* Path /* Pointer to the path name */
    );

#### Parameters

Path
  Pointer to the null-terminated string that specifies a directory to go.

#### Return Values

FR_OK (0)
  The function succeeded.
FR_NO_PATH
  Could not find the path.
FR_INVALID_NAME
  The path name is invalid.
FR_INVALID_DRIVE
  The drive number is invalid.
FR_NOT_READY
  The disk drive cannot work due to no medium in the drive or any other reason.
FR_DISK_ERR
  The function failed due to an error in the disk function.
FR_INT_ERR
  The function failed due to a wrong FAT structure or an internal error.
FR_NOT_ENABLED
  The logical drive has no work area.
FR_NO_FILESYSTEM
  There is no valid FAT volume on the disk.

#### Description

The f_chdir function changes the current directory of the logical drive. The current directory of a drive is initialized to the root directory when the drive is auto-mounted. Note that the current directory is retained in the each file system object so that it also affects other tasks that using the drive.

#### QuickInfo

Available when `_FS_RPATH == 1`.

#### Example

        // Change current direcoty of the current drive (dir1 under root dir)
        f_chdir("/dir1");

        // Change current direcoty of drive 2 (parent dir)
        f_chdir("2:..");

#### See Also

`f_chdrive`

Return