`output'
--------

output(["FILENAME"])
     :: Writes the return values and prompt onto file FILENAME.

RETURN
     1

FILENAME
     filename

   * Standard output stream of Asir is redirected to the specified file.
     While Asir is writing its outputs onto a file, no outputs, except
     for keyboard inputs and some of error messages, are written onto
     the standard output. (You cannot see the result on the display.)

   * To direct the Asir outputs to the standard output, issue the
     command without argument, i.e., `output()'.

   * If the specified file already exists, new outputs will be added to
     the tail of the file. If not, a file is newly created and the
     outputs will be written onto the file.

   * When file name is specified without double quotes (`""'), or when
     protected file is specified, an error occurs and the system returns
     to the top level.

   * If you want to write inputs from the key board onto the file as
     well as Asir outputs, put command `ctrl("echo",1)', and then
     redirect the standard output to your desired file.

   * Contents which are written onto the standard error output, CPU
     time etc., are not written onto the file.

   * Reading and writing algebraic expressions which contain neither
     functional forms nor unknown coefficients (`vtype()' References)
     are performed more efficiently, with respect to both time and
     space, by `bload()' and  `bsave()'.

   * On Windows one has to use `/' as the separator of directory names.

     [83] output("afo");
     fctr(x^2-y^2);
     print("afo");
     output();
     1
     [87] quit;
     % cat afo
     1
     [84] [[1,1],[x+y,1],[x-y,1]]
     [85] afo
     0
     [86]

References
     *Note `ctrl': ctrl, *Note `bsave bload': bsave bload.

