WOLFRAM

Wolfram Language & System Documentation Center
Wolfram Language Home Page »

FindList
✖
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)Summary of the most common use cases

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

In[1]:=1
✖
https://wolfram.com/xid/0wggmnu-gbtqn6
Out[1]=1

The first two lines that contain "electors":

In[1]:=1
✖
https://wolfram.com/xid/0wggmnu-6rl1jq
Out[1]=1

Scope  (1)Survey of the scope of standard use cases

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

In[1]:=1
✖
https://wolfram.com/xid/0wggmnu-bzvdwh
Out[1]=1
Wolfram Research (1991), FindList, Wolfram Language function, https://reference.wolfram.com/language/ref/FindList.html (updated 2016).
✖
Wolfram Research (1991), FindList, Wolfram Language function, https://reference.wolfram.com/language/ref/FindList.html (updated 2016).

Text

Wolfram Research (1991), FindList, Wolfram Language function, https://reference.wolfram.com/language/ref/FindList.html (updated 2016).

✖
Wolfram Research (1991), FindList, Wolfram Language function, https://reference.wolfram.com/language/ref/FindList.html (updated 2016).

CMS

Wolfram Language. 1991. "FindList." Wolfram Language & System Documentation Center. Wolfram Research. Last Modified 2016. https://reference.wolfram.com/language/ref/FindList.html.

✖
Wolfram Language. 1991. "FindList." Wolfram Language & System Documentation Center. Wolfram Research. Last Modified 2016. https://reference.wolfram.com/language/ref/FindList.html.

APA

Wolfram Language. (1991). FindList. Wolfram Language & System Documentation Center. Retrieved from https://reference.wolfram.com/language/ref/FindList.html

✖
Wolfram Language. (1991). FindList. Wolfram Language & System Documentation Center. Retrieved from https://reference.wolfram.com/language/ref/FindList.html

BibTeX

@misc{reference.wolfram_2025_findlist, author="Wolfram Research", title="{FindList}", year="2016", howpublished="\url{https://reference.wolfram.com/language/ref/FindList.html}", note=[Accessed: 26-March-2025 ]}

✖
@misc{reference.wolfram_2025_findlist, author="Wolfram Research", title="{FindList}", year="2016", howpublished="\url{https://reference.wolfram.com/language/ref/FindList.html}", note=[Accessed: 26-March-2025 ]}

BibLaTeX

@online{reference.wolfram_2025_findlist, organization={Wolfram Research}, title={FindList}, year={2016}, url={https://reference.wolfram.com/language/ref/FindList.html}, note=[Accessed: 26-March-2025 ]}

✖
@online{reference.wolfram_2025_findlist, organization={Wolfram Research}, title={FindList}, year={2016}, url={https://reference.wolfram.com/language/ref/FindList.html}, note=[Accessed: 26-March-2025 ]}