Navigation and Search in C++

JetBrains Rider can bring you to any code item or file in a few keystrokes. The scope of the navigation includes symbols and files in your entire solution as well as all symbols and files in standard and libraries and external dependencies.

Use this command to navigate to the declaration of a symbol from any symbol usage. You can invoke this command from the Solution Explorer, Structure window, and other tool windows.

To navigate in the opposite direction (symbol usages) you can use the Go to Usages of Symbol command.

To go to symbol declaration, press F12, choose Navigate | Go to Declaration or Usages in the main menu, or click the symbol holding down the Ctrl key.

Go to declaration works on non-dependent decltype specifiers and lambdas (jumping to the lambda body). You can jump from a declaration to a definition with unmatched signature (for example, from a changed declaration of a member function to its definition with old signature), and also vice-versa. Go to declaration also works during the initial project indexing.

Go to declaration also works on unresolved identifiers, in comments and macro bodies. JetBrains Rider will find all symbols with the matching name and let you navigate to them.

In unsupported C++ files (for example, C++/CX) Go to declaration automatically falls back to the corresponding Visual Studio navigation action.

Use this command to quickly navigate to a particular class, function, or field in the current document.

To navigate to a file member, Press Alt0\ or choose Navigate | File Member from the main menu.

While the Go to Declaration command navigates you to the place where a symbol is declared, the Type Declaration command navigates to the declaration of the type of the currently selected symbol. For example, if you have a variable Foo myVar = new Foo(); and invoke this command on a usage of myVar, it will bring you to the declaration of the class Foo. If you invoke this command on a function, it navigates to the function's return type.

This command also works for typedefs. You can invoke this command from the Solution Explorer, Structure window, and other tool windows.

To navigate to the type of the symbol, Press CtrlShiftF11 or choose Navigate | Go to Type Declaration from the main menu.

This command allows you to quickly navigate to a specific usage of a symbol from its declaration or any other usage. You can invoke this command from the Solution Explorer, Structure window, and other tool windows. The opposite navigation is available with the Go to Declaration command.

The list of usages that you get with this command is the same as that of Find Usages. But this command is more convenient for symbols with a limited number of usages, in cases when you are looking for a specific usage and want to get to this usage without opening the Find window.

tip

If you invoke this command and see that usage search takes too long, you can click Open in Find Tool Window , press Shift+Enter or + on the numeric keypad — the search will continue on the background in the Find window.

To go to usages of symbol, Press AltShiftF12 or choose Edit | Find Usages | Show Usages from the main menu.

This command allows you to navigate up the inheritance hierarchy to a base type or method of the current symbol. You can invoke this command from the Solution Explorer, Structure window, and other tool windows.

Navigation in the opposite direction is available with the Go to Derived Symbols and Go to Implementation commands.

To navigate to base symbols, Press AltHome or choose Navigate | Base Symbols from the main menu.

For types that inherit from other types or implement interfaces and for members that override, implement, or hide members from base types, JetBrains Rider displays special gutter icons (for example, ). Hover over the icon to see the base symbols and to navigate up the inheritance hierarchy.

This command helps you find actual implementations of types and members — in other words, to locate the source code they execute. For example, from a base type or member, you can jump to any of its end implementations bypassing intermediate steps in the inheritance chain; from a usage of an interface member, you can get to all places where the member is implemented.

tip

If you have a complex inheritance hierarchy, you can visually explore type hierarchy in a tree view.

You can invoke this command from the Solution Explorer, Structure window, and other tool windows. If necessary, you can navigate in the opposite direction with the Go to Base Symbols command.

To navigate to implementations, Press CtrlF12 or choose Navigate | Implementation(s) from the main menu.

This command gets the list of all derived symbols for a type or a member and lets you navigate directly to one of them, down the inheritance hierarchy. If you are looking for actual implementations and not interested in intermediate steps of the inheritance chain, use Go to Implementation.

To navigate to derived symbols, Press AltEnd or choose Navigate | Go to Implementation(s) from the main menu.

For all symbols that have separate declarations and definitions, JetBrains Rider displays the Navigate to declaration/definition action indicator on the left. You can click this indicator or press AltEnter to quickly switch between declaration and definition of the symbol.

tip

You can hide the Navigate to declaration/definition action indicator on the Languages & Frameworks | C++ | Inspections page of JetBrains Rider options.

There are more ways to switch between a header and the corresponding source file and vice versa:

• Press Alt+O.

