PreviousCell

PreviousCell[]

returns the CellObject corresponding to the cell directly above the currently evaluating cell.

PreviousCell[cellobj]

starts looking from the given cell.

PreviousCell[NotebookSelection[nbobj]]

starts looking from the topmost selected item.

Details and Options

  • The evaluation of PreviousCell will not result in the selection or insertion point's changing position.
  • If the requested cell is not available or the top of the notebook is reached, PreviousCell will return None.
  • PreviousCell can return the first cell before the reference point that matches given criteria by specifying one or more of the following options:
  • CellIDcell IDs to match
    CellLabelIn/Out label strings to match
    CellStylenamed cell styles to match
    CellTagscell tags to match
    Evaluatorcells that match the specified evaluator
    GeneratedCellmatch only generated output cells if True, or only non-generated cells if False
  • PreviousCell[cellobj] of an inline cell will return the previous inline cell in the same cell. PreviousCell[NotebookSelection[nbobj]] will always return the previous regular cell, regardless of whether an inline cell is presently selected.

Examples

Basic Examples  (3)

Get the CellObject for the previous cell:

Read this caption cell into the kernel:

There are no "Section" style cells above this point in this notebook:

Introduced in 2014
 (10.0)
 |
Updated in 2020
 (12.1)