Working with Files and File Systems in Recital

Working with Files and File Systems in Recital

Opening and Creating Text Files in Recital

• fcreate() - create a new text file, returning a file handle

numeric = fcreate(<filename as character>)

• fopen() - open an existing text file, returning a file handle

numeric = fopen(<filename as character> [, <mode as numeric>])

Closing Text Files in Recital

• fclose() - close a text file opened with fopen() or fcreate()

logical = fclose(<filehandle as numeric>)

Writing to a Text File using Recital

• fputs()- write a character string to a text file, returning the number of bytes written

numeric = fputs(<filehandle as numeric>, <string as character> [, <bytes as numeric> [, <terminator as character>]])

Reading From a Text File using Recital

• fgets() - read and return a line from a text file

character = fgets(<filehandle as numeric> [, <bytes as numeric> [, <terminator as character>]])

===Checking Whether a File Exists in Recital===
* [[FILE()|file()]] - check whether a file exists

<pre>
logical = file(<filename as character>)

Moving, Copying and Deleting Files with Recital

• rename - move a file

rename <sourcefile as character> [to] <targetfile as character>

• copy file - copy a file

copy file <sourcefile as character> [to] <targetfile as character>

• erase - delete a file or files

erase <filename as character [, filename as character [, ...]]>

• delete file - delete a file

delete file <filename as character>

Accessing File Attributes in Recital

• fileinfo() - return a comma-separated string containing information about a file

character = fileinfo(<filename as character>)

• fsize() - return the size of a file

numeric = fsize(<filename as character>)

• fdate() - return the last modification date of a file

date = fdate(<filename as character>)

• ftime() - return the last modification time of a file

character = ftime(<filename as character>)

• fullpath() - return the full path of a file

character = fullpath(<filename as character>)

• basename() - return the base filename of a file

character = basename(<filename as character>)

Miscellaneous File and File System Commands and Functions

• adir() - return number of files matching a pattern and load filenmames and information into arrays

numeric = adir(<skeleton as character> [, <filenames as array> [, <filesizes as array> 
[, <creationdates as array> [, <creationtimes as array> [, <attributes as array>]]]]])
 

• dir - display a directory of files

dir [<skeleton as character>]

• filecount()- return number of files matching a pattern

numeric = filecount(<skeleton as character>)

• curdir() - return name of the current directory

character = curdir()

• default()- return name of the current directory

character = default()

• set default - set current directory

set default to [<directory as character>]

• path() - return current Recital path setting

character = path()

• set path - set Recital path

set path to [<directories as character>]

• diskspace() - return the available space on the current disk

numeric = diskspace()