Datasheet

Cf_Fat_Assign
260
MIKROELEKTRONIKA - SOFTWARE AND HARDWARE SOLUTIONS FOR EMBEDDED WORLD
Libraries
mikroC PRO for AVR
CHAPTER 6
Prototype
unsigned short Cf_Fat_Assign(char *filename, char file_cre_attr);
Returns
- 0 if file does not exist and no new file is created.
- 1 if file already exists or file does not exist but a new file is created.
Description
Assigns file for file operations (read, write, delete...). All subsequent file operations
will be applied over the assigned file.
Parameters :
-
filename: name of the file that should be assigned for file operations. The 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 not have to take care of that.
The file name and extension are case insensitive. The library will convert them to prop-
er case automatically, so the user does not have to take care of that.
Also, in order to keep backward compatibility with the first version of this library,
file names can be entered as UPPERCASE string of 11 bytes in length with no dot
character between the file name and extension (i.e. "MIKROELETXT" ->
MIKROELE.TXT). In this case the last 3 characters of the string are considered to
be file extension.
-
file_cre_attr: file creation and attributs flags. Each bit corresponds to the
appropriate file attribut:
Note: Long File Names (LFN) are not supported.
Requires CF card and CF library must be initialized for file operations. See Cf_Fat_Init.
Example
// create file with archive attributes if it does not already
exist
Cf_Fat_Assign("MIKRO007.TXT",0xA0);
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.