ReadList ["file"]
reads all the remaining expressions in a file and returns a list of them.
ReadList ["file",type]
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 ["file",{type1,type2,…}]
reads objects with a sequence of types, until the end of the file is reached.
ReadList ["file",types,n]
reads only the first n objects of the specified types.
ReadList
ReadList ["file"]
reads all the remaining expressions in a file and returns a list of them.
ReadList ["file",type]
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 ["file",{type1,type2,…}]
reads objects with a sequence of types, until the end of the file is reached.
ReadList ["file",types,n]
reads only the first n objects of the specified types.
Details and Options
- Possible types to read are:
-
Byte single byte, returned as an integer codeCharacter single character, returned as a one‐character stringExpression complete Wolfram Language expressionRecord sequence of characters delimited by record separatorsString string terminated by a newlineWord sequence 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 Wolfram Language format. A form like 2.e5 or 2E5 as well as 2*^5 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:
-
- 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 ["file",{type1,…}] looks for the sequence of typei in order. If the end of file is reached while partway through the sequence of typei, EndOfFile is returned in place of the elements in the sequence that have not yet been read.
- ReadList [stream] reads from an open input stream, as returned by OpenRead .
- ReadList works with cloud objects.
- File ["file"] may be used to specify a file name.
Examples
open all close allBasic Examples (2)
Read in each line as a separate expression:
Read each line as a string:
Scope (2)
Read an expression from the file specified by the File object:
Open a stream:
Read three numbers from the stream:
Read two words from the stream:
These are strings:
Read all remaining data in the stream as expressions:
Any further attempt to read from the stream will return an empty list:
Close the stream:
Possible Issues (1)
Some streams, like those created by StringToStream , give values greater than 255 for the Byte type:
These correspond to the individual character codes:
Close the stream:
Tech Notes
Related Guides
History
Introduced in 1988 (1.0) | Updated in 2016 (11.0)
Text
Wolfram Research (1988), ReadList, Wolfram Language function, https://reference.wolfram.com/language/ref/ReadList.html (updated 2016).
CMS
Wolfram Language. 1988. "ReadList." Wolfram Language & System Documentation Center. Wolfram Research. Last Modified 2016. https://reference.wolfram.com/language/ref/ReadList.html.
APA
Wolfram Language. (1988). ReadList. Wolfram Language & System Documentation Center. Retrieved from https://reference.wolfram.com/language/ref/ReadList.html
BibTeX
@misc{reference.wolfram_2025_readlist, author="Wolfram Research", title="{ReadList}", year="2016", howpublished="\url{https://reference.wolfram.com/language/ref/ReadList.html}", note=[Accessed: 04-January-2026]}
BibLaTeX
@online{reference.wolfram_2025_readlist, organization={Wolfram Research}, title={ReadList}, year={2016}, url={https://reference.wolfram.com/language/ref/ReadList.html}, note=[Accessed: 04-January-2026]}