The main window

This page describes the parts of the main window and every command in the menus and toolbars.

From top to bottom the main window has:

• the menu bar,
• the toolbars: the standard toolbar, the severity toolbar and the quick filter,
• the progress bar, which is shown while an analysis is running,
• the results list with all warnings,
• the lower panel with two tabs: Warning Details (the message and the source code of the selected warning) and Analysis Log.

The title bar shows the name of the project file that is open. You can drag the bar between the results list and the lower panel to give more space to either of them. The GUI remembers the window size, the column widths and the position of the bar.

The results list

The results are grouped by file. Each file is a top level item; click the arrow to expand it, or use View > Expand all. Each warning in a file can have child items called notes, which describe the path through the code that leads to the problem.

The columns are:

Click a column header to sort by that column. Drag the edge of a column header to change its width.

Double-click a warning, or select it and press Enter, to open the file in your default editor at the line of the warning. You must configure the editor first in the preferences.

Right-click warnings to get a context menu. See The context menu.

Warning Details and the code view

When you select a warning, the Warning Details tab shows the id, the CWE number and the full message. Some messages are longer than the summary in the list and explain the problem in more detail. If the file was included from another file, it also shows which file included it.

Below the message, the code view shows the source file with the line of the warning highlighted. Select a note to see the line of the note. The code view is read only; use your editor to change the code. The colors of the code view can be changed in the preferences.

Analysis Log

The Analysis Log tab shows which files were analyzed and with which configuration: the preprocessor defines, undefines, include paths and platform. Look here if the results are not what you expected, for example to check that the right include paths are used. Right-click the log to clear it or copy one or all entries.

If Show internal warnings in log is enabled in the preferences, internal debug warnings are shown here too.

If a critical error happens, for example a syntax error that stops the analysis of a file, a red message is shown above the results list.

Toolbars

The standard toolbar (left) has, from left to right: Open Project File, Save results to file, Reanalyze all files, Stop, Clear results, Preferences and About. These commands are described with the menus below.

The severity toolbar (right) has one toggle button for each severity: error, warning, style, portability, performance and information. When a button is pressed, warnings with that severity are shown. Release it to hide them. The last two buttons show or hide results from Cppcheck itself and results from Clang tools (Clang-Tidy). When you select a compliance report type, the buttons change to the classifications of that standard, for example Mandatory, Required and Advisory for Misra.

The quick filter field shows only warnings that contain the text you type. The text is searched (ignoring case) in the summary, the message, the id, the classification and the files and texts of the notes. Click the small cross in the field to clear the filter.

The toolbars can be turned on and off with View > Toolbars.

The File menu

The Edit menu

The View menu

The Analyze menu

The Help menu

Cppcheck Premium also shows EULA... in this menu.

Keyboard shortcuts

Previous: Getting started | Next: Analyzing without a project