This is documentation for Mathematica 8, which was
based on an earlier version of the Wolfram Language.
View current documentation (Version 11.1)

ReadList

ReadList
reads all the remaining expressions in a file and returns a list of them.
ReadList
reads objects of the specified type from a file, until the end of the file is reached. The list of objects read is returned.
ReadList
reads objects with a sequence of types, until the end of the file is reached.
ReadList
reads only the first n objects of the specified types.
  • Possible types to read are:
Bytesingle byte, returned as an integer code
Charactersingle character, returned as a one-character string
Expressioncomplete Mathematica expression
Numberinteger or an approximate number, given in "E" format
Realapproximate number, given in "E" format
Recordsequence of characters delimited by record separators
Stringstring terminated by a newline
Wordsequence of characters delimited by word separators
  • Objects of type Real can be given in the scientific notation format used by languages such as C and Fortran, as well as in standard Mathematica format. A form like or as well as can be used to represent the number . Objects read as type Real are always returned as approximate numbers. Objects read as type Number are returned as integers if they contain no explicit decimal points.
  • The following options can be given:
NullRecordsFalsewhether to assume a null record between repeated record separators
NullWordsFalsewhether to assume a null word between repeated word separators
RecordSeparators{"\r\n","\n","\r"}separators allowed between records
RecordListsFalsecreate separate sublists for each record
TokenWords{}words taken as delimiters
WordSeparators{" ","\t"}separators allowed between words
  • If file is not already open for reading, ReadList opens it, then closes it when it is finished. If the file is already open, ReadList does not close it at the end.
  • ReadList prints a message if any of the objects remaining in the file are not of the specified types.
  • ReadList looks for the sequence of in order. If the end of file is reached while part way through the sequence of , EndOfFile is returned in place of the elements in the sequence that have not yet been read.
Read in each line as a separate expression:
Read each line as a string:
Read in each line as a separate expression:
In[1]:=
Click for copyable input
Out[1]=
 
Read each line as a string:
In[1]:=
Click for copyable input
Out[1]=
In[2]:=
Click for copyable input
Out[2]//InputForm=
New in 1 | Last modified in 2