  read
  Builtin Function



      SSyynnooppssiiss
        Read data from a file.

      SSyynnttaaxx
        read ( _F_I_L_E_N_A_M_E )

        read ( _F_I_L_E_N_A_M_E, _L_I_S_T )

      DDeessccrriippttiioonn
        read reads the file identified by the _F_I_L_E_N_A_M_E. The file is
        opened with read access, and all of the contents are read.  The
        file identified by the 1st argument must contain data that is in
        RLaB binary format.  The entities in the file are installed in
        the global symbol table, overwriting any existing entities. Upon
        completion the file is closed.

        Example:



          read ("bunch_of_data_in_a_file");





     The second form of the read function allows the data in the file to
     be read into list variable _L_I_S_T. The global-symbol-table is
     untouched (except for _L_I_S_T).

     Example:



          read ("bunch_of_data", X);





     The contents of the file bunch_of_data are read and stored in the
     list variable X. Except for the creation/modification of the
     variable X, the global-symbol-table is unchanged.

     Read will read most numeric matrices written by MATLAB's save
     command. Read will not read MATLAB text matrices, or sparse
     matrices, or matrices written with reduced precision (integer
     format). Read will not read Cray, or VAX binaries. Read will read
     big and little endian binaries - this includes binaries written
     from PCs, DEC Risc, Macintosh, Sun, and Apollo.


     SSeeee AAllssoo
        FILES, close, getline, read, readm, writem







