NotebookFind

NotebookFind[obj,data]

sets the current selection in the specified notebook object to be the next occurrence of data.

NotebookFind[obj,data,Previous]

sets the current selection to be the previous occurrence.

NotebookFind[obj,data,All]

sets the current selection to be all occurrences.

NotebookFind[obj,data,dir,elems]

sets the current selection to be the occurrence in the direction dir and searches the elements of cells specified by elems.

Details and Options

  • NotebookFind returns $Failed if the search it performs finds no occurrence of data.
  • obj may be a NotebookObject or a CellObject. If obj is a NotebookObject, then the find operation starts where the selection is in the notebook.
  • data can be a string, box expression, or a complete cell.
  • Possible values of dir include Next, Previous, and All.
  • The possible elements are:
  • CellContentscontents of each cell, represented as a string
    CellIDsetting for the CellID option of each cell
    CellLabelsetting for the CellLabel option of each cell
    CellStylename of style for each cell
    CellTagsparts of the setting for the CellTags option for each cell
    {elem1,elem2,}list of different types of elements
  • The default for elems is CellContents. Only the contents of boxes, not their styles or options, are included in the search.
  • The following options can be given:
  • AutoScroll Truewhether to scroll the notebook to the found result automatically
    IgnoreCase Falsewhether to treat lowercase and uppercase letters as equivalent
    WordSearchFalsewhether to require that the text searched for appear as a word
    WrapAroundFalseif no result is found in the given direction, whether to wrap around and keep searching
  • The front end will highlight the region corresponding to the result.

Examples

open allclose all

Basic Examples  (1)

Create a notebook:

Find an occurrence of the letters "at":

Scope  (2)

Create a notebook:

Find an occurrence of the letters "at":

Find the next occurrence:

Select all cells that contain "at":

Find the last "at" in the document:

Go back to find a cell with "L1" in its cell tags:

Find all Input-styled cells in this notebook:

Options  (2)

AutoScroll  (1)

Normally, the document scrolls so that the found data is visible in the notebook window:

With AutoScroll set to False, the document does not scroll to the found data:

IgnoreCase  (1)

By default, searches are case sensitive:

A case-insensitive search:

Wolfram Research (1996), NotebookFind, Wolfram Language function, https://reference.wolfram.com/language/ref/NotebookFind.html (updated 2014).

Text

Wolfram Research (1996), NotebookFind, Wolfram Language function, https://reference.wolfram.com/language/ref/NotebookFind.html (updated 2014).

CMS

Wolfram Language. 1996. "NotebookFind." Wolfram Language & System Documentation Center. Wolfram Research. Last Modified 2014. https://reference.wolfram.com/language/ref/NotebookFind.html.

APA

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

BibTeX

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

BibLaTeX

@online{reference.wolfram_2023_notebookfind, organization={Wolfram Research}, title={NotebookFind}, year={2014}, url={https://reference.wolfram.com/language/ref/NotebookFind.html}, note=[Accessed: 19-March-2024 ]}