CBMC
require_goto_statements.h
Go to the documentation of this file.
1 /*******************************************************************\
2 
3 Module: Unit test utilities
4 
5 Author: Diffblue Ltd.
6 
7 \*******************************************************************/
8 
11 
13 
14 #include <util/optional.h>
15 
16 #include <regex>
17 
18 class symbol_tablet;
19 
20 #ifndef CPROVER_JAVA_TESTING_UTILS_REQUIRE_GOTO_STATEMENTS_H
21 #define CPROVER_JAVA_TESTING_UTILS_REQUIRE_GOTO_STATEMENTS_H
22 
23 // NOLINTNEXTLINE(readability/namespace)
25 {
27 {
29  std::vector<code_assignt> non_null_assignments;
30 };
31 
32 class no_decl_found_exceptiont : public std::exception
33 {
34 public:
35  explicit no_decl_found_exceptiont(const std::string &var_name)
36  : message{"Failed to find declaration for: " + var_name}
37  {
38  }
39 
40  virtual const char *what() const throw()
41  {
42  return message.c_str();
43  }
44 
45 private:
46  std::string message;
47 };
48 
50  const std::vector<codet> &statements,
51  const irep_idt &structure_name,
52  const optionalt<irep_idt> &superclass_name,
53  const irep_idt &component_name,
54  const symbol_tablet &symbol_table);
55 
57  const std::vector<codet> &statements,
58  const irep_idt &component_name);
59 
60 std::vector<codet> get_all_statements(const exprt &function_value);
61 
62 const std::vector<codet>
64 
66  const irep_idt &pointer_name,
67  const std::vector<codet> &instructions);
68 
70  const std::regex &pointer_name_match,
71  const std::vector<codet> &instructions);
72 
74  const irep_idt &variable_name,
75  const std::vector<codet> &entry_point_instructions);
76 
78  const irep_idt &structure_name,
79  const optionalt<irep_idt> &superclass_name,
80  const irep_idt &component_name,
81  const irep_idt &component_type_name,
82  const optionalt<irep_idt> &typecast_name,
83  const std::vector<codet> &entry_point_instructions,
84  const symbol_tablet &symbol_table);
85 
87  const irep_idt &structure_name,
88  const optionalt<irep_idt> &superclass_name,
89  const irep_idt &array_component_name,
90  const irep_idt &array_type_name,
91  const std::vector<codet> &entry_point_instructions,
92  const symbol_tablet &symbol_table);
93 
95  const irep_idt &argument_name,
96  const std::vector<codet> &entry_point_statements);
97 
98 std::vector<code_function_callt> find_function_calls(
99  const std::vector<codet> &statements,
100  const irep_idt &function_call_identifier);
101 }
102 
103 #endif // CPROVER_JAVA_TESTING_UTILS_REQUIRE_GOTO_STATEMENTS_H
dstringt
dstringt has one field, an unsigned integer no which is an index into a static table of strings.
Definition: dstring.h:36
symbol_tablet
The symbol table.
Definition: symbol_table.h:13
goto_instruction_code.h
require_goto_statements::require_entry_point_statements
const std::vector< codet > require_entry_point_statements(const symbol_tablet &symbol_table)
Definition: require_goto_statements.cpp:48
require_goto_statements::find_this_component_assignment
pointer_assignment_locationt find_this_component_assignment(const std::vector< codet > &statements, const irep_idt &component_name)
Find assignment statements that set this->{component_name}.
Definition: require_goto_statements.cpp:168
optional.h
code_declt
A goto_instruction_codet representing the declaration of a local variable.
Definition: goto_instruction_code.h:204
require_goto_statements::pointer_assignment_locationt::non_null_assignments
std::vector< code_assignt > non_null_assignments
Definition: require_goto_statements.h:29
exprt
Base class for all expressions.
Definition: expr.h:55
require_goto_statements
Definition: require_goto_statements.h:24
require_goto_statements::require_declaration_of_name
const code_declt & require_declaration_of_name(const irep_idt &variable_name, const std::vector< codet > &entry_point_instructions)
Find the declaration of the specific variable.
Definition: require_goto_statements.cpp:285
require_goto_statements::no_decl_found_exceptiont::no_decl_found_exceptiont
no_decl_found_exceptiont(const std::string &var_name)
Definition: require_goto_statements.h:35
require_goto_statements::get_all_statements
std::vector< codet > get_all_statements(const exprt &function_value)
Expand value of a function to include all child codets.
Definition: require_goto_statements.cpp:29
require_goto_statements::require_entry_point_argument_assignment
const irep_idt & require_entry_point_argument_assignment(const irep_idt &argument_name, const std::vector< codet > &entry_point_statements)
Checks that the input argument (of method under test) with given name is assigned a single non-null o...
Definition: require_goto_statements.cpp:518
require_goto_statements::find_function_calls
std::vector< code_function_callt > find_function_calls(const std::vector< codet > &statements, const irep_idt &function_call_identifier)
Verify that a collection of statements contains a function call to a function whose symbol identifier...
Definition: require_goto_statements.cpp:550
require_goto_statements::pointer_assignment_locationt
Definition: require_goto_statements.h:26
optionalt
nonstd::optional< T > optionalt
Definition: optional.h:35
require_goto_statements::pointer_assignment_locationt::null_assignment
optionalt< code_assignt > null_assignment
Definition: require_goto_statements.h:28
require_goto_statements::find_pointer_assignments
pointer_assignment_locationt find_pointer_assignments(const irep_idt &pointer_name, const std::vector< codet > &instructions)
For a given variable name, gets the assignments to it in the provided instructions.
Definition: require_goto_statements.cpp:219
require_goto_statements::no_decl_found_exceptiont::what
virtual const char * what() const
Definition: require_goto_statements.h:40
require_goto_statements::no_decl_found_exceptiont::message
std::string message
Definition: require_goto_statements.h:46
require_goto_statements::require_struct_component_assignment
const irep_idt & require_struct_component_assignment(const irep_idt &structure_name, const optionalt< irep_idt > &superclass_name, const irep_idt &component_name, const irep_idt &component_type_name, const optionalt< irep_idt > &typecast_name, const std::vector< codet > &entry_point_instructions, const symbol_tablet &symbol_table)
Checks that the component of the structure (possibly inherited from the superclass) is assigned an ob...
Definition: require_goto_statements.cpp:384
require_goto_statements::no_decl_found_exceptiont
Definition: require_goto_statements.h:32
require_goto_statements::require_struct_array_component_assignment
const irep_idt & require_struct_array_component_assignment(const irep_idt &structure_name, const optionalt< irep_idt > &superclass_name, const irep_idt &array_component_name, const irep_idt &array_type_name, const std::vector< codet > &entry_point_instructions, const symbol_tablet &symbol_table)
Checks that the array component of the structure (possibly inherited from the superclass) is assigned...
Definition: require_goto_statements.cpp:446
require_goto_statements::find_struct_component_assignments
pointer_assignment_locationt find_struct_component_assignments(const std::vector< codet > &statements, const irep_idt &structure_name, const optionalt< irep_idt > &superclass_name, const irep_idt &component_name, const symbol_tablet &symbol_table)
Find assignment statements of the form:
Definition: require_goto_statements.cpp:71