|Non-Confidential||PDF version||ARM DUI0446Z|
|Home > DS-5 Debug Perspectives and Views > Variables view|
Use the Variables view to work with the contents of local, file static, and global variables in your program.
By default, the Variables view displays all the local variables. It also displays the file static and global variable folder nodes. You can add or remove variables by selecting one or more variables. Keep the set of variables in the view to a minimum to maintain good debug performance.
If you know the name of the specific variable you want
to view, enter the variable name in the Add
Variable field. This lists the variables that match the
text you entered. For example, enter the text ta to view variables with the text
ta in their name. Double-click the
variable to add it to the Variables view.
If you want to view all the available variables in your code, click Browse to display the Add Variable dialog. Expand the required folders and filenames to see the variables they contain. Then select one or more variables that you are interested in and click OK to add them to the Variables view. Ctrl+A selects all the variables that are visible in the dialog. Selecting a filename or folder does not automatically select its variables.
You can remove the variables, that you added, from the variables view. In the Variables view, select the variables you want to remove from the view, and click to remove the selected variables. If you want to reset the view to display the default variables again, then from the view menu, select Reset to default.
The following options are available from the toolbar or context menu:
Links this view to the selected connection in the Debug Control view. This is the default. Alternatively you can link the view to a different connection. If the connection you want is not shown in the drop-down list you might have to select it first in the Debug Control view.
Copies the selected variables. To copy the contents of an item such as a structure or an array, you must first expand that item.
This can be useful if you want to copy variables to a text editor in order to compare the values when execution stops at another location.
Selects all variables currently expanded in the view.
Where enabled, displays the Memory view with the address set to either:
The value of the selected variable, if the
variable translates to an address, for example the address of an
The location of the variable, for example the
name of an array,
The memory size is set to the size of the variable, using
If the selected variable is currently held in a register, displays the Registers view with that register selected.
If the selected variable is a pointer, displays the Memory view with the address set to the value of the variable.
Displays the MMU view and translates the address of the variable.
Enables you to add variable filters to an Expressions view. Displays a sub menu that enables you to specify an Expressions view.
A list of formats you can use for the variable value.
The following View Menu options are available:
Displays a new instance of the Variables view.
Enables the updating of the view when it is hidden behind other views. By default, this view does not update when hidden.
Resets the view to show only the default variables.
Toggles the freezing of data in the current view. You cannot modify the value of a variable if the data is frozen. This option also disables or enables the Refresh option.
If you freeze the data before you expand an
item for the first time, for example an array, the view
Unfreeze the data to expand the item.
The following options are available on the context menu when you select a variable value for editing:
Reverts the last change you made to the selected value.
Copies and deletes the selected value.
Copies the selected value.
Pastes a value that you have previously cut or copied into the selected variable value.
Deletes the selected value.
Right-click on the column headers to select the columns that you want to display:
The name of the variable.
Read-only values are displayed with a grey background. A value that you can edit is initially shown with a white background. A yellow background indicates that the value has changed. This might result from you either performing a debug action such as stepping or by you editing the value directly.