Mikroelektronika MIKROE-724 データシート

mikroBasic PRO for dsPIC30/33 and PIC24

MikroElektronika

287

Cf_Fat_Assign

Prototype

sub function Cf_Fat_Assign(dim byref filename as char[12], dim file_cre_attr

as byte) as word

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 proper 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 attributes flags. Each bit corresponds to the appropriate file

attribute:

Returns

if file does not exist and no new file is created.

if file already exists or file does not exist but a new file is created.

Requires

CF card and CF library must be initialized for file operations. See Cf_Fat_Init.

Example

‘ create file with archive attribut if it does not already exist

Cf_Fat_Assign(“MIKRO007.TXT”,0xA0)

Notes

Long File Names (LFN) are not supported.

Bit

Mask

Description

0x01

Read Only

0x02

Hidden

0x04

System

0x08

Volume Label

0x10

Subdirectory

0x20