• Press Alt0` or choose Navigate | Navigate To… from the main menu, and then select Switch Header/Source in the Navigate To popup.

• Ctrl - click the symbol name.

If a class or function template has multiple specializations, JetBrains Rider allows you to switch between the primary template/specializations.

When you caret is at the primary template or at one of the specializations, there are two ways of navigating between specializations:

• Press AltEnter and choose Navigate to specializations in the action list.

• Press Alt0` or choose Navigate | Navigate To… from the main menu, and then select Specializations in the Navigate To popup.

In either way, a popup with all specializations appears where you can choose the desired one:

This command allows finding all usages of one or more symbols in the solution and referenced assemblies. You can start the search from the declaration of the symbol or from any other usage. You can invoke this command from the Solution Explorer, Structure window, and other tool windows.

If there are more than one usage, JetBrains Rider helps you analyze the results in the Find window.

To find usages of the current symbol, Press ShiftF12 or choose Edit | Find Usages | Find Usages from the main menu.

The editor automatically highlights usages of a symbol at caret, which is very convenient in short files and for locals in small contexts. However, this kind of highlighting does not always work well in larger contexts because the selection is only there as long as the caret stays at the symbol.

tip

To disable automatic highlighting, clear the Highlight usages of the element under cursor checkbox on the Editor | Inspection Settings page of JetBrains Rider settings CtrlAlt0S.

There is also a caret-independent highlighting that stays until you press Esc and applies different configurable colors to read and write access usages. You can toggle this highlighting for a single item or for several different items simultaneously, and then use shortcuts to jump between the highlightings.

To find usages of the current symbol and related entities, Press or choose Edit | Find Usages | Highlight Usages in File from the main menu.

When your caret is anywhere in the body of a type or a function, you can jump to the declaration of that type or function with a single shortcut.

To go to the containing declaration, press Ctrl0[.

With the Next/Previous Method commands, you can quickly navigate between neighboring members and nested types in code files or between neighboring tags in markup files.

To invoke these commands, press / or choose Navigate | Next/Previous Member in the main menu.

This handy navigation feature lets you expand the tree in the Solution Explorer, auto-scroll and highlight the item corresponding to the current document. It is especially useful when you have a massive solution, or a limited screen area that forces you to shrink the Solution Explorer window to the limit.

note

Note that this command will not work if the file that is opened in the editor is not included in the current solution.

To go to related files, press AltShift0L.

JetBrains Rider keeps track of your actions and navigation history, and offers some commands that let you navigate to places where you have edited or just studied the code.

• Go to Recent Files

• Go to Recent Edits

• Go to Previous Edit CtrlShiftBackspace

• Navigate Back/Forward

With JetBrains Rider, you can navigate the structure of the current document using the Structure window, which greatly simplifies navigation in large files. The window is synchronized with the editor: as you switch to another editor tab, the window displays the structure of the corresponding file.

To open the Structure window, press CtrlAlt0T or choose View | Tools Windows | Structure.

JetBrains Rider helps you quickly find and apply any of its actions, without digging through the menu. By an action, we mean an executable command available for the current caret position or any global command, for example, a command that opens a tool window.

You can also search for and navigate to JetBrains Rider preferences by name, and even change preferences with boolean values right in the popup menu.

To find and execute a JetBrains Rider action, Press Ctrl0Q or choose Help | Find Action... from the main menu.

If you want to return to some place in your code later, you can mark any code line in your solution or in library code with a bookmark.

There are two kinds of bookmarks that you can use:

• Bookmarks with mnemonics — are most useful for marking code lines that you often refer to, like top 10 places in your current solution. You can have up to 10 numbered bookmarks simultaneously. They are indicated by the following icons on the left editor gutter:

  Use dedicated shortcuts for this kind of bookmarks: Ctrl+Shift+[digit] toggles the bookmark with this digit; Ctrl+[digit] navigates to the bookmark with this digit.

• Anonymous bookmarks— are allowed in unlimited numbers so you can mark any line, which you think is worth returning to at some time in the future. They are indicated by the following icon on the left editor gutter:

  You can toggle bookmarks of this kind and navigate them from the bookmarks popup.

  tip

  If the code that you are going to mark contains some unfinished functionality, consider adding a TODO comment for that code instead of a bookmark.

For more information, refer to Bookmarks

JetBrains Rider provides an easy way to track tasks and technical debt in your code — code items (comments, string literals, or identifiers) matching a specific pattern can be easily located in the editor as well as in the whole solution using the TODO window.

For more information, refer to TODO lists