1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
|
// Copyright (C) 2022 The Qt Company Ltd.
// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR GFDL-1.3-no-invariants-only
/*!
\previouspage creator-project-settings-environment.html
\page creator-custom-output-parsers.html
\nextpage creator-sharing-project-settings.html
\title 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 \l Issues.
To view or add custom output parsers, select
\uicontrol Edit > \uicontrol Preferences >
\uicontrol {Build & Run} > \uicontrol {Custom Output Parsers}.
\image qtcreator-custom-parser-list.png
To edit the settings of a custom output parser, select it in the list, and
then select \uicontrol Edit.
To remove the selected parser, select \uicontrol Remove.
You can activate custom output parsers in the
\uicontrol {Custom Output Parsers} section of
the \uicontrol Build and \uicontrol Run settings,
as well as in the \l{Adding Custom Compilers}
{custom compiler settings}.
\section1 Specifying Settings for Custom Output Parsers
\image qtcreator-custom-parser-options.png "Custom Output Parsers preferences"
A custom output parser enables you to capture errors and
warnings separately, according to the settings you specify
in the \uicontrol Error and \uicontrol Warning tab.
To create a custom output parser:
\list 1
\li Select \uicontrol Edit > \uicontrol Preferences >
\uicontrol {Build & Run} > \uicontrol {Custom Output Parsers}
> \uicontrol Add.
\li In the \uicontrol {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 \l Issues. Create
regular expression groups that contain the file name, line number
and error message.
\li In the \uicontrol {Capture Positions} field, map the regular
expression groups to \uicontrol {File name}, \uicontrol {Line number},
and \uicontrol Message.
\li In the \uicontrol {Capture Output Channels} field, specify whether
messages from standard output, standard error, or both channels
should be captured.
\li In the \uicontrol {Test} group, you can test how the message that
you enter in the \uicontrol {Error message} field is matched when
using the current settings.
\li Select \uicontrol OK to add the parser to the list of parsers
and return to the \uicontrol {Custom Output Parsers} tab.
\li Double-click the parser name to change it to something more
descriptive than the default value.
\endlist
\section1 Activating Custom Output Parsers
\image qtcreator-custom-parser.png
To activate a custom output parser in the \uicontrol Build or
\uicontrol Run settings of a project:
\list 1
\li In the \uicontrol {Custom Output Parsers} section, select
\uicontrol Details.
\li Select custom parsers to activate them for building or running
the project.
\endlist
Select \uicontrol {Parse standard output during build} to make output
parsers look for diagnostics on \c stdout in addition to \c stderr.
*/
|