CLion 2018.2 Help

Viewing Usages of a Symbol

Using the Show Usages function, you can bring up a list of the usages of a symbol across the whole project. So doing, the pop-up window with the list of usages of a symbol features a toolbar with the following buttons:

Icon

Tooltip

Description

icons actions groupByTestProduction svg

Group by test/production

If this button is pressed, the found usages are divided in two categories, Production and Test. This is useful, for example, if you want to exclude the usages found in test files from the overall results.

icons actions GroupByModule svg

Group by module

If this button is pressed, the found usages show under the corresponding module or library node. Use the icons objectBrowser flattenModules svgFlatten modules button view all modules on the same level.

icons actions GroupByPackage svg

Group by directory

If this button is pressed, all the usages found are displayed under their respective directories.

groupByFileStructure

Group by file structure

If this toggle is on, the found usages are shown under the corresponding function nodes.

mergeUsages

Merge usages from the same line

Merge usages of the symbol from the same line.

icons actions showReadAccess svg

Show read access

Show read access to the symbol.

icons actions showWriteAccess svg

Show write access

Show write access to the symbol.

icons actions previewDetails svg

Preview usages

Turns showing the Preview pane on or off.

icons objectBrowser sorted svg

Sort members alphabetically

Click this button to have members sorted alphabetically. Otherwise, members are sorted in the order they are declared.

To view the usages of a symbol across the project

  1. Place the caret at the desired symbol in the editor.

  2. On the main menu, choose Edit | Find | Show Usages, or press Ctrl+Alt+F7.

  3. Examine and analyze the detected occurrences of a symbol:
    • Use the toolbar buttons to present search results in the desired way.

    • To jump from search results to a line of source code, click the desired entry.

    • To close the list, press Escape.

  4. If necessary, customize the search options in the search options dialog box. To invoke the dialog box, do one of the following:
    • In the Show Usages pop-up window, click icons general gearPlain svg.

    • Press Ctrl+Shift+Alt+F7.

Last modified: 27 November 2018

See Also