FindList

FindList["file","text"]

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

FindList["file",{"text1","text2",}]

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

FindList[{"file1",},]

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

FindList[files,text,n]

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.

Examples

open allclose all

Basic Examples  (2)

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

In[1]:=
Click for copyable input
Out[1]=

The first two lines that contain "electors":

In[1]:=
Click for copyable input
Out[1]=

Scope  (1)

See Also

Find  ReadList  NotebookFind  StringCases  TextSearch

Tutorials

Introduced in 1991
(2.0)
| Updated in 2016
(11.0)