218 lines
17 KiB
HTML
218 lines
17 KiB
HTML
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
|
|
<html lang="en">
|
|
|
|
<head>
|
|
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
|
|
<title>LCOV - coverage.info - core/tree_node.h</title>
|
|
<link rel="stylesheet" type="text/css" href="../gcov.css">
|
|
</head>
|
|
|
|
<body>
|
|
|
|
<table width="100%" border=0 cellspacing=0 cellpadding=0>
|
|
<tr><td class="title">LCOV - code coverage report</td></tr>
|
|
<tr><td class="ruler"><img src="../glass.png" width=3 height=3 alt=""></td></tr>
|
|
|
|
<tr>
|
|
<td width="100%">
|
|
<table cellpadding=1 border=0 width="100%">
|
|
<tr>
|
|
<td width="10%" class="headerItem">Current view:</td>
|
|
<td width="10%" class="headerValue"><a href="../index.html" title="Click to go to top-level">top level</a> - <a href="index.html" title="Click to go to directory core">core</a> - tree_node.h<span style="font-size: 80%;"> (source / <a href="tree_node.h.func-c.html" title="Click to go to function table">functions</a>)</span></td>
|
|
<td width="5%"></td>
|
|
<td width="5%"></td>
|
|
<td width="5%" class="headerCovTableHead">Coverage</td>
|
|
<td width="5%" class="headerCovTableHead" title="Covered + Uncovered code">Total</td>
|
|
<td width="5%" class="headerCovTableHead" title="Exercised code only">Hit</td>
|
|
</tr>
|
|
<tr>
|
|
<td class="headerItem">Test:</td>
|
|
<td class="headerValue">coverage.info</td>
|
|
<td></td>
|
|
<td class="headerItem">Lines:</td>
|
|
<td class="headerCovTableEntryHi">100.0 %</td>
|
|
<td class="headerCovTableEntry">1</td>
|
|
<td class="headerCovTableEntry">1</td>
|
|
</tr>
|
|
<tr>
|
|
<td class="headerItem">Test Date:</td>
|
|
<td class="headerValue">2026-10-20 13:34:58</td>
|
|
<td></td>
|
|
<td class="headerItem">Functions:</td>
|
|
<td class="headerCovTableEntryHi">100.0 %</td>
|
|
<td class="headerCovTableEntry">1</td>
|
|
<td class="headerCovTableEntry">1</td>
|
|
</tr>
|
|
<tr><td><img src="../glass.png" width=3 height=3 alt=""></td></tr>
|
|
</table>
|
|
</td>
|
|
</tr>
|
|
|
|
<tr><td class="ruler"><img src="../glass.png" width=3 height=3 alt=""></td></tr>
|
|
</table>
|
|
|
|
<table cellpadding=0 cellspacing=0 border=0>
|
|
<tr>
|
|
<td><br></td>
|
|
</tr>
|
|
<tr>
|
|
<td>
|
|
<pre class="sourceHeading"> Line data Source code</pre>
|
|
<pre class="source">
|
|
<span id="L1"><span class="lineNum"> 1</span> : /**</span>
|
|
<span id="L2"><span class="lineNum"> 2</span> : * @file tree_node.h</span>
|
|
<span id="L3"><span class="lineNum"> 3</span> : * @brief Qt-independent metadata tree nodes.</span>
|
|
<span id="L4"><span class="lineNum"> 4</span> : *</span>
|
|
<span id="L5"><span class="lineNum"> 5</span> : * Created: 2026-03-13</span>
|
|
<span id="L6"><span class="lineNum"> 6</span> : * Author: Deeaitch (Dim. Himro)</span>
|
|
<span id="L7"><span class="lineNum"> 7</span> : *</span>
|
|
<span id="L8"><span class="lineNum"> 8</span> : * Licensed under the MIT License.</span>
|
|
<span id="L9"><span class="lineNum"> 9</span> : * See LICENSE file in the project root for full license text.</span>
|
|
<span id="L10"><span class="lineNum"> 10</span> : */</span>
|
|
<span id="L11"><span class="lineNum"> 11</span> : </span>
|
|
<span id="L12"><span class="lineNum"> 12</span> : #ifndef TREE_NODE_H</span>
|
|
<span id="L13"><span class="lineNum"> 13</span> : #define TREE_NODE_H</span>
|
|
<span id="L14"><span class="lineNum"> 14</span> : </span>
|
|
<span id="L15"><span class="lineNum"> 15</span> : #include <cstddef></span>
|
|
<span id="L16"><span class="lineNum"> 16</span> : #include <memory></span>
|
|
<span id="L17"><span class="lineNum"> 17</span> : #include <optional></span>
|
|
<span id="L18"><span class="lineNum"> 18</span> : #include <string></span>
|
|
<span id="L19"><span class="lineNum"> 19</span> : #include <vector></span>
|
|
<span id="L20"><span class="lineNum"> 20</span> : </span>
|
|
<span id="L21"><span class="lineNum"> 21</span> : #include "definition_key.h"</span>
|
|
<span id="L22"><span class="lineNum"> 22</span> : #include "frame_info.h"</span>
|
|
<span id="L23"><span class="lineNum"> 23</span> : #include "signal_info.h"</span>
|
|
<span id="L24"><span class="lineNum"> 24</span> : </span>
|
|
<span id="L25"><span class="lineNum"> 25</span> : /**</span>
|
|
<span id="L26"><span class="lineNum"> 26</span> : * @brief Type of a tree node.</span>
|
|
<span id="L27"><span class="lineNum"> 27</span> : */</span>
|
|
<span id="L28"><span class="lineNum"> 28</span> : enum class NodeType {</span>
|
|
<span id="L29"><span class="lineNum"> 29</span> : Root,</span>
|
|
<span id="L30"><span class="lineNum"> 30</span> : Frame,</span>
|
|
<span id="L31"><span class="lineNum"> 31</span> : Signal</span>
|
|
<span id="L32"><span class="lineNum"> 32</span> : };</span>
|
|
<span id="L33"><span class="lineNum"> 33</span> : </span>
|
|
<span id="L34"><span class="lineNum"> 34</span> : /**</span>
|
|
<span id="L35"><span class="lineNum"> 35</span> : * @brief Tree node for later use in model/view or other hierarchy consumers.</span>
|
|
<span id="L36"><span class="lineNum"> 36</span> : */</span>
|
|
<span id="L37"><span class="lineNum"> 37</span> : class TreeNode {</span>
|
|
<span id="L38"><span class="lineNum"> 38</span> : public:</span>
|
|
<span id="L39"><span class="lineNum"> 39</span> : /**</span>
|
|
<span id="L40"><span class="lineNum"> 40</span> : * @brief Create root node.</span>
|
|
<span id="L41"><span class="lineNum"> 41</span> : */</span>
|
|
<span id="L42"><span class="lineNum"> 42</span> : TreeNode();</span>
|
|
<span id="L43"><span class="lineNum"> 43</span> : </span>
|
|
<span id="L44"><span class="lineNum"> 44</span> : /**</span>
|
|
<span id="L45"><span class="lineNum"> 45</span> : * @brief Create frame node.</span>
|
|
<span id="L46"><span class="lineNum"> 46</span> : * @param frame Frame payload.</span>
|
|
<span id="L47"><span class="lineNum"> 47</span> : */</span>
|
|
<span id="L48"><span class="lineNum"> 48</span> : explicit TreeNode(const FrameInfo &frame);</span>
|
|
<span id="L49"><span class="lineNum"> 49</span> : </span>
|
|
<span id="L50"><span class="lineNum"> 50</span> : /**</span>
|
|
<span id="L51"><span class="lineNum"> 51</span> : * @brief Create signal node.</span>
|
|
<span id="L52"><span class="lineNum"> 52</span> : * @param signal Signal payload.</span>
|
|
<span id="L53"><span class="lineNum"> 53</span> : */</span>
|
|
<span id="L54"><span class="lineNum"> 54</span> : explicit TreeNode(const SignalInfo &signal);</span>
|
|
<span id="L55"><span class="lineNum"> 55</span> : </span>
|
|
<span id="L56"><span class="lineNum"> 56</span> <span class="tlaGNC"> 229 : ~TreeNode() = default;</span></span>
|
|
<span id="L57"><span class="lineNum"> 57</span> : </span>
|
|
<span id="L58"><span class="lineNum"> 58</span> : TreeNode(const TreeNode &) = delete;</span>
|
|
<span id="L59"><span class="lineNum"> 59</span> : TreeNode &operator=(const TreeNode &) = delete;</span>
|
|
<span id="L60"><span class="lineNum"> 60</span> : </span>
|
|
<span id="L61"><span class="lineNum"> 61</span> : // Node addresses are stable. Transfer unique_ptr ownership instead of nodes.</span>
|
|
<span id="L62"><span class="lineNum"> 62</span> : TreeNode(TreeNode &&) = delete;</span>
|
|
<span id="L63"><span class="lineNum"> 63</span> : TreeNode &operator=(TreeNode &&) = delete;</span>
|
|
<span id="L64"><span class="lineNum"> 64</span> : </span>
|
|
<span id="L65"><span class="lineNum"> 65</span> : /**</span>
|
|
<span id="L66"><span class="lineNum"> 66</span> : * @brief Add child node.</span>
|
|
<span id="L67"><span class="lineNum"> 67</span> : * @param child Child node to add.</span>
|
|
<span id="L68"><span class="lineNum"> 68</span> : * A null child is ignored. Existing children keep their addresses and rows.</span>
|
|
<span id="L69"><span class="lineNum"> 69</span> : * Ownership must be exclusive; attached nodes cannot be reparented.</span>
|
|
<span id="L70"><span class="lineNum"> 70</span> : * @throws std::invalid_argument for self/ancestor insertion or an attached child.</span>
|
|
<span id="L71"><span class="lineNum"> 71</span> : * Rejected ownership remains with the caller.</span>
|
|
<span id="L72"><span class="lineNum"> 72</span> : */</span>
|
|
<span id="L73"><span class="lineNum"> 73</span> : void AddChild(std::unique_ptr<TreeNode> &&child);</span>
|
|
<span id="L74"><span class="lineNum"> 74</span> : </span>
|
|
<span id="L75"><span class="lineNum"> 75</span> : /** Non-owning parent; nullptr for a detached node or the root. */</span>
|
|
<span id="L76"><span class="lineNum"> 76</span> : const TreeNode *GetParent() const;</span>
|
|
<span id="L77"><span class="lineNum"> 77</span> : </span>
|
|
<span id="L78"><span class="lineNum"> 78</span> : /** Zero-based sibling position; zero for a detached node or the root. */</span>
|
|
<span id="L79"><span class="lineNum"> 79</span> : std::size_t GetRow() const;</span>
|
|
<span id="L80"><span class="lineNum"> 80</span> : </span>
|
|
<span id="L81"><span class="lineNum"> 81</span> : /** Frame identity for frame nodes and signals attached to a frame; otherwise empty. */</span>
|
|
<span id="L82"><span class="lineNum"> 82</span> : std::optional<FrameKey> GetFrameKey() const;</span>
|
|
<span id="L83"><span class="lineNum"> 83</span> : </span>
|
|
<span id="L84"><span class="lineNum"> 84</span> : /** Signal identity (owning frame key and name); empty for other/detached nodes. */</span>
|
|
<span id="L85"><span class="lineNum"> 85</span> : std::optional<SignalKey> GetSignalKey() const;</span>
|
|
<span id="L86"><span class="lineNum"> 86</span> : </span>
|
|
<span id="L87"><span class="lineNum"> 87</span> : /**</span>
|
|
<span id="L88"><span class="lineNum"> 88</span> : * @brief Get child count.</span>
|
|
<span id="L89"><span class="lineNum"> 89</span> : * @return Number of children.</span>
|
|
<span id="L90"><span class="lineNum"> 90</span> : */</span>
|
|
<span id="L91"><span class="lineNum"> 91</span> : std::size_t GetChildCount() const;</span>
|
|
<span id="L92"><span class="lineNum"> 92</span> : </span>
|
|
<span id="L93"><span class="lineNum"> 93</span> : /**</span>
|
|
<span id="L94"><span class="lineNum"> 94</span> : * @brief Get child by index.</span>
|
|
<span id="L95"><span class="lineNum"> 95</span> : * @param index Child index.</span>
|
|
<span id="L96"><span class="lineNum"> 96</span> : * @return Child pointer or nullptr if index is invalid.</span>
|
|
<span id="L97"><span class="lineNum"> 97</span> : */</span>
|
|
<span id="L98"><span class="lineNum"> 98</span> : const TreeNode *GetChild(std::size_t index) const;</span>
|
|
<span id="L99"><span class="lineNum"> 99</span> : </span>
|
|
<span id="L100"><span class="lineNum"> 100</span> : /**</span>
|
|
<span id="L101"><span class="lineNum"> 101</span> : * @brief Get mutable child by index.</span>
|
|
<span id="L102"><span class="lineNum"> 102</span> : * @param index Child index.</span>
|
|
<span id="L103"><span class="lineNum"> 103</span> : * @return Child pointer or nullptr if index is invalid.</span>
|
|
<span id="L104"><span class="lineNum"> 104</span> : */</span>
|
|
<span id="L105"><span class="lineNum"> 105</span> : TreeNode *GetChild(std::size_t index);</span>
|
|
<span id="L106"><span class="lineNum"> 106</span> : </span>
|
|
<span id="L107"><span class="lineNum"> 107</span> : /**</span>
|
|
<span id="L108"><span class="lineNum"> 108</span> : * @brief Get node type.</span>
|
|
<span id="L109"><span class="lineNum"> 109</span> : * @return Node type.</span>
|
|
<span id="L110"><span class="lineNum"> 110</span> : */</span>
|
|
<span id="L111"><span class="lineNum"> 111</span> : NodeType GetType() const;</span>
|
|
<span id="L112"><span class="lineNum"> 112</span> : </span>
|
|
<span id="L113"><span class="lineNum"> 113</span> : /**</span>
|
|
<span id="L114"><span class="lineNum"> 114</span> : * @brief Get display name.</span>
|
|
<span id="L115"><span class="lineNum"> 115</span> : * @return Node name.</span>
|
|
<span id="L116"><span class="lineNum"> 116</span> : */</span>
|
|
<span id="L117"><span class="lineNum"> 117</span> : const std::string &GetName() const;</span>
|
|
<span id="L118"><span class="lineNum"> 118</span> : </span>
|
|
<span id="L119"><span class="lineNum"> 119</span> : /**</span>
|
|
<span id="L120"><span class="lineNum"> 120</span> : * @brief Get frame payload if node is frame.</span>
|
|
<span id="L121"><span class="lineNum"> 121</span> : * @return Pointer to frame info or nullptr.</span>
|
|
<span id="L122"><span class="lineNum"> 122</span> : */</span>
|
|
<span id="L123"><span class="lineNum"> 123</span> : const FrameInfo *GetFrame() const;</span>
|
|
<span id="L124"><span class="lineNum"> 124</span> : </span>
|
|
<span id="L125"><span class="lineNum"> 125</span> : /**</span>
|
|
<span id="L126"><span class="lineNum"> 126</span> : * @brief Get signal payload if node is signal.</span>
|
|
<span id="L127"><span class="lineNum"> 127</span> : * @return Pointer to signal info or nullptr.</span>
|
|
<span id="L128"><span class="lineNum"> 128</span> : */</span>
|
|
<span id="L129"><span class="lineNum"> 129</span> : const SignalInfo *GetSignal() const;</span>
|
|
<span id="L130"><span class="lineNum"> 130</span> : </span>
|
|
<span id="L131"><span class="lineNum"> 131</span> : private:</span>
|
|
<span id="L132"><span class="lineNum"> 132</span> : TreeNode *m_parent = nullptr;</span>
|
|
<span id="L133"><span class="lineNum"> 133</span> : std::size_t m_row = 0U;</span>
|
|
<span id="L134"><span class="lineNum"> 134</span> : NodeType m_type;</span>
|
|
<span id="L135"><span class="lineNum"> 135</span> : std::string m_name;</span>
|
|
<span id="L136"><span class="lineNum"> 136</span> : std::vector<std::unique_ptr<TreeNode>> m_children;</span>
|
|
<span id="L137"><span class="lineNum"> 137</span> : std::unique_ptr<FrameInfo> m_frame;</span>
|
|
<span id="L138"><span class="lineNum"> 138</span> : std::unique_ptr<SignalInfo> m_signal;</span>
|
|
<span id="L139"><span class="lineNum"> 139</span> : };</span>
|
|
<span id="L140"><span class="lineNum"> 140</span> : </span>
|
|
<span id="L141"><span class="lineNum"> 141</span> : #endif /* TREE_NODE_H */</span>
|
|
</pre>
|
|
</td>
|
|
</tr>
|
|
</table>
|
|
<br>
|
|
|
|
<table width="100%" border=0 cellspacing=0 cellpadding=0>
|
|
<tr><td class="ruler"><img src="../glass.png" width=3 height=3 alt=""></td></tr>
|
|
<tr><td class="versionInfo">Generated by: <a href="https://github.com//linux-test-project/lcov" target="_parent">LCOV version 2.0-1</a></td></tr>
|
|
</table>
|
|
<br>
|
|
|
|
</body>
|
|
</html>
|