#fopen()

DESCRIPTION
    open a file for reading, writing, or appending, returning TRUE if successful,
    ERR if unsuccessful

SYNOPSIS
    #fopen(F,s1,s2)

ARGUMENTS
     F - a filehandle (all caps)
    s1 - a string, or string expression, representing a file path
    s2 - any among the strings:  "r", "w", "a"

EXAMPLES

        begin
                if #fopen(MMUSERS, "=mmusers\.tmp", "w") == #err()
                        output mail "Unable to open =mmusers\.tmp for writing!"
                        quit
                endif

        begin   // read in list of authorized suid files for this system
                if #fopen(SUIDFILES, "=files_suid_obj", "r") != #err()
                        while #read(SUIDFILES) > 0
                                =incr(#suid[$rdlin])
                        endwhile
                        do #fclose(SUIDFILES)
                else
                        output mail "Can't open =files_suid_obj for reading!"
                        quit
                fi

SEE ALSO
    #fclose()
    #popen()
    #pclose()
    #read()
    #write()

    Numerical Functions
    String Functions