Наша сборка Qt VS Tools
giy
2022-06-13 175679ae608f0b295d761588d332f635b21bdf30
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
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
/****************************************************************************
**
** Copyright (C) 2019 The Qt Company Ltd.
** Contact: https://www.qt.io/licensing/
**
** This file is part of the Qt VS Tools.
**
** $QT_BEGIN_LICENSE:GPL-EXCEPT$
** Commercial License Usage
** Licensees holding valid commercial Qt licenses may use this file in
** accordance with the commercial license agreement provided with the
** Software or, alternatively, in accordance with the terms contained in
** a written agreement between you and The Qt Company. For licensing terms
** and conditions see https://www.qt.io/terms-conditions. For further
** information use the contact form at https://www.qt.io/contact-us.
**
** GNU General Public License Usage
** Alternatively, this file may be used under the terms of the GNU
** General Public License version 3 as published by the Free Software
** Foundation with exceptions as appearing in the file LICENSE.GPL3-EXCEPT
** included in the packaging of this file. Please review the following
** information to ensure the GNU General Public License requirements will
** be met: https://www.gnu.org/licenses/gpl-3.0.html.
**
** $QT_END_LICENSE$
**
****************************************************************************/
 
using System;
using System.Collections.Generic;
using System.Text;
 
namespace QtVsTools.SyntaxAnalysis
{
    ////////////////////////////////////////////////////////////////////////////////////////////////
    ///
    /// RegExpr
    ///
    ////////////////////////////////////////////////////////////////////////////////////////////////
    /// <summary>
    /// Abstract representation of a regular expression.
    /// </summary>
    /// <remarks>
    /// RegExpr objects can be created and combined using C# expressions, and then rendered into a
    /// regular expression pattern and parser.
    /// </remarks>
    public abstract partial class RegExpr
    {
        /// <summary>
        /// Render the RegExpr into a corresponding pattern and parser.
        /// </summary>
        /// <param name="defaultTokenWs">Default token whitespace</param>
        /// <returns>
        /// <see cref="Parser"/> object that can process strings according to the pattern rendered.
        /// </returns>
        public Parser Render(RegExpr defaultTokenWs = null)
        {
            return new Parser(this, defaultTokenWs);
        }
 
        [Flags]
        protected enum RenderMode { Default = 0, Assert = 1 }
 
        /// <summary>
        /// Event triggered when starting the rendering process for this RegExpr.
        /// </summary>
        /// <param name="defaultTokenWs">Default token whitespace</param>
        /// <param name="parent">Parent expression</param>
        /// <param name="pattern">Rendered pattern</param>
        /// <param name="mode">Rendering mode</param>
        ///
        /// <returns>Sub-expressions to add to the rendering process.</returns>
        /// <remarks>
        /// RegExpr sub-classes will re-implement OnRenderBegin, OnRenderNext and OnRenderEnd to
        /// define their specific rendering process. Regular expression strings are appended to
        /// <paramref name="pattern"/>. When rendering a named capture group, a mapping to a
        /// production object can be defined and added to <paramref name="prodMap"/>. The production
        /// object will be responsible for translating the captured values into instances of
        /// external, application specific classes.
        /// </remarks>
        protected virtual IEnumerable<RegExpr> OnRender(RegExpr defaultTokenWs, RegExpr parent,
            StringBuilder pattern, ref RenderMode mode, Stack<Token> tokenStack)
        { return null; }
 
        /// <summary>
        /// Event triggered when rendering the next sub-expression.
        /// </summary>
        /// <param name="defaultTokenWs">Default token whitespace</param>
        /// <param name="parent">Parent expression</param>
        /// <param name="pattern">Rendered pattern</param>
        /// <param name="mode">Rendering mode</param>
        ///
        protected virtual void OnRenderNext(RegExpr defaultTokenWs, RegExpr parent,
            StringBuilder pattern, ref RenderMode mode, Stack<Token> tokenStack)
        { }
 
        /// <summary>
        /// Event triggered after all sub-expressions have been rendered.
        /// </summary>
        /// <param name="defaultTokenWs">Default token whitespace</param>
        /// <param name="parent">Parent expression</param>
        /// <param name="pattern">Rendered pattern</param>
        /// <param name="mode">Rendering mode</param>
        ///
        protected virtual void OnRenderEnd(RegExpr defaultTokenWs, RegExpr parent,
            StringBuilder pattern, ref RenderMode mode, Stack<Token> tokenStack)
        { }
 
        public class RegExprException : System.Exception
        {
            public RegExprException(string message = null) : base(message) { }
        }
    }
}