Using Custom Output Parsers

Custom output parsers scan command-line output for error and warning patterns that you specify and create entries for found patterns in Issues.

To view or add custom output parsers, select Preferences > Build & Run > Custom Output Parsers.

To edit the settings of a custom output parser, select it in the list, and then select Edit.

To remove the selected parser, select Remove.

You can activate custom output parsers in the Custom Output Parsers section of the Build and Run settings, as well as in the custom compiler settings.

Specifying Settings for Custom Output Parsers

"Custom Output Parsers preferences"

A custom output parser enables you to capture errors and warnings separately, according to the settings you specify in the Error and Warning tab.

To create a custom output parser:

  1. Select Preferences > Build & Run > Custom Output Parsers > Add.
  2. In the Error message capture pattern field, specify a regular expression to define what is an error. The custom parser matches the compile output line by line against the regular expression and displays errors in Issues. Create regular expression groups that contain the file name, line number and error message.
  3. In the Capture Positions field, map the regular expression groups to File name, Line number, and Message.
  4. In the Capture Output Channels field, specify whether messages from standard output, standard error, or both channels should be captured.
  5. In the Test group, you can test how the message that you enter in the Error message field is matched when using the current settings.
  6. Select OK to add the parser to the list of parsers and return to the Custom Output Parsers tab.
  7. Double-click the parser name to change it to something more descriptive than the default value.

Activating Custom Output Parsers

To activate a custom output parser in the Build or Run settings of a project:

  1. In the Custom Output Parsers section, select Details.
  2. Select custom parsers to activate them for building or running the project.

Select Parse standard output during build to make output parsers look for diagnostics on stdout in addition to stderr.

© 2024 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.