Debug Tool Window. Variables
In this topic:
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.
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 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.
|Alt+Insert||Click this button to create a new watch.|
|Alt+Delete||Click this button to remove the selected watch from the list.|
|Alt+UpAlt+Down||Use these buttons to change the order of watches.|
|Ctrl+D||Use this button to create a copy of the selected watch.|
|Show 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. |
|Inspect||N/A||This 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.|
|Mark Object||F11||Use this command to add an object label.|
|Set Value||F2||Use this command to change the runtime value of a field or a variable.|
|Copy Value||Ctrl+C||Use 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 Value As||N/A||This menu item is available only in the PHP context. |
Choose this command to copy the selected variable to the Clipboard in one of the following formats:
|Compare Value with Clipboard||N/A||Use this command to compare the selected value with the value currently in the Clipboard.|
|Copy Name||N/A||Use this command to copy the name of the selected variable to the Clipboard.|
|Evaluate Expression||Alt+F8||Use this command to evaluate the selected variable in the dialog that opens.|
|Add to Watches||N/A||This 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 Objects||N/A||Use this command to display a list of objects referring to the currently selected variable.|
|Jump to Source||F4||This 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 Source||Shift+F4||Use this command to navigate to the definition of the class of the selected variable or field.|
|View Text / View/Edit Text (for string values)||N/A||Use this command to display the text representation (if any) of the selected variable. |
Note that for the string values View Text turns into View/Edit Text. This makes it possible to change string values in a text area.
|View as||N/A||Use this command to select how you want variable values to be displayed. For numeric values, you can toggle between the decimal and hexadecimal formats. Objects are usually represented by their class name and instance identifier, but you can optionally show them in the string format. |
|Adjust Range||N/A||This command is available for arrays and lists and lets you view the contents of an array within the specified range of indices.|
|Show types||N/A||Select this option if you want to show variables' types.|
|Customize Data Views||N/A||Select this option to open the Customize Data Views dialog where you can configure how data is represented.|