CBMC
cover_basic_blocks.h
Go to the documentation of this file.
1 /*******************************************************************\
2 
3 Module: Coverage Instrumentation
4 
5 Author: Daniel Kroening
6 
7 \*******************************************************************/
8 
11 
12 #ifndef CPROVER_GOTO_INSTRUMENT_COVER_BASIC_BLOCKS_H
13 #define CPROVER_GOTO_INSTRUMENT_COVER_BASIC_BLOCKS_H
14 
15 #include <unordered_set>
16 
17 #include <util/optional.h>
18 
20 
21 #include "source_lines.h"
22 
23 class message_handlert;
24 
26 {
27 public:
28  virtual ~cover_blocks_baset() = default;
31  // part of
32  virtual std::size_t block_of(goto_programt::const_targett t) const = 0;
33 
38  instruction_of(std::size_t block_nr) const = 0;
39 
43  virtual const source_locationt &
44  source_location_of(std::size_t block_nr) const = 0;
45 
48  virtual const source_linest &source_lines_of(std::size_t block_nr) const = 0;
49 
51  virtual void output(std::ostream &out) const = 0;
52 
57  virtual void report_block_anomalies(
58  const irep_idt &function_id,
59  const goto_programt &goto_program,
60  message_handlert &message_handler)
61  {
62  // unused parameters
63  (void)function_id;
64  (void)goto_program;
65  (void)message_handler;
66  }
67 };
68 
70 {
71 public:
72  explicit cover_basic_blockst(const goto_programt &goto_program);
73 
77  std::size_t block_of(goto_programt::const_targett t) const override;
78 
83  instruction_of(std::size_t block_nr) const override;
84 
88  const source_locationt &
89  source_location_of(std::size_t block_nr) const override;
90 
93  const source_linest &source_lines_of(std::size_t block_nr) const override;
94 
100  const irep_idt &function_id,
101  const goto_programt &goto_program,
102  message_handlert &message_handler) override;
103 
105  void output(std::ostream &out) const override;
106 
107 private:
108  typedef std::map<goto_programt::const_targett, std::size_t> block_mapt;
109 
110  struct block_infot
111  {
114 
119 
122  };
123 
127  std::vector<block_infot> block_infos;
128 
130  static void add_block_lines(
132  const goto_programt::instructiont &instruction);
133 
137  const goto_programt::const_targett &instruction,
139 };
140 
142 {
143 private:
144  // map block number to first instruction of the block
145  std::vector<goto_programt::const_targett> block_infos;
146  // map block number to its location
147  std::vector<source_locationt> block_locations;
148  // map java indexes to block indexes
149  std::unordered_map<irep_idt, std::size_t> index_to_block;
150  // map block number to its source lines
151  std::vector<source_linest> block_source_lines;
152 
153 public:
154  explicit cover_basic_blocks_javat(const goto_programt &_goto_program);
155 
158  std::size_t block_of(goto_programt::const_targett t) const override;
159 
163  instruction_of(std::size_t block_number) const override;
164 
167  const source_locationt &
168  source_location_of(std::size_t block_number) const override;
169 
172  const source_linest &source_lines_of(std::size_t block_number) const override;
173 
175  void output(std::ostream &out) const override;
176 };
177 
178 #endif // CPROVER_GOTO_INSTRUMENT_COVER_BASIC_BLOCKS_H
cover_basic_blockst::instruction_of
optionalt< goto_programt::const_targett > instruction_of(std::size_t block_nr) const override
Definition: cover_basic_blocks.cpp:93
dstringt
dstringt has one field, an unsigned integer no which is an index into a static table of strings.
Definition: dstring.h:36
cover_basic_blocks_javat::index_to_block
std::unordered_map< irep_idt, std::size_t > index_to_block
Definition: cover_basic_blocks.h:149
cover_blocks_baset::source_location_of
virtual const source_locationt & source_location_of(std::size_t block_nr) const =0
optional.h
cover_basic_blockst::add_block_lines
static void add_block_lines(cover_basic_blockst::block_infot &block, const goto_programt::instructiont &instruction)
Adds the lines which instruction spans to block.
Definition: cover_basic_blocks.cpp:154
cover_basic_blocks_javat::cover_basic_blocks_javat
cover_basic_blocks_javat(const goto_programt &_goto_program)
Definition: cover_basic_blocks.cpp:173
cover_basic_blockst::block_infot::source_location
source_locationt source_location
the source location representative for this block (we need a separate copy of source locations becaus...
Definition: cover_basic_blocks.h:118
cover_blocks_baset::output
virtual void output(std::ostream &out) const =0
Outputs the list of blocks.
cover_basic_blocks_javat::block_source_lines
std::vector< source_linest > block_source_lines
Definition: cover_basic_blocks.h:151
cover_basic_blockst::report_block_anomalies
void report_block_anomalies(const irep_idt &function_id, const goto_programt &goto_program, message_handlert &message_handler) override
Output warnings about ignored blocks.
Definition: cover_basic_blocks.cpp:113
cover_basic_blockst::block_infot::source_lines
source_linest source_lines
the set of source code lines belonging to this block
Definition: cover_basic_blocks.h:121
cover_basic_blockst::block_of
std::size_t block_of(goto_programt::const_targett t) const override
Definition: cover_basic_blocks.cpp:85
source_linest
Definition: source_lines.h:32
cover_basic_blocks_javat
Definition: cover_basic_blocks.h:141
cover_basic_blockst::block_map
block_mapt block_map
map program locations to block numbers
Definition: cover_basic_blocks.h:125
cover_blocks_baset::source_lines_of
virtual const source_linest & source_lines_of(std::size_t block_nr) const =0
cover_basic_blockst::source_lines_of
const source_linest & source_lines_of(std::size_t block_nr) const override
Definition: cover_basic_blocks.cpp:107
cover_basic_blockst::continuation_of_block
static optionalt< std::size_t > continuation_of_block(const goto_programt::const_targett &instruction, block_mapt &block_map)
If this block is a continuation of a previous block through unconditional forward gotos,...
Definition: cover_basic_blocks.cpp:16
cover_basic_blockst::block_infos
std::vector< block_infot > block_infos
map block numbers to block information
Definition: cover_basic_blocks.h:127
source_lines.h
cover_blocks_baset::instruction_of
virtual optionalt< goto_programt::const_targett > instruction_of(std::size_t block_nr) const =0
cover_basic_blockst::source_location_of
const source_locationt & source_location_of(std::size_t block_nr) const override
Definition: cover_basic_blocks.cpp:100
cover_blocks_baset
Definition: cover_basic_blocks.h:25
cover_basic_blocks_javat::block_of
std::size_t block_of(goto_programt::const_targett t) const override
Definition: cover_basic_blocks.cpp:195
cover_basic_blocks_javat::block_locations
std::vector< source_locationt > block_locations
Definition: cover_basic_blocks.h:147
message_handlert
Definition: message.h:27
cover_basic_blocks_javat::source_lines_of
const source_linest & source_lines_of(std::size_t block_number) const override
Definition: cover_basic_blocks.cpp:218
cover_basic_blocks_javat::block_infos
std::vector< goto_programt::const_targett > block_infos
Definition: cover_basic_blocks.h:145
cover_blocks_baset::report_block_anomalies
virtual void report_block_anomalies(const irep_idt &function_id, const goto_programt &goto_program, message_handlert &message_handler)
Output warnings about ignored blocks.
Definition: cover_basic_blocks.h:57
optionalt
nonstd::optional< T > optionalt
Definition: optional.h:35
goto_program.h
source_locationt
Definition: source_location.h:18
cover_basic_blocks_javat::source_location_of
const source_locationt & source_location_of(std::size_t block_number) const override
Definition: cover_basic_blocks.cpp:211
cover_basic_blockst
Definition: cover_basic_blocks.h:69
cover_basic_blocks_javat::instruction_of
optionalt< goto_programt::const_targett > instruction_of(std::size_t block_number) const override
Definition: cover_basic_blocks.cpp:204
cover_basic_blockst::block_mapt
std::map< goto_programt::const_targett, std::size_t > block_mapt
Definition: cover_basic_blocks.h:108
cover_basic_blocks_javat::output
void output(std::ostream &out) const override
Outputs the list of blocks.
Definition: cover_basic_blocks.cpp:224
cover_basic_blockst::output
void output(std::ostream &out) const override
Outputs the list of blocks.
Definition: cover_basic_blocks.cpp:147
goto_programt
A generic container class for the GOTO intermediate representation of one function.
Definition: goto_program.h:72
cover_blocks_baset::~cover_blocks_baset
virtual ~cover_blocks_baset()=default
goto_programt::const_targett
instructionst::const_iterator const_targett
Definition: goto_program.h:587
goto_programt::instructiont
This class represents an instruction in the GOTO intermediate representation.
Definition: goto_program.h:180
cover_blocks_baset::block_of
virtual std::size_t block_of(goto_programt::const_targett t) const =0
cover_basic_blockst::block_infot::representative_inst
optionalt< goto_programt::const_targett > representative_inst
the program location to instrument for this block
Definition: cover_basic_blocks.h:113
cover_basic_blockst::block_infot
Definition: cover_basic_blocks.h:110
cover_basic_blockst::cover_basic_blockst
cover_basic_blockst(const goto_programt &goto_program)
Definition: cover_basic_blocks.cpp:32