NotebookRead

NotebookRead[notebook]

gives the expression corresponding to the current selection in the specified notebook object.

NotebookRead[obj]

gives the expression corresponding to the given cell or box object.

NotebookRead[{obj1,obj2,…}]

gives a list of expressions corresponding to the obji.

Details and Options

  • NotebookRead is the basic way to get into the kernel pieces of notebooks that are being manipulated by the front end.
  • NotebookRead can take a NotebookObject, CellObject, or BoxObject.
  • If a list of CellObject or BoxObject expressions is given, then a list of equal length will be returned, with the expressions corresponding to each object.
  • If an object is no longer valid, NotebookRead returns $Failed. If a list of objects is given, then $Failed will be returned for each of the invalid objects.
  • The following options can be given:
  • CellContext Nonecontext to substitute for $CellContext`
    StripCellGrouping Falsewhether to strip cell grouping when reading contiguously selected cells
  • When NotebookRead[notebook] reads a contiguous selection of cells, selected cell groups are returned as Cell[CellGroupData[…]] expressions by default. The option setting StripCellGroupingTrue will force selected cells to be returned as a flat list regardless of grouping.

Examples

open allclose all

Basic Examples  (3)

This creates a document notebook:

This selects the first cell:

This reads the cell and returns its Cell expression:

Read a CellObject:

Read a BoxObject:

Scope  (1)

Create a notebook and move the selection to the first "T":

Read the current selection:

Select multiple cells and read the content:

Select and read graphics:

Display the result:

Options  (2)

CellContext  (1)

Create a target cell with a raw expression in it:

Read the cell using NotebookRead:

Use CellContext to substitute a value for the $CellContext` context:

StripCellGrouping  (1)

Reading a group of cells includes CellGroupData constructs by default:

Use StripCellGrouping to remove the grouping information:

Applications  (1)

A palette that reads the word at the current selection and makes it uppercase:

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

Text

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

CMS

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

APA

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

BibTeX

@misc{reference.wolfram_2025_notebookread, author="Wolfram Research", title="{NotebookRead}", year="2024", howpublished="\url{https://reference.wolfram.com/language/ref/NotebookRead.html}", note=[Accessed: 06-May-2025 ]}

BibLaTeX

@online{reference.wolfram_2025_notebookread, organization={Wolfram Research}, title={NotebookRead}, year={2024}, url={https://reference.wolfram.com/language/ref/NotebookRead.html}, note=[Accessed: 06-May-2025 ]}