User Guide
unary_operator.hpp
Go to the documentation of this file.
1 /*
2  * Copyright 2023 Blue Brain Project, EPFL.
3  * See the top-level LICENSE file for details.
4  *
5  * SPDX-License-Identifier: Apache-2.0
6  */
7 
8 ///
9 /// THIS FILE IS GENERATED AT BUILD TIME AND SHALL NOT BE EDITED.
10 ///
11 
12 #pragma once
13 
14 /**
15  * \dir
16  * \brief Auto generated AST Implementations
17  *
18  * \file
19  * \brief Auto generated AST classes declaration
20  */
21 
22 #include "ast/ast_decl.hpp"
23 #include "ast/expression.hpp"
24 
25 namespace nmodl::ast {
26 
27 /**
28  * \addtogroup ast_class
29  * \ingroup ast
30  * \{
31  */
32 
33 /**
34  * \brief TODO
35  *
36  *
37 */
38 class UnaryOperator : public Expression {
39  private:
40  /// TODO
42  /// token with location information
43  std::shared_ptr<ModToken> token;
44 
45  public:
46  /// \name Ctor & dtor
47  /// \{
48  explicit UnaryOperator(UnaryOp value);
49  UnaryOperator(const UnaryOperator& obj);
50  UnaryOperator() = default;
51  virtual ~UnaryOperator() = default;
52  /// \}
53 
54  /**
55  * \brief Check if the ast node is an instance of ast::UnaryOperator
56  * \return true as object is of type ast::UnaryOperator
57  */
58  bool is_unary_operator () const noexcept override {
59  return true;
60  }
61 
62  /**
63  * \brief Return a copy of the current node
64  *
65  * Recursively make a new copy/clone of the current node including
66  * all members and return a pointer to the node. This is used for
67  * passes like nmodl::visitor::InlineVisitor where nodes are cloned in the
68  * ast.
69  *
70  * \return pointer to the clone/copy of the current node
71  */
72  // NOLINTBEGIN(clang-analyzer-cplusplus.NewDeleteLeaks)
73  UnaryOperator* clone() const override {
74  return new UnaryOperator(*this);
75  }
76  // NOLINTEND(clang-analyzer-cplusplus.NewDeleteLeaks)
77 
78  /// \name Getters
79  /// \{
80 
81  /**
82  * \brief Return type (ast::AstNodeType) of ast node
83  *
84  * Every node in the ast has a type defined in ast::AstNodeType and this
85  * function is used to retrieve the same.
86  *
87  * \return ast node type i.e. ast::AstNodeType::UNARY_OPERATOR
88  *
89  * \sa Ast::get_node_type_name
90  */
91  AstNodeType get_node_type() const noexcept override {
93  }
94 
95  /**
96  * \brief Return type (ast::AstNodeType) of ast node as std::string
97  *
98  * Every node in the ast has a type defined in ast::AstNodeType.
99  * This type name can be returned as a std::string for printing
100  * node to text/json form.
101  *
102  * \return name of the node type as a string i.e. "UnaryOperator"
103  *
104  * \sa Ast::get_node_name
105  */
106  std::string get_node_type_name() const noexcept override {
107  return "UnaryOperator";
108  }
109 
110 
111  /**
112  * \brief Get std::shared_ptr from `this` pointer of the current ast node
113  */
114  std::shared_ptr<Ast> get_shared_ptr() override {
115  return std::static_pointer_cast<UnaryOperator>(shared_from_this());
116  }
117 
118  /**
119  * \brief Get std::shared_ptr from `this` pointer of the current ast node
120  */
121  std::shared_ptr<const Ast> get_shared_ptr() const override {
122  return std::static_pointer_cast<const UnaryOperator>(shared_from_this());
123  }
124 
125  /**
126  * \brief Return associated token for the current ast node
127  *
128  * Not all ast nodes have token information. For example, nmodl::visitor::NeuronSolveVisitor
129  * can insert new nodes in the ast as a solution of ODEs. In this case, we return
130  * nullptr to store in the nmodl::symtab::SymbolTable.
131  *
132  * \return pointer to token if exist otherwise nullptr
133  */
134  const ModToken* get_token() const noexcept override {
135  return token.get();
136  }
137 
138 
139 
140  /**
141  * \brief Getter for member variable \ref UnaryOperator.value
142  */
143  UnaryOp get_value() const noexcept {
144  return value;
145  }
146  /// \}
147 
148  /// \name Setters
149  /// \{
150  /**
151  * \brief Set token for the current ast node
152  */
153  void set_token(const ModToken& tok) { token = std::make_shared<ModToken>(tok); }
154 
155  /**
156  * \brief Setter for member variable \ref UnaryOperator.value
157  */
158  void set_value(UnaryOp value);
159 
160  /// \}
161 
162  /// \name Visitor
163  /// \{
164  /**
165  * \brief visit children i.e. member variables of current node using provided visitor
166  *
167  * Different nodes in the AST have different members (i.e. children). This method
168  * recursively visits children using provided visitor.
169  *
170  * \param v Concrete visitor that will be used to recursively visit children
171  *
172  * \sa Ast::visit_children for example.
173  */
174  void visit_children(visitor::Visitor& v) override;
175 
176  /**
177  * \brief visit children i.e. member variables of current node using provided visitor
178  *
179  * Different nodes in the AST have different members (i.e. children). This method
180  * recursively visits children using provided visitor.
181  *
182  * \param v Concrete constant visitor that will be used to recursively visit children
183  *
184  * \sa Ast::visit_children for example.
185  */
186  void visit_children(visitor::ConstVisitor& v) const override;
187 
188  /**
189  * \brief accept (or visit) the current AST node using provided visitor
190  *
191  * Instead of visiting children of AST node, like Ast::visit_children,
192  * accept allows to visit the current node itself using provided concrete
193  * visitor.
194  *
195  * \param v Concrete visitor that will be used to recursively visit node
196  *
197  * \sa Ast::accept for example.
198  */
199  void accept(visitor::Visitor& v) override;
200 
201  /**
202  * \copydoc accept(visitor::Visitor&)
203  */
204  void accept(visitor::ConstVisitor& v) const override;
205  /// \}
206 
207  /**
208  * \brief Return enum value in string form
209  *
210  * Enum variables (e.g. ast::BinaryOp, ast::UnitStateType) have
211  * string representation when they are converted from AST back to
212  * NMODL. This method is used to return corresponding string representation.
213  */
214  std::string eval() const {
215  return UnaryOpNames[value];
216  }
217 
218  private:
219  /**
220  * \brief Set this object as parent for all the children
221  *
222  * This should be called in every object (with children) constructor
223  * to set parents. Since it is called only in the constructors it
224  * should not be virtual to avoid ambiguities (issue #295).
225  */
226  void set_parent_in_children();
227 };
228 
229 /** \} */ // end of ast_class
230 
231 
232 
233 } // namespace nmodl::ast
nmodl::visitor::ConstVisitor
Abstract base class for all constant visitors implementation.
Definition: visitor.hpp:298
nmodl::ast::UnaryOperator
TODO.
Definition: unary_operator.hpp:38
nmodl::ast::UnaryOp
UnaryOp
enum type for unary operators
Definition: ast_common.hpp:74
nmodl::ast::UnaryOperator::UnaryOperator
UnaryOperator()=default
ast_decl.hpp
THIS FILE IS GENERATED AT BUILD TIME AND SHALL NOT BE EDITED.
nmodl::ast::UnaryOperator::set_parent_in_children
void set_parent_in_children()
Set this object as parent for all the children.
Definition: ast.cpp:6333
nmodl::ast::UnaryOperator::~UnaryOperator
virtual ~UnaryOperator()=default
nmodl::ast
Abstract Syntax Tree (AST) related implementations.
Definition: ast_common.hpp:29
nmodl::ast::AstNodeType
AstNodeType
Enum type for every AST node type.
Definition: ast_decl.hpp:164
nmodl::ast::UnaryOperator::get_node_type
AstNodeType get_node_type() const noexcept override
Return type (ast::AstNodeType) of ast node.
Definition: unary_operator.hpp:91
nmodl::ast::UnaryOperator::get_token
const ModToken * get_token() const noexcept override
Return associated token for the current ast node.
Definition: unary_operator.hpp:134
nmodl::ast::UnaryOperator::get_value
UnaryOp get_value() const noexcept
Getter for member variable UnaryOperator::value.
Definition: unary_operator.hpp:143
nmodl::visitor::Visitor
Abstract base class for all visitors implementation.
Definition: visitor.hpp:39
nmodl::ast::UnaryOperator::visit_children
void visit_children(visitor::Visitor &v) override
visit children i.e.
Definition: ast.cpp:6297
nmodl::ast::UnaryOperator::get_shared_ptr
std::shared_ptr< const Ast > get_shared_ptr() const override
Get std::shared_ptr from this pointer of the current ast node.
Definition: unary_operator.hpp:121
nmodl::ast::UnaryOperator::clone
UnaryOperator * clone() const override
Return a copy of the current node.
Definition: unary_operator.hpp:73
nmodl::ast::UnaryOperator::accept
void accept(visitor::Visitor &v) override
accept (or visit) the current AST node using provided visitor
Definition: ast.cpp:6303
nmodl::ast::UnaryOperator::eval
std::string eval() const
Return enum value in string form.
Definition: unary_operator.hpp:214
nmodl::ast::AstNodeType::UNARY_OPERATOR
@ UNARY_OPERATOR
type of ast::UnaryOperator
nmodl::ast::UnaryOperator::value
UnaryOp value
TODO.
Definition: unary_operator.hpp:41
nmodl::ast::UnaryOperator::set_value
void set_value(UnaryOp value)
Setter for member variable UnaryOperator::value.
Definition: ast.cpp:6340
nmodl::ast::UnaryOperator::get_shared_ptr
std::shared_ptr< Ast > get_shared_ptr() override
Get std::shared_ptr from this pointer of the current ast node.
Definition: unary_operator.hpp:114
nmodl::ast::UnaryOperator::token
std::shared_ptr< ModToken > token
token with location information
Definition: unary_operator.hpp:43
nmodl::ast::UnaryOperator::is_unary_operator
bool is_unary_operator() const noexcept override
Check if the ast node is an instance of ast::UnaryOperator.
Definition: unary_operator.hpp:58
nmodl::ast::UnaryOperator::set_token
void set_token(const ModToken &tok)
Set token for the current ast node.
Definition: unary_operator.hpp:153
expression.hpp
Auto generated AST classes declaration.
nmodl::ast::Expression
Base class for all expressions in the NMODL.
Definition: expression.hpp:43
nmodl::ast::UnaryOpNames
static const std::string UnaryOpNames[]
string representation of ast::UnaryOp
Definition: ast_common.hpp:77
nmodl::ModToken
Represent token returned by scanner.
Definition: modtoken.hpp:50
nmodl::ast::UnaryOperator::get_node_type_name
std::string get_node_type_name() const noexcept override
Return type (ast::AstNodeType) of ast node as std::string.
Definition: unary_operator.hpp:106