>> << Ndx Usr Pri Phr Dic Rel Voc !: wd Help User

# files: file access utilities

read verbs take a right argument of a filename, optionally linked with one or two numbers (as for 1!:11): 0 = start of read (may be negative) 1 = length of read (default rest of file)

write verbs return number of characters written.

filenames may be open or boxed character strings.

string verbs write out text delimited with the host OS delimiter, and read in text delimited by LF.

on error, the result is 1, e.g. for file not found/file read error/file write error

Name | Type | Description
fappend | verb | append text to file
fappends | verb | append string to file
fcopynew | verb | copies files if changed
fcopynews | verb | copies files as strings if changed
fdir | verb | file directory
ferase | verb | erases a file
fexist | verb | test if a file exists
fread | verb | read file
freadr | verb | read records from flat file
freads | verb | read file as string
freplace | verb | replace text in file
fselect | verb | file selection dialog
fsize | verb | return file size
fss | verb | file string search
fssrplc | verb | file string search and replace
fstamp | verb | returns file timestamp
fview | verb | view file
fwrite | verb | write text to file
fwrites | verb | write string to file

fappend

    append text to file
    	The text is first ravelled. The file is created if necessary.
    Returns number of characters written, or an error message.
    form: text fappend filename
    example:
      'chatham' fappend 'newfile.txt'
    7

fappends

    append string to file
    The text is first ravelled into a vector with each row
    terminated by the CRLF pair. Any single LF or CR characters
    in the text are converted into the CRLF pair.
    The file is created if necessary. Returns number of characters
    written, or an error message.

fcopynew

    copies files if changed
    form: tofile fcopynew fromfiles
    returns: 0, size    not changed
             1, size    changed
             _1         failure

fcopynews

    copies files as strings if changed
    form: tofile fcopynews fromfiles
    returns: 0, size    not changed
             1, size    changed
             _1         failure

fdir

    file directory
    example:
      fdir jpath '~system\main\s*.ijs'

ferase

    erases a file
    Returns 1 if successful, otherwise _1

fexist

    test if a file exists
    Returns 1 if the file exists, otherwise 0.

fread

    read file
    y. is filename {;start size}
    x. is optional:
       = b    read as boxed vector
       = m    read as matrix
       = s    read as string (same as freads)

freadr

    read records from flat file
    y. is filename {;record start, # of records}
    records are assumed of fixed length delimited by
    one (only) of CR, LF, or CRLF.
    the result is a matrix of records.

freads

    read file as string
    y. is filename {;start size}
    x. is optional (b and m same as fread):
       = b    read as boxed vector
       = m    read as matrix
    freads

freplace

    replace text in file
    form: dat freplace file;pos

fselect

    file selection dialog
    y. = DOS filespec or ''
    x. = optional file type list
    returns user selection

fsize

    return file size
    returns file size or _1 if error

fss

    file string search
    form: str fss file
    search file for string, returning indices

fssrplc

    file string search and replace
    form: (old;new) fssrplc file

fview

    view file
    uses standard Windows edit control,
    which is limited to around 20K size.

>> << Ndx Usr Pri Phr Dic Rel Voc !: wd Help User