gives a list of lines in the file that contain the specified string.


gives a list of all lines that contain any of the specified strings.


gives a list of lines containing the specified strings in any of the filei.


includes only the first n lines found.

Details and Options

  • FindList returns {} if it fails to find any record which contains the specified text.
  • The following options can be given:
  • AnchoredSearchFalsewhether to require that the text searched for be at the beginning of a record
    IgnoreCaseFalsewhether to treat lowercase and uppercase as equivalent
    RecordSeparators{"\r\n", "\n","\r"}separators for records
    WordSearchFalsewhether to require that the text searched for appear as a word
    WordSeparators{" ","t"}separators for words
  • The first argument to FindList can be InputStream["name",n], or simply "name" if there is only one open input stream with the specified name.
  • If FindList opens a file or pipe, it closes it again when it has finished.
  • FindList[File["file"],] is also supported.


open allclose all

Basic Examples  (2)

Get a list of lines in a file that contains "electors":

The first two lines that contain "electors":

Scope  (1)

Get a list of lines in the file specified by the File object:

Introduced in 1991
Updated in 2016