Examine suspended program

• To copy the call stack for the current thread, right-click anywhere on the Frames tab and select Copy Stack.

The preview tab allows you to open files successively in one tab. This way you avoid cluttering the editor with multiple open files in separate tabs.

• To enable the preview mode for files that are opened during debugging, open settings by pressing CtrlAlt0S, navigate to Editor | General | Editor Tabs and select the Enable preview tab checkbox.

• If object types take up too much space in the Debug tool window, right-click a variable and clear the Show Types option in the list that appears.

  

• During the debugging session, click More and navigate to Dump Goroutines.

  A dump of available goroutines and their stacks opens in a separate tab.

  

• Click the Filter icon (). In the Filter field, type a string that you want to search for.

  

• Right-click a goroutine that you want to exclude from the list and select Hide goroutine. To hide all the goroutines that have the same stack as the selected goroutine, select Hide goroutines with the same stack from the context menu.

  You can view hidden goroutines under the Hidden list.

  To reset the state of the list and make all the hidden goroutines in the visible list again, click the Reset Hidden Goroutines button ().

  

1. Click the Export to Text File icon ().

2. In the Export to file field, select a storage path and click Save.

When examining variables, you may need to copy a variable name or value to paste it somewhere else or compare it with another variable.

• To copy the name of a variable, right-click the variable and select Copy Name.

• To copy the value that a variable holds, right-click the variable and select Copy Value Ctrl0C.

To compare a variable value with some other value, use the Compare Value with Clipboard option. This is helpful, for example, when a variable holds a long string, and you need to compare it with another long string.

1. Copy the content you want to compare, for example, from a text file.

2. In the Variables tab, right-click a variable and select Compare Value with Clipboard.

3. Examine the differences in the Diff Viewer that opens. For more information about Diff Viewer, refer to Comparing Files and Folders.

   

GoLand allows you to inspect variables in a dedicated dialog. This is useful when you need to keep track of some variable (or the object whose reference it holds) and at the same time be able to navigate between frames and goroutines.

• Right-click a variable or a watch and select Inspect.

  

If you want to test how the program would behave with certain data or change its flow at runtime, you can achieve that by changing the variable values.

1. Select a variable and press F2. Alternatively, select Set Value from the context menu.

2. Enter the value for the variable and press Enter.

note

Due to a GDB/LLDB limitation, you cannot set value for std::string variables.

You can navigate to declarations from the Variables pane.

• To navigate to the code where the variable is declared, right-click the variable and select Jump to Source F4.

  

• To navigate to the type declaration of the variable type, right-click the variable and select Jump to Type Source ShiftF4.

  

If you want the result of some expression to appear on a particular line, you can set up an inline watch for that. Inline watches are persistent and remain active after session restart.

1. Click the inline hint referring to the object whose field you want to track.

2. In the popup, select the field and click Add as Inline Watch.

3. Fine-tune the watch if needed. You can use any valid expression as a watch.

To remove an inline watch, hover over the watch and click the cross near it.

1. Click New Watch on the Variables tab.

2. Enter the variable or expression to be evaluated. In expressions, you can evaluate method calls, function literals declare variables, and so on, as long as this is in the local context.

   

tip

If the variable or expression that you want to track is already in front of you (for example, in the code editor), you can select and drag it to the Variables pane. For variables in the current context, you can also right-click them in the Variables pane and select Add to Watches from the context menu.

After you have added a variable/expression to Watches, it stays there and is evaluated for each step, providing you with the result in the current context.

• Right-click the desired watch and select Edit.

1. Select the watch you want to copy.

2. Click Duplicate Watch on the Variables/Watches tab or press Ctrl0D.

For convenience, you can change the order in which the watches appear on the Variables/Watches pane.

• Use the Move Watch Up/Move Watch Down buttons on the Variables/Watches pane or Ctrl0↑ and Ctrl0↓ keyboard shortcuts.

• To remove a single watch, right-click it and select Remove Watch. Alternatively, select the watch and press Delete on the Variables/Watches pane.

• To remove all watches, right-click anywhere on the Variables/Watches pane and select Remove All Watches.