Datasheet

Mmc_Fat_Assign
329
MIKROELEKTRONIKA - SOFTWARE AND HARDWARE SOLUTIONS FOR EMBEDDED WORLD
Libraries
mikroC PRO for AVR
CHAPTER 6
Prototype
unsigned short Mmc_Fat_Assign(char * filename, char
file_cre_attr);
Returns
- 1 - if file already exists or file does not exist but new file is created.
- 0 - if file does not exist and no new file is created.
Description
Assigns file for file operations (read, write, delete...). All subsequent file opera-
tions will be applied over the assigned file.
Parameters:
-
filename: name of the file that should be assigned for file operations.
File name should be in DOS 8.3 (file_name.extension) format. The file
name and extension will be automatically padded with spaces by the
library if they have less than length required (i.e. "mikro.tx" ->
"mikro .tx "), so the user does no have to take care of that. The file
name and extension are case insensitive. The library will convert them
to proper case automatically, so the user does not have to take care of
that. Also, in order to keep backward compatibility with first version of
this library, file names can be entered as UPPERCASE string of 11
bytes in length with no dot character between file name and extension
(i.e. "MIKROELETXT" -> MIKROELE.TXT). In this case last 3 charac-
ters of the string are considered to be file extension.
-
file_cre_attr: file creation and attributs flags. Each bit corresponds
to appropriate file attribut:
Note: Long File Names (LFN) are not supported.
Bit Mask Description
0 0x01 Read Only
1 0x02 Hidden
2 0x04 System
3 0x08 Volume Label
4 0x10 Subdirectory
5 0x20 Archive
6 0x40 Device (internal use only, never found on disk)
7 0x80
File creation flag. If the file does not exist and this flag is set,
a new file with specified name will be created.