From 289f6a146c0b2087607d8d8659531ea90142779a Mon Sep 17 00:00:00 2001 From: Leo C Date: Sun, 27 May 2018 21:26:38 +0200 Subject: Import fatfs R0.13b --- fatfs/documents/doc/chdir.html | 88 ++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 88 insertions(+) create mode 100644 fatfs/documents/doc/chdir.html (limited to 'fatfs/documents/doc/chdir.html') diff --git a/fatfs/documents/doc/chdir.html b/fatfs/documents/doc/chdir.html new file mode 100644 index 0000000..072b9e9 --- /dev/null +++ b/fatfs/documents/doc/chdir.html @@ -0,0 +1,88 @@ + + + + + + + + +FatFs - f_chdir + + + + +
+

f_chdir

+

The f_chdir function changes the current directory of the logical drive.

+
+FRESULT f_chdir (
+  const TCHAR* path /* [IN] Path name */
+);
+
+
+ +
+

Parameters

+
+
path
+
Pointer to the null-terminated string that specifies the directory to go.
+
+
+ + +
+

Return Values

+

+FR_OK, +FR_DISK_ERR, +FR_INT_ERR, +FR_NOT_READY, +FR_NO_PATH, +FR_INVALID_NAME, +FR_INVALID_DRIVE, +FR_NOT_ENABLED, +FR_NO_FILESYSTEM, +FR_TIMEOUT, +FR_NOT_ENOUGH_CORE +

+
+ + +
+

Description

+

The f_chdir function changes the current directory of the logical drive. Also the current drive is changed at Unix style volume ID, FF_STR_VOLUME_ID == 2. The current directory of each logical drive is initialized to the root directory on mount.

+

Note that the current directory is retained in the each file system object and the current drive is retained in a static variable, so that it also affects other tasks that use the file functions.

+
+ + +
+

QuickInfo

+

Available when FF_FS_RPATH >= 1.

+
+ + +
+

Example

+
+    /* Change current direcoty of the current drive ("dir1" under root directory) */
+    f_chdir("/dir1");
+
+    /* Change current direcoty of current drive (parent directory of drive 2) */
+    f_chdir("2:..");
+
+    /* Change current direcoty of the drive "sdcard" (at DOS/Windows style volume ID) */
+    f_chdir("sdcard:/dir1");
+
+    /* Change current direcoty of the drive "flash" and set it as current drive (at Unix style volume ID) */
+    f_chdir("/flash/dir1");
+
+
+ +
+

See Also

+

f_chdrive, f_getcwd

+
+ +

Return

+ + -- cgit v1.2.3