FRESULT f_lseek ( FIL* fp, /* [IN] File object */ - FSIZE_t ofs /* [IN] File read/write pointer */ + FSIZE_t ofs /* [IN] Offset of file read/write pointer to be set */ +); ++
+FRESULT f_rewind ( + FIL* fp /* [IN] File object */ );@@ -48,14 +53,17 @@ FRESULT f_lseek (
File read/write ponter in the open file object points the data byte to be read/written at next read/write operation. It advances as the number of bytes read/written. The f_lseek function moves the file read/write pointer without any read/write operation to the file.
-When an offset beyond the file size is specified at write mode, the file size is expanded to the specified offset. The file data in the expanded area is undefined because no data is written to the file in this process. This is suitable to pre-allocate a data area to the file quickly for fast write operation. When a contiguous data area needs to be allocated to the file, use f_expand function instead. After the f_lseek function succeeded, the current read/write pointer should be checked in order to make sure the read/write pointer has been moved correctry. In case of the read/write pointer is not the expected value, either of followings has been occured.
+File read/write ponter in the open file object points the data byte to be read/written at next read/write operation. It advances as the number of bytes read/written. The f_lseek function moves the file read/write pointer without any read/write operation to the file. The f_rewind function is impremented as a macro.
++#define f_rewind(fp) f_lseek((fp), 0) ++
If an offset beyond the file size is specified in write mode, the file size is expanded to the specified offset. The file data in the expanded part is undefined, because no data is written to the file in this process. This is suitable to pre-allocate a data area to the file quickly for fast write operation. When a contiguous data area needs to be allocated to the file, use f_expand function instead. After the f_lseek function succeeded, the current read/write pointer should be checked in order to make sure the read/write pointer has been moved correctry. In case of the read/write pointer is not pointing expected offset, either of followings has been occured.
The fast seek function enables fast backward/long seek operations without FAT access by using an on-memory CLMT (cluster link map table). It is applied to f_read and f_write function as well, however, the file size cannot be expanded by f_write, f_lseek function while the file is at fast seek mode.
-The fast seek mode is enabled when the member cltbl in the file object is not NULL. The CLMT must be created into the DWORD array prior to use the fast seek function. To create the CLMT, set address of the DWORD array to the member cltbl in the open file object, set the size of array in unit of items to the first item and call the f_lseek function with ofs = CREATE_LINKMAP. After the function succeeded and CLMT is created, no FAT access is occured in subsequent f_read, f_write, f_lseek function to the file. The number of items used or required is returned into the first item of the array. The number of items to be used is (number of the file fragments + 1) * 2. For example, when the file is fragmented in 5, 12 items in the array will be used. If the function failed with FR_NOT_ENOUGH_CORE, the given array size is insufficient for the file.
+The fast seek feature enables fast backward/long seek operations without FAT access by using an on-memory CLMT (cluster link map table). It is applied to f_read and f_write function as well, however, the file size cannot be expanded by f_write, f_lseek function while the file is at fast seek mode.
+The fast seek mode is available when FF_USE_FASTSEEK = 1. The CLMT must be created into the DWORD array prior to use the fast seek mode. To create the CLMT, set address of the DWORD array to the member cltbl in the open file object, set the size of array in unit of items to the cltbl[0] and then call f_lseek function with ofs = CREATE_LINKMAP. After the function succeeded, no FAT access is occured in subsequent f_read, f_write, f_lseek function to the file. The number of items used or required is returned into the cltbl[0]. The number of items needed is (number of the file fragments + 1) * 2. For example, 12 items in the array will be used for the file fragmented in 5 portions. If the function failed with FR_NOT_ENOUGH_CORE, the size of given array is insufficient for the file.
@@ -93,17 +101,17 @@ FRESULT f_lseek (
res = f_lseek(fp, PRE_SIZE); /* Expand file size (cluster pre-allocation) */
if (res || f_tell(fp) != PRE_SIZE) ... /* Check if the file has been expanded successfly */
- res = f_lseek(fp, DATA_START); /* Record data stream WITHOUT cluster allocation delay */
+ res = f_lseek(fp, OFS_DATA); /* Record data stream with free from cluster allocation delay */
... /* Write operation should be aligned to sector boundary to optimize the write throughput */
res = f_truncate(fp); /* Truncate unused area */
- res = f_lseek(fp, 0); /* Set file header */
+ res = f_lseek(fp, OFS_HEADER); /* Set file header */
...
res = f_close(fp);
-/* Using fast seek function */ +/* Using fast seek mode */ DWORD clmt[SZ_TBL]; /* Cluster link map table buffer */ @@ -111,7 +119,7 @@ FRESULT f_lseek ( res = f_lseek(fp, ofs1); /* This is normal seek (cltbl is nulled on file open) */ - fp->cltbl = clmt; /* Enable fast seek function (cltbl != NULL) */ + fp->cltbl = clmt; /* Enable fast seek mode (cltbl != NULL) */ clmt[0] = SZ_TBL; /* Set table size */ res = f_lseek(fp, CREATE_LINKMAP); /* Create CLMT */ ...