FatFs - f

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/doc/en/stat.html | 110 ------------------------------------------------- 1 file changed, 110 deletions(-) delete mode 100644 fatfs/doc/en/stat.html (limited to 'fatfs/doc/en/stat.html') diff --git a/fatfs/doc/en/stat.html b/fatfs/doc/en/stat.html deleted file mode 100644 index 2924660..0000000 --- a/fatfs/doc/en/stat.html +++ /dev/null @@ -1,110 +0,0 @@ - - - - - - - - -FatFs - f_stat - - - - -

f_stat

The f_stat function checks the existence of a file or sub-directory.

-FRESULT f_stat (
-  const TCHAR* path,  /* [IN] Object name */
-  FILINFO* fno        /* [OUT] FILINFO structure */
-);
-

- -

Parameters

path: Pointer to the null-terminated string that specifies the object to get its information.
fno: Pointer to the blank FILINFO structure to store the information of the object. Set null pointer if it is not needed.

- - -

Return Values

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

- - -

Description

The f_stat function checks the existence of a file or sub-directory. If not exist, the function returns with FR_NO_FILE. If exist, the function returns with FR_OK and the informations of the object, file size, timestamp and attribute, are stored to the file information structure. For details of the file information, refer to the FILINFO structure and f_readdir function.

- - -

QuickInfo

Available when _FS_MINIMIZE == 0.

- - -

Example

-    FRESULT fr;
-    FILINFO fno;
-
-
-    printf("Test for 'file.txt'...\n");
-
-    fr = f_stat("file.txt", &fno);
-    switch (fr) {
-
-    case FR_OK:
-        printf("Size: %lu\n", fno.fsize);
-        printf("Timestamp: %u/%02u/%02u, %02u:%02u\n",
-               (fno.fdate >> 9) + 1980, fno.fdate >> 5 & 15, fno.fdate & 31,
-               fno.ftime >> 11, fno.ftime >> 5 & 63);
-        printf("Attributes: %c%c%c%c%c\n",
-               (fno.fattrib & AM_DIR) ? 'D' : '-',
-               (fno.fattrib & AM_RDO) ? 'R' : '-',
-               (fno.fattrib & AM_HID) ? 'H' : '-',
-               (fno.fattrib & AM_SYS) ? 'S' : '-',
-               (fno.fattrib & AM_ARC) ? 'A' : '-');
-        break;
-
-    case FR_NO_FILE:
-        printf("It is not exist.\n");
-        break;
-
-    default:
-        printf("An error occured. (%d)\n", fr);
-    }
-

- - -

References

f_opendir, f_readdir, FILINFO

- -

Return

- - -- cgit v1.2.3