PyCharm 2016.3 Help

Debug Tool Window. Variables

In this topic:

Overview

The Variables pane enables you to examine the values stored in the objects of your application.

When a stack frame is selected in the Frames pane, the Variables pane displays all data within its scope (method parameters, local and instance variables).

In this pane, you can set labels for objects, inspect objects, evaluate expressions, add variables to watches and more.

Toolbar

This toolbar appears only when the Watches pane is hidden so the configured watches are displayed in the Variables pane. Hiding/showing the Watches pane is controlled through the /help/img/idea/show-watches.png toggle button:

  • When the button is pressed, which is its default status, the Watches pane is hidden and the toolbar is shown in the Variables pane. So doing, the focus is with the Debugger tab.
  • When the button is released, the toolbar moves to the Watches pane.

ItemShortcutDescription
addAlt+InsertClick this button to create a new watch.
deleteAlt+DeleteClick this button to remove the selected watch from the list.
/help/img/idea/arrowUp.png/help/img/idea/arrowDown.pngAlt+UpAlt+DownUse these buttons to change the order of watches.
/help/img/idea/copy.gifCtrl+DUse this button to create a copy of the selected watch.
/help/img/idea/show-watches.pngShow watches in Variables tab Use this toggle button to have the Watches pane hidden or shown. By default, the button is pressed and displayed on the toolbar of the Variables pane. Consequently, the Watches pane is hidden and the watches are shown in the Variables pane.
  • To have the Watches pane displayed separately and view the configured watches in it, release the Show watches in Variables tab toggle button. The Watches pane appears with the Show watches in Variables tab toggle button on the toolbar.
  • To hide the Watches pane and view the watches in the Variables pane, press the /help/img/idea/show-watches.png toggle-button on the toolbar of the Watches pane. The toggle button returns to the default location on the toolbar of the Variables pane.

Context menu

ItemShortcutDescription
InspectN/AThis command is available for fields, local variables and reference expressions, and opens a non-modal Inspection window, where you can concentrate on a particular reference. You can open as many Inspection windows as required. The view in the Inspection window is the same as in the Watches pane, but requires less screen space.
Set ValueF2Use this command to change the runtime value of a field or a variable.
Copy ValueCtrl+CUse this command to copy the value of the selected variable to the Clipboard. If multiple items are selected, not only variables' values, but also their structure is copied, so that when you copy-paste the selection to a text file, the indentation mimics the tree output of the debugger to produce an easy-to-read output.

Alternatively, hover your mouse cursor over a value and view its contents in the tooltip.

Copy JSONThis menu item is available only in the JavaScript context. Choose this command to copy the selected value in the JSON format.
Compare Value with ClipboardN/AUse this command to compare the selected value with the value currently in the Clipboard.
Copy NameN/AUse this command to copy the name of the selected variable to the Clipboard.
/help/img/idea/evaluateExpressionIcon.pngEvaluate ExpressionAlt+F8Use this command to evaluate the selected variable in the dialog that opens.
/help/img/idea/watches-add.pngAdd to WatchesN/AThis command is available for all nodes except static ones. Use this command to create an expression that references the node and add this expression to the Watches pane.
Show Referring ObjectsN/AUse this command to display a list of objects referring to the currently selected variable.
Jump to SourceF4This command opens the source code of the selected variable or field in the editor and places the caret in the corresponding line.
Jump to Type SourceShift+F4Use this command to open the source code of the selected variable or field type in the editor.
View as DataFrameThis command is available for variables that represent NumPy arrays.
/help/img/idea/py_view_as_array.png

Note that NumPy must be downloaded and installed in your Python interpreter.

With this package installed, you can get a graphical view of a NumPy array and its parts using slicing, formatting and coloring tools:

/help/img/idea/py_view_as_array1.png

This command supports pandas dataframes as well.

Variable types

The icon on the left of each variable indicates its type:
  • 1_debuggerStatic.png: static
  • /help/img/idea/global_variable.png: global
  • 1_debuggerField.png: field
  • 1_debuggerArray.png: array
  • 1_debuggerPrimitive.png: primitive
  • 1_debuggerObject.png: object

See Also

Last modified: 23 November 2016