CBMC
java_utils.h
Go to the documentation of this file.
1 /*******************************************************************\
2 
3 Module:
4 
5 Author: Daniel Kroening, kroening@kroening.com
6 
7 \*******************************************************************/
8 
9 #ifndef CPROVER_JAVA_BYTECODE_JAVA_UTILS_H
10 #define CPROVER_JAVA_BYTECODE_JAVA_UTILS_H
11 
12 #include <unordered_set>
13 
14 #include <util/nodiscard.h>
15 #include <util/pointer_expr.h>
16 
18 
19 class java_class_typet;
20 class java_method_typet;
21 class message_handlert;
22 class symbol_table_baset;
23 
30 bool is_java_string_type(const struct_typet &struct_type);
31 
34 {
45 };
46 
50 get_java_primitive_type_info(const typet &maybe_primitive_type);
51 
54 {
60 };
61 
65 get_boxed_type_info_by_name(const irep_idt &type_name);
66 
70 
73 bool is_primitive_wrapper_type_name(const std::string &type_name);
74 
76  const irep_idt &class_name,
77  symbol_table_baset &symbol_table,
78  message_handlert &message_handler,
79  const struct_union_typet::componentst &componentst);
80 
83 unsigned java_local_variable_slots(const typet &t);
84 
88 
89 const std::string java_class_to_package(const std::string &canonical_classname);
90 
101  exprt &expr,
102  const source_locationt &source_location);
103 
104 #define JAVA_STRING_LITERAL_PREFIX "java::java.lang.String.Literal"
105 
108 bool is_java_string_literal_id(const irep_idt &id);
109 
118  const std::string &friendly_name,
119  const symbol_table_baset &symbol_table,
120  std::string &error);
121 
126  const pointer_typet &given_pointer_type,
127  const java_class_typet &replacement_class_type);
128 
132 
138  symbolt &class_symbol,
139  const struct_union_typet::componentst &components_to_add);
140 
142  const std::string &src,
143  size_t position,
144  char open_char,
145  char close_char);
146 
148  const irep_idt &function_name,
149  const exprt::operandst &arguments,
150  const typet &range,
151  symbol_table_baset &symbol_table);
152 
154 
155 std::string pretty_print_java_type(const std::string &fqn_java_type);
156 
159  const irep_idt &component_class_id,
160  const irep_idt &component_name,
161  const symbol_tablet &symbol_table,
162  bool include_interfaces);
163 
165 
166 extern const std::unordered_set<std::string> cprover_methods_to_ignore;
167 
169  const typet &type,
170  const std::string &basename_prefix,
171  const source_locationt &source_location,
172  const irep_idt &function_name,
173  symbol_table_baset &symbol_table);
174 
180 
184 
189 class_name_from_method_name(const std::string &method_name);
190 
191 #endif // CPROVER_JAVA_BYTECODE_JAVA_UTILS_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
NODISCARD
#define NODISCARD
Definition: nodiscard.h:22
java_local_variable_slots
unsigned java_local_variable_slots(const typet &t)
Returns the number of JVM local variables (slots) taken by a local variable that, when translated to ...
Definition: java_utils.cpp:127
java_primitive_type_infot::boxed_type_factory_method
const irep_idt boxed_type_factory_method
Full identifier of the boxed type's factory method that takes the corresponding primitive as its sole...
Definition: java_utils.h:39
typet
The type of an expression, extends irept.
Definition: type.h:28
is_java_string_literal_id
bool is_java_string_literal_id(const irep_idt &id)
Definition: java_utils.cpp:209
dereference_exprt
Operator to dereference a pointer.
Definition: pointer_expr.h:659
find_closing_delimiter
size_t find_closing_delimiter(const std::string &src, size_t position, char open_char, char close_char)
Finds the corresponding closing delimiter to the given opening delimiter.
Definition: java_utils.cpp:305
declaring_class
optionalt< irep_idt > declaring_class(const symbolt &symbol)
Gets the identifier of the class which declared a given symbol.
Definition: java_utils.cpp:571
java_primitive_type_infot::boxed_type_name
const irep_idt boxed_type_name
Name, including java:: prefix, of the corresponding boxed type.
Definition: java_utils.h:36
nodiscard.h
checked_dereference
dereference_exprt checked_dereference(const exprt &expr)
Dereference an expression and flag it for a null-pointer check.
Definition: java_utils.cpp:284
exprt
Base class for all expressions.
Definition: expr.h:55
struct_union_typet::componentst
std::vector< componentt > componentst
Definition: std_types.h:140
java_method_parameter_slots
unsigned java_method_parameter_slots(const java_method_typet &t)
Returns the the number of JVM local variables (slots) used by the JVM to pass, upon call,...
Definition: java_utils.cpp:146
set_declaring_class
void set_declaring_class(symbolt &symbol, const irep_idt &declaring_class)
Sets the identifier of the class which declared a given symbol to declaring_class.
Definition: java_utils.cpp:577
resolve_inherited_component.h
java_class_typet
Definition: java_types.h:196
resolve_friendly_method_name
irep_idt resolve_friendly_method_name(const std::string &friendly_name, const symbol_table_baset &symbol_table, std::string &error)
Resolves a user-friendly method name (like packagename.Class.method) into an internal name (like java...
Definition: java_utils.cpp:214
is_primitive_wrapper_type_id
bool is_primitive_wrapper_type_id(const irep_idt &id)
Returns true iff the argument is the symbol-table identifier of a Java primitive wrapper type (for ex...
Definition: java_utils.cpp:108
java_boxed_type_infot
Return type for get_boxed_type_info_by_name.
Definition: java_utils.h:53
java_add_components_to_class
void java_add_components_to_class(symbolt &class_symbol, const struct_union_typet::componentst &components_to_add)
Add the components in components_to_add to the class denoted by class symbol.
Definition: java_utils.cpp:344
java_primitive_type_infot::unboxing_function_name
const irep_idt unboxing_function_name
Full identifier of the most general boxed-type method that yields this type.
Definition: java_utils.h:44
class_name_from_method_name
optionalt< std::string > class_name_from_method_name(const std::string &method_name)
Get JVM type name of the class in which method_name is defined.
Definition: java_utils.cpp:583
pretty_print_java_type
std::string pretty_print_java_type(const std::string &fqn_java_type)
Strip the package name from a java type, for the type to be pretty printed (java::java....
Definition: java_utils.cpp:424
symbol_table_baset
The symbol table base class interface.
Definition: symbol_table_base.h:21
pointer_expr.h
java_class_to_package
const std::string java_class_to_package(const std::string &canonical_classname)
Definition: java_utils.cpp:156
message_handlert
Definition: message.h:27
exprt::operandst
std::vector< exprt > operandst
Definition: expr.h:58
strip_java_namespace_prefix
irep_idt strip_java_namespace_prefix(const irep_idt &to_strip)
Strip java:: prefix from given identifier.
Definition: java_utils.cpp:410
merge_source_location_rec
void merge_source_location_rec(exprt &expr, const source_locationt &source_location)
Attaches a source location to an expression and all of its subexpressions.
Definition: java_utils.cpp:200
get_inherited_component
optionalt< resolve_inherited_componentt::inherited_componentt > get_inherited_component(const irep_idt &component_class_id, const irep_idt &component_name, const symbol_tablet &symbol_table, bool include_interfaces)
Finds an inherited component (method or field), taking component visibility into account.
Definition: java_utils.cpp:451
optionalt
nonstd::optional< T > optionalt
Definition: optional.h:35
get_java_primitive_type_info
const java_primitive_type_infot * get_java_primitive_type_info(const typet &maybe_primitive_type)
If primitive_type is a Java primitive type, return information about it, otherwise return null.
Definition: java_utils.cpp:62
java_primitive_type_infot
Return type for get_java_primitive_type_info.
Definition: java_utils.h:33
is_primitive_wrapper_type_name
bool is_primitive_wrapper_type_name(const std::string &type_name)
Returns true iff the argument is the fully qualified name of a Java primitive wrapper type (for examp...
Definition: java_utils.cpp:113
source_locationt
Definition: source_location.h:18
struct_typet
Structure type, corresponds to C style structs.
Definition: std_types.h:230
symbolt
Symbol table entry.
Definition: symbol.h:27
get_boxed_type_info_by_name
const java_boxed_type_infot * get_boxed_type_info_by_name(const irep_idt &type_name)
If type_name is a Java boxed type tag, return information about it, otherwise return null.
Definition: java_utils.cpp:35
java_boxed_type_infot::unboxing_function_name
const irep_idt unboxing_function_name
Name of the function defined on the boxed type that returns the boxed value.
Definition: java_utils.h:57
make_function_application
exprt make_function_application(const irep_idt &function_name, const exprt::operandst &arguments, const typet &range, symbol_table_baset &symbol_table)
Create a (mathematical) function application expression.
Definition: java_utils.cpp:387
is_java_string_type
bool is_java_string_type(const struct_typet &struct_type)
Returns true iff the argument represents a string type (CharSequence, StringBuilder,...
Definition: java_utils.cpp:26
cprover_methods_to_ignore
const std::unordered_set< std::string > cprover_methods_to_ignore
Methods belonging to the class org.cprover.CProver that should be ignored (not converted),...
Definition: java_utils.cpp:532
pointer_typet
The pointer type These are both 'bitvector_typet' (they have a width) and 'type_with_subtypet' (they ...
Definition: pointer_expr.h:23
generate_class_stub
void generate_class_stub(const irep_idt &class_name, symbol_table_baset &symbol_table, message_handlert &message_handler, const struct_union_typet::componentst &componentst)
Definition: java_utils.cpp:161
java_method_typet
Definition: java_types.h:100
java_boxed_type_infot::corresponding_primitive_type
const typet corresponding_primitive_type
Primitive type that this boxed type contains.
Definition: java_utils.h:59
pointer_to_replacement_type
pointer_typet pointer_to_replacement_type(const pointer_typet &given_pointer_type, const java_class_typet &replacement_class_type)
Given a pointer type to a Java class and a type representing a more specific Java class,...
Definition: java_utils.cpp:272
is_non_null_library_global
bool is_non_null_library_global(const irep_idt &)
Check if a symbol is a well-known non-null global.
Definition: java_utils.cpp:522
fresh_java_symbol
symbolt & fresh_java_symbol(const typet &type, const std::string &basename_prefix, const source_locationt &source_location, const irep_idt &function_name, symbol_table_baset &symbol_table)
Definition: java_utils.cpp:558