Find

Find[stream,"text"]

finds the first line in an input stream that contains the specified string.

Find[stream,{"text1","text2",}]

finds the first line that contains any of the specified strings.

Details and Options

  • Find breaks the input stream into records, delimited by record separators, and scans each record for the strings you specify.
  • Find returns as a string the first record which contains the specified text.
  • If Find does not find any record which contains the specified text before it reaches the end of the file, it returns EndOfFile.
  • 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 letters 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 Find can be InputStream["name",n], or simply "name" if there is only one open input stream with the specified name.
  • You can open a file or pipe to get an InputStream object using OpenRead.
  • Find does not close streams after it finishes reading from them.

Examples

Basic Examples  (2)

Open a stream:

Get the first line that contains "electors":

Find the next line that contains "electors":

Open a stream:

Find the first line that contains "electors" or "people":

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

Text

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

CMS

Wolfram Language. 1991. "Find." Wolfram Language & System Documentation Center. Wolfram Research. https://reference.wolfram.com/language/ref/Find.html.

APA

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

BibTeX

@misc{reference.wolfram_2023_find, author="Wolfram Research", title="{Find}", year="1991", howpublished="\url{https://reference.wolfram.com/language/ref/Find.html}", note=[Accessed: 18-March-2024 ]}

BibLaTeX

@online{reference.wolfram_2023_find, organization={Wolfram Research}, title={Find}, year={1991}, url={https://reference.wolfram.com/language/ref/Find.html}, note=[Accessed: 18-March-2024 ]}