automotive/dbc
1
0 Fork 0
Code Issues 4 Pull Requests Actions Packages Projects Releases Wiki Activity

upfate doxygen

Browse Source
This commit is contained in:
deeaitch committed 2026-10-20 13:40:44 -04:00
1 parent a55d1c58ed
commit c43222939f
433 files changed
+15617 -7061
Download Patch File Download Diff File Expand all files Collapse all files

No files matched your search

docs/html/dbc__parser_8cpp_source.html
+145 -99
View File
@@ -109,109 +109,155 @@ $(document).ready(function(){initNavTree('dbc__parser_8cpp_source.html',''); ini
<div class="line"><a id="l00019" name="l00019"></a><span class="lineno"> 19</span><span class="preprocessor">#include &lt;utility&gt;</span></div>
<div class="line"><a id="l00020" name="l00020"></a><span class="lineno"> 20</span> </div>
<div class="line"><a id="l00021" name="l00021"></a><span class="lineno"> 21</span><span class="keyword">namespace </span>{</div>
<div class="line"><a id="l00022" name="l00022"></a><span class="lineno"> 22</span> DbcDiagnosticCode StatementErrorCode(<span class="keyword">const</span> std::string &amp;keyword) {</div>
<div class="line"><a id="l00023" name="l00023"></a><span class="lineno"> 23</span> <span class="keywordflow">if</span> (keyword == <span class="stringliteral">&quot;SG_MUL_VAL_&quot;</span>)</div>
<div class="line"><a id="l00024" name="l00024"></a><span class="lineno"> 24</span> <span class="keywordflow">return</span> DbcDiagnosticCode::UnsupportedStatement;</div>
<div class="line"><a id="l00025" name="l00025"></a><span class="lineno"> 25</span> <span class="keywordflow">if</span> (keyword == <span class="stringliteral">&quot;VAL_&quot;</span>)</div>
<div class="line"><a id="l00026" name="l00026"></a><span class="lineno"> 26</span> <span class="keywordflow">return</span> DbcDiagnosticCode::InvalidValueDescription;</div>
<div class="line"><a id="l00027" name="l00027"></a><span class="lineno"> 27</span> <span class="keywordflow">return</span> DbcDiagnosticCode::InvalidStatement;</div>
<div class="line"><a id="l00028" name="l00028"></a><span class="lineno"> 28</span> }</div>
<div class="line"><a id="l00029" name="l00029"></a><span class="lineno"> 29</span>}</div>
<div class="line"><a id="l00030" name="l00030"></a><span class="lineno"> 30</span> </div>
<div class="foldopen" id="foldopen00031" data-start="{" data-end="}">
<div class="line"><a id="l00031" name="l00031"></a><span class="lineno"><a class="line" href="classDbcParser.html#aef72826942c9095d653fafa435855e56"> 31</a></span><a class="code hl_struct" href="structDbcDatabase.html">DbcDatabase</a> <a class="code hl_function" href="classDbcParser.html#aef72826942c9095d653fafa435855e56">DbcParser::ParseFile</a>(<span class="keyword">const</span> std::string &amp;filePath)<span class="keyword"> const </span>{</div>
<div class="line"><a id="l00032" name="l00032"></a><span class="lineno"> 32</span> <a class="code hl_struct" href="structDbcParseResult.html">DbcParseResult</a> result = <a class="code hl_function" href="classDbcParser.html#a0e915ce79c2e3d4c95a5aaf2bf0409bc">ParseFileWithDiagnostics</a>(filePath);</div>
<div class="line"><a id="l00033" name="l00033"></a><span class="lineno"> 33</span> <span class="keywordflow">for</span> (<span class="keyword">const</span> <a class="code hl_struct" href="structDbcDiagnostic.html">DbcDiagnostic</a> &amp;diagnostic : result.diagnostics) {</div>
<div class="line"><a id="l00034" name="l00034"></a><span class="lineno"> 34</span> <span class="keywordflow">if</span> (diagnostic.severity == DbcDiagnosticSeverity::Error) {</div>
<div class="line"><a id="l00035" name="l00035"></a><span class="lineno"> 35</span> <span class="keywordflow">if</span> (diagnostic.lineNumber == 0U)</div>
<div class="line"><a id="l00036" name="l00036"></a><span class="lineno"> 36</span> <span class="keywordflow">throw</span> std::runtime_error(diagnostic.message);</div>
<div class="line"><a id="l00037" name="l00037"></a><span class="lineno"> 37</span> <span class="keywordflow">throw</span> std::runtime_error(diagnostic.filePath + <span class="stringliteral">&quot;:&quot;</span> +</div>
<div class="line"><a id="l00038" name="l00038"></a><span class="lineno"> 38</span> std::to_string(diagnostic.lineNumber) + <span class="stringliteral">&quot;: &quot;</span> + diagnostic.message);</div>
<div class="line"><a id="l00039" name="l00039"></a><span class="lineno"> 39</span> }</div>
<div class="line"><a id="l00040" name="l00040"></a><span class="lineno"> 40</span> }</div>
<div class="line"><a id="l00041" name="l00041"></a><span class="lineno"> 41</span> <span class="keywordflow">return</span> std::move(result.database);</div>
<div class="line"><a id="l00042" name="l00042"></a><span class="lineno"> 42</span>}</div>
<div class="line"><a id="l00022" name="l00022"></a><span class="lineno"> 22</span> <span class="comment">// Read through the closing unescaped quote, preserving comment whitespace.</span></div>
<div class="line"><a id="l00023" name="l00023"></a><span class="lineno"> 23</span> <span class="keywordtype">void</span> ReadCommentLines(std::ifstream &amp;input, std::string &amp;statement,</div>
<div class="line"><a id="l00024" name="l00024"></a><span class="lineno"> 24</span> std::size_t &amp;lineNumber) {</div>
<div class="line"><a id="l00025" name="l00025"></a><span class="lineno"> 25</span> <span class="keywordtype">bool</span> inQuote = <span class="keyword">false</span>;</div>
<div class="line"><a id="l00026" name="l00026"></a><span class="lineno"> 26</span> <span class="keywordtype">bool</span> escaped = <span class="keyword">false</span>;</div>
<div class="line"><a id="l00027" name="l00027"></a><span class="lineno"> 27</span> std::string part = statement;</div>
<div class="line"><a id="l00028" name="l00028"></a><span class="lineno"> 28</span> <span class="keywordflow">for</span> (;;) {</div>
<div class="line"><a id="l00029" name="l00029"></a><span class="lineno"> 29</span> <span class="keywordflow">for</span> (<span class="keyword">const</span> <span class="keywordtype">char</span> character: part) {</div>
<div class="line"><a id="l00030" name="l00030"></a><span class="lineno"> 30</span> <span class="keywordflow">if</span> (escaped) {</div>
<div class="line"><a id="l00031" name="l00031"></a><span class="lineno"> 31</span> escaped = <span class="keyword">false</span>;</div>
<div class="line"><a id="l00032" name="l00032"></a><span class="lineno"> 32</span> } <span class="keywordflow">else</span> <span class="keywordflow">if</span> (inQuote &amp;&amp; character == <span class="charliteral">&#39;\\&#39;</span>) {</div>
<div class="line"><a id="l00033" name="l00033"></a><span class="lineno"> 33</span> escaped = <span class="keyword">true</span>;</div>
<div class="line"><a id="l00034" name="l00034"></a><span class="lineno"> 34</span> } <span class="keywordflow">else</span> <span class="keywordflow">if</span> (character == <span class="charliteral">&#39;&quot;&#39;</span>) {</div>
<div class="line"><a id="l00035" name="l00035"></a><span class="lineno"> 35</span> <span class="keywordflow">if</span> (inQuote)</div>
<div class="line"><a id="l00036" name="l00036"></a><span class="lineno"> 36</span> <span class="keywordflow">return</span>;</div>
<div class="line"><a id="l00037" name="l00037"></a><span class="lineno"> 37</span> inQuote = <span class="keyword">true</span>;</div>
<div class="line"><a id="l00038" name="l00038"></a><span class="lineno"> 38</span> }</div>
<div class="line"><a id="l00039" name="l00039"></a><span class="lineno"> 39</span> }</div>
<div class="line"><a id="l00040" name="l00040"></a><span class="lineno"> 40</span> <span class="keywordflow">if</span> (!inQuote || !std::getline(input, part))</div>
<div class="line"><a id="l00041" name="l00041"></a><span class="lineno"> 41</span> <span class="keywordflow">return</span>;</div>
<div class="line"><a id="l00042" name="l00042"></a><span class="lineno"> 42</span> ++lineNumber;</div>
<div class="line"><a id="l00043" name="l00043"></a><span class="lineno"> 43</span> <span class="keywordflow">if</span> (!part.empty() &amp;&amp; part.back() == <span class="charliteral">&#39;\r&#39;</span>)</div>
<div class="line"><a id="l00044" name="l00044"></a><span class="lineno"> 44</span> part.pop_back();</div>
<div class="line"><a id="l00045" name="l00045"></a><span class="lineno"> 45</span> statement += <span class="charliteral">&#39;\n&#39;</span>;</div>
<div class="line"><a id="l00046" name="l00046"></a><span class="lineno"> 46</span> statement += part;</div>
<div class="line"><a id="l00047" name="l00047"></a><span class="lineno"> 47</span> <span class="comment">// A physical newline cannot escape the next line&#39;s first character.</span></div>
<div class="line"><a id="l00048" name="l00048"></a><span class="lineno"> 48</span> escaped = <span class="keyword">false</span>;</div>
<div class="line"><a id="l00049" name="l00049"></a><span class="lineno"> 49</span> }</div>
<div class="line"><a id="l00050" name="l00050"></a><span class="lineno"> 50</span> }</div>
<div class="line"><a id="l00051" name="l00051"></a><span class="lineno"> 51</span> </div>
<div class="line"><a id="l00052" name="l00052"></a><span class="lineno"> 52</span> DbcDiagnosticCode StatementErrorCode(<span class="keyword">const</span> std::string &amp;keyword) {</div>
<div class="line"><a id="l00053" name="l00053"></a><span class="lineno"> 53</span> <span class="keywordflow">if</span> (keyword == <span class="stringliteral">&quot;SG_MUL_VAL_&quot;</span>)</div>
<div class="line"><a id="l00054" name="l00054"></a><span class="lineno"> 54</span> <span class="keywordflow">return</span> DbcDiagnosticCode::UnsupportedStatement;</div>
<div class="line"><a id="l00055" name="l00055"></a><span class="lineno"> 55</span> <span class="keywordflow">if</span> (keyword == <span class="stringliteral">&quot;VAL_&quot;</span>)</div>
<div class="line"><a id="l00056" name="l00056"></a><span class="lineno"> 56</span> <span class="keywordflow">return</span> DbcDiagnosticCode::InvalidValueDescription;</div>
<div class="line"><a id="l00057" name="l00057"></a><span class="lineno"> 57</span> <span class="keywordflow">return</span> DbcDiagnosticCode::InvalidStatement;</div>
<div class="line"><a id="l00058" name="l00058"></a><span class="lineno"> 58</span> }</div>
<div class="line"><a id="l00059" name="l00059"></a><span class="lineno"> 59</span>}</div>
<div class="line"><a id="l00060" name="l00060"></a><span class="lineno"> 60</span> </div>
<div class="foldopen" id="foldopen00061" data-start="{" data-end="}">
<div class="line"><a id="l00061" name="l00061"></a><span class="lineno"><a class="line" href="classDbcParser.html#aef72826942c9095d653fafa435855e56"> 61</a></span><a class="code hl_struct" href="structDbcDatabase.html">DbcDatabase</a> <a class="code hl_function" href="classDbcParser.html#aef72826942c9095d653fafa435855e56">DbcParser::ParseFile</a>(<span class="keyword">const</span> std::string &amp;filePath)<span class="keyword"> const </span>{</div>
<div class="line"><a id="l00062" name="l00062"></a><span class="lineno"> 62</span> <a class="code hl_struct" href="structDbcParseResult.html">DbcParseResult</a> result = <a class="code hl_function" href="classDbcParser.html#a0e915ce79c2e3d4c95a5aaf2bf0409bc">ParseFileWithDiagnostics</a>(filePath);</div>
<div class="line"><a id="l00063" name="l00063"></a><span class="lineno"> 63</span> <span class="keywordflow">for</span> (<span class="keyword">const</span> <a class="code hl_struct" href="structDbcDiagnostic.html">DbcDiagnostic</a> &amp;diagnostic : result.<a class="code hl_variable" href="structDbcParseResult.html#a3a1987b4381bb1e0a34dc09e31483679">diagnostics</a>) {</div>
<div class="line"><a id="l00064" name="l00064"></a><span class="lineno"> 64</span> <span class="keywordflow">if</span> (diagnostic.severity == DbcDiagnosticSeverity::Error) {</div>
<div class="line"><a id="l00065" name="l00065"></a><span class="lineno"> 65</span> <span class="keywordflow">if</span> (diagnostic.lineNumber == 0U)</div>
<div class="line"><a id="l00066" name="l00066"></a><span class="lineno"> 66</span> <span class="keywordflow">throw</span> std::runtime_error(diagnostic.message);</div>
<div class="line"><a id="l00067" name="l00067"></a><span class="lineno"> 67</span> <span class="keywordflow">throw</span> std::runtime_error(diagnostic.filePath + <span class="stringliteral">&quot;:&quot;</span> +</div>
<div class="line"><a id="l00068" name="l00068"></a><span class="lineno"> 68</span> std::to_string(diagnostic.lineNumber) + <span class="stringliteral">&quot;: &quot;</span> + diagnostic.message);</div>
<div class="line"><a id="l00069" name="l00069"></a><span class="lineno"> 69</span> }</div>
<div class="line"><a id="l00070" name="l00070"></a><span class="lineno"> 70</span> }</div>
<div class="line"><a id="l00071" name="l00071"></a><span class="lineno"> 71</span> <span class="keywordflow">return</span> std::move(result.<a class="code hl_variable" href="structDbcParseResult.html#abfa765d29a4397e8ddaf771bae21993e">database</a>);</div>
<div class="line"><a id="l00072" name="l00072"></a><span class="lineno"> 72</span>}</div>
</div>
<div class="line"><a id="l00043" name="l00043"></a><span class="lineno"> 43</span> </div>
<div class="foldopen" id="foldopen00044" data-start="{" data-end="}">
<div class="line"><a id="l00044" name="l00044"></a><span class="lineno"><a class="line" href="classDbcParser.html#a0e915ce79c2e3d4c95a5aaf2bf0409bc"> 44</a></span><a class="code hl_struct" href="structDbcParseResult.html">DbcParseResult</a> <a class="code hl_function" href="classDbcParser.html#a0e915ce79c2e3d4c95a5aaf2bf0409bc">DbcParser::ParseFileWithDiagnostics</a>(<span class="keyword">const</span> std::string &amp;filePath)<span class="keyword"> const </span>{</div>
<div class="line"><a id="l00045" name="l00045"></a><span class="lineno"> 45</span> <a class="code hl_struct" href="structDbcParseResult.html">DbcParseResult</a> result;</div>
<div class="line"><a id="l00046" name="l00046"></a><span class="lineno"> 46</span> std::ifstream input(filePath.c_str());</div>
<div class="line"><a id="l00047" name="l00047"></a><span class="lineno"> 47</span> <span class="keywordflow">if</span> (!input.is_open()) {</div>
<div class="line"><a id="l00048" name="l00048"></a><span class="lineno"> 48</span> result.diagnostics.push_back({DbcDiagnosticSeverity::Error,</div>
<div class="line"><a id="l00049" name="l00049"></a><span class="lineno"> 49</span> DbcDiagnosticCode::FileOpenError, filePath, 0U,</div>
<div class="line"><a id="l00050" name="l00050"></a><span class="lineno"> 50</span> <span class="stringliteral">&quot;Failed to open DBC file: &quot;</span> + filePath});</div>
<div class="line"><a id="l00051" name="l00051"></a><span class="lineno"> 51</span> <span class="keywordflow">return</span> result;</div>
<div class="line"><a id="l00052" name="l00052"></a><span class="lineno"> 52</span> }</div>
<div class="line"><a id="l00053" name="l00053"></a><span class="lineno"> 53</span> </div>
<div class="line"><a id="l00054" name="l00054"></a><span class="lineno"> 54</span> <a class="code hl_struct" href="structDbcDatabase.html">DbcDatabase</a> database;</div>
<div class="line"><a id="l00055" name="l00055"></a><span class="lineno"> 55</span> <a class="code hl_struct" href="structDbcParseContext.html">DbcParseContext</a> context{database, <span class="keyword">nullptr</span>};</div>
<div class="line"><a id="l00056" name="l00056"></a><span class="lineno"> 56</span> <span class="keyword">const</span> <a class="code hl_class" href="classDbcStatementDispatcher.html">DbcStatementDispatcher</a> dispatcher;</div>
<div class="line"><a id="l00057" name="l00057"></a><span class="lineno"> 57</span> <span class="keywordtype">bool</span> inNamespace = <span class="keyword">false</span>;</div>
<div class="line"><a id="l00058" name="l00058"></a><span class="lineno"> 58</span> std::size_t lineNumber = 0U;</div>
<div class="line"><a id="l00059" name="l00059"></a><span class="lineno"> 59</span> std::string line;</div>
<div class="line"><a id="l00060" name="l00060"></a><span class="lineno"> 60</span> <span class="keywordflow">while</span> (std::getline(input, line)) {</div>
<div class="line"><a id="l00061" name="l00061"></a><span class="lineno"> 61</span> ++lineNumber;</div>
<div class="line"><a id="l00062" name="l00062"></a><span class="lineno"> 62</span> line = dbc_detail::TrimText(line);</div>
<div class="line"><a id="l00063" name="l00063"></a><span class="lineno"> 63</span> <span class="keywordflow">if</span> (line.empty())</div>
<div class="line"><a id="l00064" name="l00064"></a><span class="lineno"> 64</span> <span class="keywordflow">continue</span>;</div>
<div class="line"><a id="l00065" name="l00065"></a><span class="lineno"> 65</span> </div>
<div class="line"><a id="l00066" name="l00066"></a><span class="lineno"> 66</span> std::istringstream tokens(line);</div>
<div class="line"><a id="l00067" name="l00067"></a><span class="lineno"> 67</span> std::string keyword;</div>
<div class="line"><a id="l00068" name="l00068"></a><span class="lineno"> 68</span> std::string argument;</div>
<div class="line"><a id="l00069" name="l00069"></a><span class="lineno"> 69</span> tokens &gt;&gt; keyword;</div>
<div class="line"><a id="l00070" name="l00070"></a><span class="lineno"> 70</span> <span class="keyword">const</span> <span class="keywordtype">bool</span> hasArgument = <span class="keyword">static_cast&lt;</span><span class="keywordtype">bool</span><span class="keyword">&gt;</span>(tokens &gt;&gt; argument);</div>
<div class="line"><a id="l00071" name="l00071"></a><span class="lineno"> 71</span> <span class="keywordflow">if</span> (inNamespace &amp;&amp; !hasArgument &amp;&amp; keyword != <span class="stringliteral">&quot;BO_&quot;</span> &amp;&amp; keyword != <span class="stringliteral">&quot;SG_&quot;</span> &amp;&amp;</div>
<div class="line"><a id="l00072" name="l00072"></a><span class="lineno"> 72</span> keyword != <span class="stringliteral">&quot;BS_&quot;</span> &amp;&amp; keyword != <span class="stringliteral">&quot;BS_:&quot;</span> &amp;&amp;</div>
<div class="line"><a id="l00073" name="l00073"></a><span class="lineno"> 73</span> keyword != <span class="stringliteral">&quot;BU_&quot;</span> &amp;&amp; keyword != <span class="stringliteral">&quot;BU_:&quot;</span>)</div>
<div class="line"><a id="l00074" name="l00074"></a><span class="lineno"> 74</span> <span class="keywordflow">continue</span>; <span class="comment">// NS_ lists syntax symbols; BO_, SG_, BS_ and BU_ end the list.</span></div>
<div class="line"><a id="l00075" name="l00075"></a><span class="lineno"> 75</span> inNamespace = keyword == <span class="stringliteral">&quot;NS_&quot;</span> || keyword == <span class="stringliteral">&quot;NS_:&quot;</span>;</div>
<div class="line"><a id="l00076" name="l00076"></a><span class="lineno"> 76</span> </div>
<div class="line"><a id="l00077" name="l00077"></a><span class="lineno"> 77</span> <span class="keywordflow">try</span> {</div>
<div class="line"><a id="l00078" name="l00078"></a><span class="lineno"> 78</span> context.lineNumber = lineNumber;</div>
<div class="line"><a id="l00079" name="l00079"></a><span class="lineno"> 79</span> <span class="keywordflow">if</span> (!dispatcher.<a class="code hl_function" href="classDbcStatementDispatcher.html#a495c2d5c7ebb8103b1987cdd87c142ed">Dispatch</a>(line, context)) {</div>
<div class="line"><a id="l00080" name="l00080"></a><span class="lineno"> 80</span> result.diagnostics.push_back({DbcDiagnosticSeverity::Warning,</div>
<div class="line"><a id="l00081" name="l00081"></a><span class="lineno"> 81</span> DbcDiagnosticCode::UnsupportedStatement,</div>
<div class="line"><a id="l00082" name="l00082"></a><span class="lineno"> 82</span> filePath, lineNumber,</div>
<div class="line"><a id="l00083" name="l00083"></a><span class="lineno"> 83</span> <span class="stringliteral">&quot;Unsupported statement &#39;&quot;</span> + keyword +</div>
<div class="line"><a id="l00084" name="l00084"></a><span class="lineno"> 84</span> <span class="stringliteral">&quot;&#39; is ignored; decoding or metadata may be incomplete.&quot;</span>});</div>
<div class="line"><a id="l00085" name="l00085"></a><span class="lineno"> 85</span> }</div>
<div class="line"><a id="l00086" name="l00086"></a><span class="lineno"> 86</span> } <span class="keywordflow">catch</span> (<span class="keyword">const</span> std::exception &amp;error) {</div>
<div class="line"><a id="l00087" name="l00087"></a><span class="lineno"> 87</span> result.diagnostics.push_back({DbcDiagnosticSeverity::Error,</div>
<div class="line"><a id="l00088" name="l00088"></a><span class="lineno"> 88</span> StatementErrorCode(keyword), filePath,</div>
<div class="line"><a id="l00089" name="l00089"></a><span class="lineno"> 89</span> lineNumber, error.what()});</div>
<div class="line"><a id="l00090" name="l00090"></a><span class="lineno"> 90</span> <span class="keywordflow">return</span> result;</div>
<div class="line"><a id="l00091" name="l00091"></a><span class="lineno"> 91</span> }</div>
<div class="line"><a id="l00092" name="l00092"></a><span class="lineno"> 92</span> }</div>
<div class="line"><a id="l00093" name="l00093"></a><span class="lineno"> 93</span> </div>
<div class="line"><a id="l00094" name="l00094"></a><span class="lineno"> 94</span> <span class="keywordflow">if</span> (input.bad() || !input.eof()) {</div>
<div class="line"><a id="l00095" name="l00095"></a><span class="lineno"> 95</span> result.diagnostics.push_back({DbcDiagnosticSeverity::Error,</div>
<div class="line"><a id="l00096" name="l00096"></a><span class="lineno"> 96</span> DbcDiagnosticCode::FileReadError, filePath, 0U,</div>
<div class="line"><a id="l00097" name="l00097"></a><span class="lineno"> 97</span> <span class="stringliteral">&quot;Failed to read DBC file: &quot;</span> + filePath});</div>
<div class="line"><a id="l00098" name="l00098"></a><span class="lineno"> 98</span> <span class="keywordflow">return</span> result;</div>
<div class="line"><a id="l00099" name="l00099"></a><span class="lineno"> 99</span> }</div>
<div class="line"><a id="l00073" name="l00073"></a><span class="lineno"> 73</span> </div>
<div class="foldopen" id="foldopen00074" data-start="{" data-end="}">
<div class="line"><a id="l00074" name="l00074"></a><span class="lineno"><a class="line" href="classDbcParser.html#a0e915ce79c2e3d4c95a5aaf2bf0409bc"> 74</a></span><a class="code hl_struct" href="structDbcParseResult.html">DbcParseResult</a> <a class="code hl_function" href="classDbcParser.html#a0e915ce79c2e3d4c95a5aaf2bf0409bc">DbcParser::ParseFileWithDiagnostics</a>(<span class="keyword">const</span> std::string &amp;filePath)<span class="keyword"> const </span>{</div>
<div class="line"><a id="l00075" name="l00075"></a><span class="lineno"> 75</span> <a class="code hl_struct" href="structDbcParseResult.html">DbcParseResult</a> result;</div>
<div class="line"><a id="l00076" name="l00076"></a><span class="lineno"> 76</span> std::ifstream input(filePath.c_str());</div>
<div class="line"><a id="l00077" name="l00077"></a><span class="lineno"> 77</span> <span class="keywordflow">if</span> (!input.is_open()) {</div>
<div class="line"><a id="l00078" name="l00078"></a><span class="lineno"> 78</span> result.<a class="code hl_variable" href="structDbcParseResult.html#a3a1987b4381bb1e0a34dc09e31483679">diagnostics</a>.push_back({DbcDiagnosticSeverity::Error,</div>
<div class="line"><a id="l00079" name="l00079"></a><span class="lineno"> 79</span> DbcDiagnosticCode::FileOpenError, filePath, 0U,</div>
<div class="line"><a id="l00080" name="l00080"></a><span class="lineno"> 80</span> <span class="stringliteral">&quot;Failed to open DBC file: &quot;</span> + filePath});</div>
<div class="line"><a id="l00081" name="l00081"></a><span class="lineno"> 81</span> <span class="keywordflow">return</span> result;</div>
<div class="line"><a id="l00082" name="l00082"></a><span class="lineno"> 82</span> }</div>
<div class="line"><a id="l00083" name="l00083"></a><span class="lineno"> 83</span> </div>
<div class="line"><a id="l00084" name="l00084"></a><span class="lineno"> 84</span> <a class="code hl_struct" href="structDbcDatabase.html">DbcDatabase</a> database;</div>
<div class="line"><a id="l00085" name="l00085"></a><span class="lineno"> 85</span> <a class="code hl_struct" href="structDbcParseContext.html">DbcParseContext</a> context{database, <span class="keyword">nullptr</span>};</div>
<div class="line"><a id="l00086" name="l00086"></a><span class="lineno"> 86</span> context.enableJ1939 = options.<a class="code hl_variable" href="structDbcParserOptions.html#ab31534f5c0853461b46cbb38149c33f9">enableJ1939</a>;</div>
<div class="line"><a id="l00087" name="l00087"></a><span class="lineno"> 87</span> <span class="keyword">const</span> <a class="code hl_class" href="classDbcStatementDispatcher.html">DbcStatementDispatcher</a> dispatcher;</div>
<div class="line"><a id="l00088" name="l00088"></a><span class="lineno"> 88</span> <span class="keywordtype">bool</span> inNamespace = <span class="keyword">false</span>;</div>
<div class="line"><a id="l00089" name="l00089"></a><span class="lineno"> 89</span> std::size_t lineNumber = 0U;</div>
<div class="line"><a id="l00090" name="l00090"></a><span class="lineno"> 90</span> std::string line;</div>
<div class="line"><a id="l00091" name="l00091"></a><span class="lineno"> 91</span> <span class="keywordflow">while</span> (std::getline(input, line)) {</div>
<div class="line"><a id="l00092" name="l00092"></a><span class="lineno"> 92</span> ++lineNumber;</div>
<div class="line"><a id="l00093" name="l00093"></a><span class="lineno"> 93</span> <span class="keywordflow">if</span> (!line.empty() &amp;&amp; line.back() == <span class="charliteral">&#39;\r&#39;</span>)</div>
<div class="line"><a id="l00094" name="l00094"></a><span class="lineno"> 94</span> line.pop_back();</div>
<div class="line"><a id="l00095" name="l00095"></a><span class="lineno"> 95</span> <span class="keyword">const</span> std::string rawLine = line;</div>
<div class="line"><a id="l00096" name="l00096"></a><span class="lineno"> 96</span> <span class="keyword">const</span> std::size_t statementLine = lineNumber;</div>
<div class="line"><a id="l00097" name="l00097"></a><span class="lineno"> 97</span> line = dbc_detail::TrimText(line);</div>
<div class="line"><a id="l00098" name="l00098"></a><span class="lineno"> 98</span> <span class="keywordflow">if</span> (line.empty())</div>
<div class="line"><a id="l00099" name="l00099"></a><span class="lineno"> 99</span> <span class="keywordflow">continue</span>;</div>
<div class="line"><a id="l00100" name="l00100"></a><span class="lineno"> 100</span> </div>
<div class="line"><a id="l00101" name="l00101"></a><span class="lineno"> 101</span> <span class="keywordflow">try</span> {</div>
<div class="line"><a id="l00102" name="l00102"></a><span class="lineno"> 102</span> context.ResolveValueDescriptions(filePath);</div>
<div class="line"><a id="l00103" name="l00103"></a><span class="lineno"> 103</span> context.ValidateMultiplexing(filePath);</div>
<div class="line"><a id="l00104" name="l00104"></a><span class="lineno"> 104</span> } <span class="keywordflow">catch</span> (<span class="keyword">const</span> <a class="code hl_class" href="classDbcDiagnosticError.html">DbcDiagnosticError</a> &amp;error) {</div>
<div class="line"><a id="l00105" name="l00105"></a><span class="lineno"> 105</span> result.diagnostics.push_back(error.diagnostic);</div>
<div class="line"><a id="l00106" name="l00106"></a><span class="lineno"> 106</span> <span class="keywordflow">return</span> result;</div>
<div class="line"><a id="l00107" name="l00107"></a><span class="lineno"> 107</span> }</div>
<div class="line"><a id="l00108" name="l00108"></a><span class="lineno"> 108</span> result.database = std::move(database);</div>
<div class="line"><a id="l00109" name="l00109"></a><span class="lineno"> 109</span> <span class="keywordflow">return</span> result;</div>
<div class="line"><a id="l00110" name="l00110"></a><span class="lineno"> 110</span>}</div>
<div class="line"><a id="l00101" name="l00101"></a><span class="lineno"> 101</span> std::istringstream tokens(line);</div>
<div class="line"><a id="l00102" name="l00102"></a><span class="lineno"> 102</span> std::string keyword;</div>
<div class="line"><a id="l00103" name="l00103"></a><span class="lineno"> 103</span> std::string argument;</div>
<div class="line"><a id="l00104" name="l00104"></a><span class="lineno"> 104</span> tokens &gt;&gt; keyword;</div>
<div class="line"><a id="l00105" name="l00105"></a><span class="lineno"> 105</span> <span class="keyword">const</span> <span class="keywordtype">bool</span> hasArgument = <span class="keyword">static_cast&lt;</span><span class="keywordtype">bool</span><span class="keyword">&gt;</span>(tokens &gt;&gt; argument);</div>
<div class="line"><a id="l00106" name="l00106"></a><span class="lineno"> 106</span> <span class="keywordflow">if</span> (inNamespace &amp;&amp; !hasArgument &amp;&amp; keyword != <span class="stringliteral">&quot;BO_&quot;</span> &amp;&amp; keyword != <span class="stringliteral">&quot;SG_&quot;</span> &amp;&amp;</div>
<div class="line"><a id="l00107" name="l00107"></a><span class="lineno"> 107</span> keyword != <span class="stringliteral">&quot;BS_&quot;</span> &amp;&amp; keyword != <span class="stringliteral">&quot;BS_:&quot;</span> &amp;&amp;</div>
<div class="line"><a id="l00108" name="l00108"></a><span class="lineno"> 108</span> keyword != <span class="stringliteral">&quot;BU_&quot;</span> &amp;&amp; keyword != <span class="stringliteral">&quot;BU_:&quot;</span>)</div>
<div class="line"><a id="l00109" name="l00109"></a><span class="lineno"> 109</span> <span class="keywordflow">continue</span>; <span class="comment">// NS_ lists syntax symbols; BO_, SG_, BS_ and BU_ end the list.</span></div>
<div class="line"><a id="l00110" name="l00110"></a><span class="lineno"> 110</span> inNamespace = keyword == <span class="stringliteral">&quot;NS_&quot;</span> || keyword == <span class="stringliteral">&quot;NS_:&quot;</span>;</div>
<div class="line"><a id="l00111" name="l00111"></a><span class="lineno"> 111</span> </div>
<div class="line"><a id="l00112" name="l00112"></a><span class="lineno"> 112</span> <span class="keywordflow">if</span> (keyword == <span class="stringliteral">&quot;CM_&quot;</span>) {</div>
<div class="line"><a id="l00113" name="l00113"></a><span class="lineno"> 113</span> line = rawLine;</div>
<div class="line"><a id="l00114" name="l00114"></a><span class="lineno"> 114</span> ReadCommentLines(input, line, lineNumber);</div>
<div class="line"><a id="l00115" name="l00115"></a><span class="lineno"> 115</span> }</div>
<div class="line"><a id="l00116" name="l00116"></a><span class="lineno"> 116</span> </div>
<div class="line"><a id="l00117" name="l00117"></a><span class="lineno"> 117</span> <span class="keywordflow">try</span> {</div>
<div class="line"><a id="l00118" name="l00118"></a><span class="lineno"> 118</span> context.lineNumber = statementLine;</div>
<div class="line"><a id="l00119" name="l00119"></a><span class="lineno"> 119</span> <span class="keywordflow">if</span> (!dispatcher.<a class="code hl_function" href="classDbcStatementDispatcher.html#a495c2d5c7ebb8103b1987cdd87c142ed">Dispatch</a>(line, context)) {</div>
<div class="line"><a id="l00120" name="l00120"></a><span class="lineno"> 120</span> result.<a class="code hl_variable" href="structDbcParseResult.html#a3a1987b4381bb1e0a34dc09e31483679">diagnostics</a>.push_back({DbcDiagnosticSeverity::Warning,</div>
<div class="line"><a id="l00121" name="l00121"></a><span class="lineno"> 121</span> DbcDiagnosticCode::UnsupportedStatement,</div>
<div class="line"><a id="l00122" name="l00122"></a><span class="lineno"> 122</span> filePath, statementLine,</div>
<div class="line"><a id="l00123" name="l00123"></a><span class="lineno"> 123</span> <span class="stringliteral">&quot;Unsupported statement &#39;&quot;</span> + keyword +</div>
<div class="line"><a id="l00124" name="l00124"></a><span class="lineno"> 124</span> <span class="stringliteral">&quot;&#39; is ignored; decoding or metadata may be incomplete.&quot;</span>});</div>
<div class="line"><a id="l00125" name="l00125"></a><span class="lineno"> 125</span> }</div>
<div class="line"><a id="l00126" name="l00126"></a><span class="lineno"> 126</span> } <span class="keywordflow">catch</span> (<span class="keyword">const</span> std::exception &amp;error) {</div>
<div class="line"><a id="l00127" name="l00127"></a><span class="lineno"> 127</span> result.<a class="code hl_variable" href="structDbcParseResult.html#a3a1987b4381bb1e0a34dc09e31483679">diagnostics</a>.push_back({DbcDiagnosticSeverity::Error,</div>
<div class="line"><a id="l00128" name="l00128"></a><span class="lineno"> 128</span> StatementErrorCode(keyword), filePath,</div>
<div class="line"><a id="l00129" name="l00129"></a><span class="lineno"> 129</span> statementLine, error.what()});</div>
<div class="line"><a id="l00130" name="l00130"></a><span class="lineno"> 130</span> <span class="keywordflow">return</span> result;</div>
<div class="line"><a id="l00131" name="l00131"></a><span class="lineno"> 131</span> }</div>
<div class="line"><a id="l00132" name="l00132"></a><span class="lineno"> 132</span> }</div>
<div class="line"><a id="l00133" name="l00133"></a><span class="lineno"> 133</span> </div>
<div class="line"><a id="l00134" name="l00134"></a><span class="lineno"> 134</span> <span class="keywordflow">if</span> (input.bad() || !input.eof()) {</div>
<div class="line"><a id="l00135" name="l00135"></a><span class="lineno"> 135</span> result.<a class="code hl_variable" href="structDbcParseResult.html#a3a1987b4381bb1e0a34dc09e31483679">diagnostics</a>.push_back({DbcDiagnosticSeverity::Error,</div>
<div class="line"><a id="l00136" name="l00136"></a><span class="lineno"> 136</span> DbcDiagnosticCode::FileReadError, filePath, 0U,</div>
<div class="line"><a id="l00137" name="l00137"></a><span class="lineno"> 137</span> <span class="stringliteral">&quot;Failed to read DBC file: &quot;</span> + filePath});</div>
<div class="line"><a id="l00138" name="l00138"></a><span class="lineno"> 138</span> <span class="keywordflow">return</span> result;</div>
<div class="line"><a id="l00139" name="l00139"></a><span class="lineno"> 139</span> }</div>
<div class="line"><a id="l00140" name="l00140"></a><span class="lineno"> 140</span> </div>
<div class="line"><a id="l00141" name="l00141"></a><span class="lineno"> 141</span> <span class="keywordflow">try</span> {</div>
<div class="line"><a id="l00142" name="l00142"></a><span class="lineno"> 142</span> context.ResolveComments(filePath);</div>
<div class="line"><a id="l00143" name="l00143"></a><span class="lineno"> 143</span> context.ResolveValueDescriptions(filePath);</div>
<div class="line"><a id="l00144" name="l00144"></a><span class="lineno"> 144</span> context.ValidateMultiplexing(filePath);</div>
<div class="line"><a id="l00145" name="l00145"></a><span class="lineno"> 145</span> context.ResolveAttributes(filePath, result.<a class="code hl_variable" href="structDbcParseResult.html#a3a1987b4381bb1e0a34dc09e31483679">diagnostics</a>);</div>
<div class="line"><a id="l00146" name="l00146"></a><span class="lineno"> 146</span> } <span class="keywordflow">catch</span> (<span class="keyword">const</span> <a class="code hl_class" href="classDbcDiagnosticError.html">DbcDiagnosticError</a> &amp;error) {</div>
<div class="line"><a id="l00147" name="l00147"></a><span class="lineno"> 147</span> result.<a class="code hl_variable" href="structDbcParseResult.html#a3a1987b4381bb1e0a34dc09e31483679">diagnostics</a>.push_back(error.<a class="code hl_variable" href="classDbcDiagnosticError.html#ab3965082f01d66b6d5c20525af44235d">diagnostic</a>);</div>
<div class="line"><a id="l00148" name="l00148"></a><span class="lineno"> 148</span> <span class="keywordflow">return</span> result;</div>
<div class="line"><a id="l00149" name="l00149"></a><span class="lineno"> 149</span> }</div>
<div class="line"><a id="l00150" name="l00150"></a><span class="lineno"> 150</span> result.<a class="code hl_variable" href="structDbcParseResult.html#abfa765d29a4397e8ddaf771bae21993e">database</a> = std::move(database);</div>
<div class="line"><a id="l00151" name="l00151"></a><span class="lineno"> 151</span> <span class="keywordflow">return</span> result;</div>
<div class="line"><a id="l00152" name="l00152"></a><span class="lineno"> 152</span>}</div>
</div>
<div class="ttc" id="aclassDbcDiagnosticError_html"><div class="ttname"><a href="classDbcDiagnosticError.html">DbcDiagnosticError</a></div><div class="ttdef"><b>Definition</b> <a href="dbc__statement__handler_8h_source.html#l00021">dbc_statement_handler.h:21</a></div></div>
<div class="ttc" id="aclassDbcParser_html_a0e915ce79c2e3d4c95a5aaf2bf0409bc"><div class="ttname"><a href="classDbcParser.html#a0e915ce79c2e3d4c95a5aaf2bf0409bc">DbcParser::ParseFileWithDiagnostics</a></div><div class="ttdeci">DbcParseResult ParseFileWithDiagnostics(const std::string &amp;filePath) const</div><div class="ttdoc">Parse with warnings and a structured first error instead of throwing.</div><div class="ttdef"><b>Definition</b> <a href="dbc__parser_8cpp_source.html#l00044">dbc_parser.cpp:44</a></div></div>
<div class="ttc" id="aclassDbcParser_html_aef72826942c9095d653fafa435855e56"><div class="ttname"><a href="classDbcParser.html#aef72826942c9095d653fafa435855e56">DbcParser::ParseFile</a></div><div class="ttdeci">DbcDatabase ParseFile(const std::string &amp;filePath) const</div><div class="ttdoc">Parse DBC file.</div><div class="ttdef"><b>Definition</b> <a href="dbc__parser_8cpp_source.html#l00031">dbc_parser.cpp:31</a></div></div>
<div class="ttc" id="aclassDbcStatementDispatcher_html"><div class="ttname"><a href="classDbcStatementDispatcher.html">DbcStatementDispatcher</a></div><div class="ttdef"><b>Definition</b> <a href="dbc__statement__handler_8h_source.html#l00091">dbc_statement_handler.h:91</a></div></div>
<div class="ttc" id="aclassDbcStatementDispatcher_html_a495c2d5c7ebb8103b1987cdd87c142ed"><div class="ttname"><a href="classDbcStatementDispatcher.html#a495c2d5c7ebb8103b1987cdd87c142ed">DbcStatementDispatcher::Dispatch</a></div><div class="ttdeci">bool Dispatch(const std::string &amp;line, DbcParseContext &amp;context) const</div><div class="ttdef"><b>Definition</b> <a href="dbc__statement__handler_8cpp_source.html#l00388">dbc_statement_handler.cpp:388</a></div></div>
<div class="ttc" id="adbc__parser_8h_html"><div class="ttname"><a href="dbc__parser_8h.html">dbc_parser.h</a></div><div class="ttdoc">Created: 2026-03-13 Author: Deeaitch (Dim. Himro)</div></div>
<div class="ttc" id="aclassDbcDiagnosticError_html"><div class="ttname"><a href="classDbcDiagnosticError.html">DbcDiagnosticError</a></div><div class="ttdef"><b>Definition</b> <a href="dbc__statement__handler_8h_source.html#l00032">dbc_statement_handler.h:32</a></div></div>
<div class="ttc" id="aclassDbcDiagnosticError_html_ab3965082f01d66b6d5c20525af44235d"><div class="ttname"><a href="classDbcDiagnosticError.html#ab3965082f01d66b6d5c20525af44235d">DbcDiagnosticError::diagnostic</a></div><div class="ttdeci">DbcDiagnostic diagnostic</div><div class="ttdef"><b>Definition</b> <a href="dbc__statement__handler_8h_source.html#l00040">dbc_statement_handler.h:40</a></div></div>
<div class="ttc" id="aclassDbcParser_html_a0e915ce79c2e3d4c95a5aaf2bf0409bc"><div class="ttname"><a href="classDbcParser.html#a0e915ce79c2e3d4c95a5aaf2bf0409bc">DbcParser::ParseFileWithDiagnostics</a></div><div class="ttdeci">DbcParseResult ParseFileWithDiagnostics(const std::string &amp;filePath) const</div><div class="ttdoc">Parse with warnings and a structured first error instead of throwing.</div><div class="ttdef"><b>Definition</b> <a href="dbc__parser_8cpp_source.html#l00074">dbc_parser.cpp:74</a></div></div>
<div class="ttc" id="aclassDbcParser_html_aef72826942c9095d653fafa435855e56"><div class="ttname"><a href="classDbcParser.html#aef72826942c9095d653fafa435855e56">DbcParser::ParseFile</a></div><div class="ttdeci">DbcDatabase ParseFile(const std::string &amp;filePath) const</div><div class="ttdoc">Parse DBC file.</div><div class="ttdef"><b>Definition</b> <a href="dbc__parser_8cpp_source.html#l00061">dbc_parser.cpp:61</a></div></div>
<div class="ttc" id="aclassDbcStatementDispatcher_html"><div class="ttname"><a href="classDbcStatementDispatcher.html">DbcStatementDispatcher</a></div><div class="ttdef"><b>Definition</b> <a href="dbc__statement__handler_8h_source.html#l00130">dbc_statement_handler.h:130</a></div></div>
<div class="ttc" id="aclassDbcStatementDispatcher_html_a495c2d5c7ebb8103b1987cdd87c142ed"><div class="ttname"><a href="classDbcStatementDispatcher.html#a495c2d5c7ebb8103b1987cdd87c142ed">DbcStatementDispatcher::Dispatch</a></div><div class="ttdeci">bool Dispatch(const std::string &amp;line, DbcParseContext &amp;context) const</div><div class="ttdef"><b>Definition</b> <a href="dbc__statement__handler_8cpp_source.html#l00390">dbc_statement_handler.cpp:390</a></div></div>
<div class="ttc" id="adbc__parser_8h_html"><div class="ttname"><a href="dbc__parser_8h.html">dbc_parser.h</a></div><div class="ttdoc">DBC file parser and interpretation options.</div></div>
<div class="ttc" id="astructDbcDatabase_html"><div class="ttname"><a href="structDbcDatabase.html">DbcDatabase</a></div><div class="ttdoc">Parsed DBC content stored in a simple internal form.</div><div class="ttdef"><b>Definition</b> <a href="dbc__database_8h_source.html#l00022">dbc_database.h:22</a></div></div>
<div class="ttc" id="astructDbcDiagnostic_html"><div class="ttname"><a href="structDbcDiagnostic.html">DbcDiagnostic</a></div><div class="ttdef"><b>Definition</b> <a href="dbc__diagnostic_8h_source.html#l00025">dbc_diagnostic.h:25</a></div></div>
<div class="ttc" id="astructDbcParseContext_html"><div class="ttname"><a href="structDbcParseContext.html">DbcParseContext</a></div><div class="ttdef"><b>Definition</b> <a href="dbc__statement__handler_8h_source.html#l00032">dbc_statement_handler.h:32</a></div></div>
<div class="ttc" id="astructDbcParseResult_html"><div class="ttname"><a href="structDbcParseResult.html">DbcParseResult</a></div><div class="ttdef"><b>Definition</b> <a href="dbc__diagnostic_8h_source.html#l00033">dbc_diagnostic.h:33</a></div></div>
<div class="ttc" id="astructDbcDiagnostic_html"><div class="ttname"><a href="structDbcDiagnostic.html">DbcDiagnostic</a></div><div class="ttdoc">Diagnostic message and physical source location.</div><div class="ttdef"><b>Definition</b> <a href="dbc__diagnostic_8h_source.html#l00029">dbc_diagnostic.h:29</a></div></div>
<div class="ttc" id="astructDbcParseContext_html"><div class="ttname"><a href="structDbcParseContext.html">DbcParseContext</a></div><div class="ttdef"><b>Definition</b> <a href="dbc__statement__handler_8h_source.html#l00050">dbc_statement_handler.h:50</a></div></div>
<div class="ttc" id="astructDbcParseResult_html"><div class="ttname"><a href="structDbcParseResult.html">DbcParseResult</a></div><div class="ttdoc">Parsed database and diagnostics; the database is empty on error.</div><div class="ttdef"><b>Definition</b> <a href="dbc__diagnostic_8h_source.html#l00038">dbc_diagnostic.h:38</a></div></div>
<div class="ttc" id="astructDbcParseResult_html_a3a1987b4381bb1e0a34dc09e31483679"><div class="ttname"><a href="structDbcParseResult.html#a3a1987b4381bb1e0a34dc09e31483679">DbcParseResult::diagnostics</a></div><div class="ttdeci">std::vector&lt; DbcDiagnostic &gt; diagnostics</div><div class="ttdef"><b>Definition</b> <a href="dbc__diagnostic_8h_source.html#l00040">dbc_diagnostic.h:40</a></div></div>
<div class="ttc" id="astructDbcParseResult_html_abfa765d29a4397e8ddaf771bae21993e"><div class="ttname"><a href="structDbcParseResult.html#abfa765d29a4397e8ddaf771bae21993e">DbcParseResult::database</a></div><div class="ttdeci">DbcDatabase database</div><div class="ttdef"><b>Definition</b> <a href="dbc__diagnostic_8h_source.html#l00039">dbc_diagnostic.h:39</a></div></div>
<div class="ttc" id="astructDbcParserOptions_html_ab31534f5c0853461b46cbb38149c33f9"><div class="ttname"><a href="structDbcParserOptions.html#ab31534f5c0853461b46cbb38149c33f9">DbcParserOptions::enableJ1939</a></div><div class="ttdeci">bool enableJ1939</div><div class="ttdef"><b>Definition</b> <a href="dbc__parser_8h_source.html#l00021">dbc_parser.h:21</a></div></div>
</div><!-- fragment --></div><!-- contents -->
</div><!-- doc-content -->
<!-- start footer part -->