Skip to content

type_dynamic_cast (extension of expr_cast) #1667

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 4 commits into from
Jan 12, 2018

Conversation

romainbrenguier
Copy link
Contributor

This is similar to expr_cast (added by @NathanJPhillips), with some code duplication.
Allows to use type_dynamic_cast<> for typet objects in the same way we
use expr_dynamic_cast<> for exprt.
This PR adds an example use of this for pointer_typet.

@smowton
Copy link
Contributor

smowton commented Dec 13, 2017

@NathanJPhillips could you review please?

@romainbrenguier
Copy link
Contributor Author

@NathanJPhillips could you review please?

By the way, is there a reason I cannot add @NathanJPhillips as a reviewer?

@smowton
Copy link
Contributor

smowton commented Dec 13, 2017

I think it's because he's a "grey tick," for unknown reasons

entry.total_width=to_pointer_type(type).get_width();
DATA_INVARIANT(entry.total_width!=0, "pointer must have width");
}
entry.total_width=type_dynamic_cast<pointer_typet>(type).get_width();
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

When is it considered ok to use a type_dynamic_cast and when should a type_checked_cast be used instead?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

type_dynamic_cast throws an exception if it cannot cast while type_checked_cast has a precondition.
Actually I think the checked one would be better here since we don't catch the exception.


inline void validate_type(const pointer_typet &type)
{
INVARIANT(type.get_width() > 0, "pointer must have non-zero width");
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is a DATA_INVARIANT

@@ -1402,6 +1403,16 @@ inline pointer_typet &to_pointer_type(typet &type)
return static_cast<pointer_typet &>(type);
}

template<> inline bool can_cast_type<pointer_typet>(const typet &type)
{
return type.id()==ID_pointer && !type.get(ID_width).empty();
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The latter part of this looks like a validation - can we have something that has type.id()==ID_pointer without also having an ID_width field?

@@ -29,6 +29,9 @@ Author: Nathan Phillips <[email protected]>
/// \return true if \a base is of type \a T
template<typename T> inline bool can_cast_expr(const exprt &base);

/// Similar to can_cast_expr(const exprt &base) but for typet.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This comment will appear in generated docs so it is worth copying the more expressive comment above.

@@ -37,6 +40,9 @@ template<typename T> inline bool can_cast_expr(const exprt &base);
/// validate objects in this way at any time.
inline void validate_expr(const exprt &) {}

/// Similar to validate_expr(const exprt &) but for typet.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Again here.

@@ -86,6 +92,26 @@ auto expr_try_dynamic_cast(TExpr &base)
return ret;
}

template <typename T, typename TType>
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Add documentation based on that above.

@romainbrenguier
Copy link
Contributor Author

@NathanJPhillips this is ready for being reviewed again

@tautschnig
Copy link
Collaborator

I'd say this is now in @NathanJPhillips' hands.

Copy link
Collaborator

@martin-cs martin-cs left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I agree that if total_width != 0 is actually a data invariant then it should be checked as part of the conversion / general "well formed"-ness checks. I think I also agree these should be independent of the conversion functions.

entry.total_width=to_pointer_type(type).get_width();
DATA_INVARIANT(entry.total_width!=0, "pointer must have width");
}
entry.total_width=type_checked_cast<pointer_typet>(type).get_width();
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Yes.

Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Again, the commit message needs to be adjusted.

/// validate particular types. Should always succeed unless the program has
/// entered an invalid state. We validate objects at cast time as that is when
/// these checks have been used historically, but it would be reasonable to
/// validate objects in this way at any time.
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Can we say the word "invariant" here, or "data invariant"?

inline void validate_type(const pointer_typet &type)
{
DATA_INVARIANT(!type.get(ID_width).empty(), "pointer must have width");
DATA_INVARIANT(type.get_width() > 0, "pointer must have non-zero width");
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

To check that these really are invariants (I believe they should be but it is always good to check), could we add a call to this validate_type to to_pointer_type, that was we aren't enforcing different invariants depending on which system you use.

Copy link
Collaborator

@tautschnig tautschnig left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Can I just throw a brief block in here: why do we have both type_dynamic_cast and type_checked_cast when the choice between assertions and exceptions is actually configurable (to be configured?) via invariant.h?

auto type_checked_cast(TType &base)
-> typename detail::expr_dynamic_cast_return_typet<T, TType>::type
{
PRECONDITION(can_cast_type<T>(base));
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This looks non-optimal as can_cast_type is called twice (here and in type_try_dynamic_cast). Wouldn't it better to put the assertion on the return value of type_try_dynamic_cast?

@NathanJPhillips
Copy link
Contributor

@tautschnig - turning INVARIANT into exceptions would be a global (not per-INVARIANT) setting that will probably never be enabled for our purposes. Conversely turning INVARIANT off totally in release versions could well be a valid choice in some situations. A version that emits a known exception that can be caught is unlikely to be used much here but matches the static_cast/dynamic_cast pattern from the STL.

@tautschnig
Copy link
Collaborator

At present, it seems actually a bit weird: type_checked_cast can be configured (via invariant.h) not to do any checks (with a current default of throwing an exception); type_dynamic_cast will always raise an exception if the conversion failed. The latter fits what the STL does in case of references, else dynamic_cast will just return a nullptr (for pointers).

What I'd like to see argued for is a case where people explicitly want to raise and catch an exception, i.e., strictly need the present type_dynamic_cast over type_checked_cast.

@romainbrenguier
Copy link
Contributor Author

@tautschnig @peterschrammel I removed type_dynamic_cast (redundant with type_ckecked_cast) and improved type_checked_cast

Copy link
Collaborator

@tautschnig tautschnig left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'm fine with this once the commit messages are updated.

/// \param base Reference to a generic \ref typet
/// \return Reference to object of type \a T
template<typename T, typename TType>
auto type_checked_cast(TType &base)
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

It seems the commit message doesn't match anymore?

entry.total_width=to_pointer_type(type).get_width();
DATA_INVARIANT(entry.total_width!=0, "pointer must have width");
}
entry.total_width=type_checked_cast<pointer_typet>(type).get_width();
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Again, the commit message needs to be adjusted.

@romainbrenguier
Copy link
Contributor Author

@tautschnig commit messages updated

Copy link
Collaborator

@tautschnig tautschnig left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

It may be worth adjusting the changes to make clang-format happy.

@tautschnig
Copy link
Collaborator

Assigning to @romainbrenguier to possibly add clang-format fixes and then merge once happy.

This is similar to expr_cast functions, with some code duplication.
Allows to use type_try_dynamic_cast<> and type_checked_cast<>
for typet objects in the same way we use expr_try_dynamic_cast<> and
expr_checked_cast<> for exprt.
This performs the necessary checks to ensure the type is a well formed
pointer type.
@romainbrenguier romainbrenguier merged commit 5bd5962 into diffblue:develop Jan 12, 2018
@romainbrenguier romainbrenguier deleted the feature/type_cast branch January 12, 2018 11:15
smowton added a commit to smowton/cbmc that referenced this pull request May 9, 2018
d190fd8 Merge remote-tracking branch 'upstream/develop' into pull-support-20180112
5bd5962 Merge pull request diffblue#1667 from romainbrenguier/feature/type_cast
8ecb55a Merge pull request diffblue#1717 from smowton/smowton/feature/remove_virtual_functions_per_function
0d7310a Merge pull request diffblue#1691 from romainbrenguier/bugfix/getClass#TG-1245
2064849 Use type_checked_cast in boolbv_width
c5fc351 Validate data in pointer_typet in to_pointer_typet
35905c6 Add can_cast_type, validate_type for pointer_typet
b72bacf Define type_try_dynamic_cast and type_checked_cast
23c3561 Unit test for string symbol resolution
c13e602 Adding only needed equations in symbol resolution
ae4deff Debug information for string equations
912828d JBMC: Run remove-virtual-functions as each function is converted
a711c64 Introduce mechanism for renumbering an individual GOTO program
e308a32 Merge pull request diffblue#1679 from NlightNFotis/nondet_extra_test
e6ceb91 Merge pull request diffblue#1724 from tautschnig/fix-visitor
ea74bed Add extra test for nondet-static flag and arrays
4f74896 Use irept API, not implementation-level API
c55b4a5 Merge pull request diffblue#1682 from martin-cs/fix/dependence-graph-namespace-lifespan
1a2c14b Merge pull request diffblue#1722 from diffblue/unsafe_type_constructors
957a568 Merge pull request diffblue#1677 from NlightNFotis/pb4_develop
9c5add4 remove deprecated constructors for three bitvector types
c96e02a no longer use deprecated constructors for some bitvector types
954060e Add unit test for has_subtype
3dd3877 Refactor has_char_pointer_subtype with has_subtype
4699c13 Extend symbol resolution to string_typet
74144fc Handle if_exprt in add_axioms_for_string_literal
c6c1b3f Add an optional guard to add_axioms_for_constant
933d635 Merge pull request diffblue#1716 from mgudemann/fix/null_check_for_java_instanceof
1659314 Merge pull request diffblue#1715 from smowton/smowton/cleanup/jbmc_unused_passes
9c457b7 Add regression test for null instanceof.
2080cd3 Complete instanceof for Java.
d4300d0 Merge pull request diffblue#1697 from diffblue/nondet_symbol_exprt
1c68dd4 Merge pull request diffblue#1714 from tautschnig/c-library-strcat
44b5bae Merge pull request diffblue#1698 from thomasspriggs/tg1633
c4304ba JBMC: Remove C-only passes
bb8cfaa C library: Check upper bounds in memset, memcpy, memmove
7d4984f C library: Implement strcat, strncat
2a5cea2 This introduces nondet_symbol_exprt, which is generated by symbolic execution in response to side_effect_expr_nondett
85193a0 Merge pull request diffblue#1694 from NathanJPhillips/feature/add-raw-lhs-to-trace
d9122dc Merge pull request diffblue#1710 from NathanJPhillips/feature/remove_instanceof_per_function
092df69 Switch from custom file / path routines to Boost-filesystem
c8821b2 Allow to remove instanceof when remove exceptions
94b7658 Don't pass iterators into function calls
a9c4e4f Added regression tests
76318ce Protect extended trace behind a command line option
69b0ff1 Added base_name in comments for all symbols
e86080a Add raw LHS irep field to trace output
ddd1b7a Add remove_instanceof overload to remove from a particular instruction
1c227b7 Merge pull request diffblue#1660 from smowton/smowton/fix/lazy_methods_array_parameters
ae89c94 Lazy loading: assume concrete generic parameter types are needed
80eb6a6 TG-1877: Include array pointer types in needed classes
1053e5f Fix for [TG-1633] Inner generic types have incorrect type identifier
e2cda1a Merge pull request diffblue#1704 from tautschnig/fix-copy-paste
ef4a65e Fix op1/op0 copy&paste typo
21ea31f Merge pull request diffblue#1702 from peterschrammel/goto-diff-java
c4bc953 Merge pull request diffblue#1701 from peterschrammel/allow-instrument-jdk
2811363 Java regression test for goto-diff
43d2e09 Also reset fresh temporary symbol counter
9ef28f4 Compare relative goto target offsets
eaf3a7d Get source location from symbol table
ab59659 Allow instrumentation of java.* and org.cprover.*
6fbd59c Merge pull request diffblue#1631 from tautschnig/fix-pointer-minus
7c04b5c Merge pull request diffblue#1699 from NathanJPhillips/feature/reset-main-in-tests
5e0f186 Pointer difference over void* is difference over char*
faf8f00 Merge commit 'a83b52cddbed22304372c276512c63701eb3aedb' into pull-support-20180104
8236db4 Merge pull request diffblue#1419 from peterschrammel/refactor/cover-instrument
a580e27 Merge pull request diffblue#1689 from smowton/smowton/feature/get_this
591511a Allow callers of load_java_class to pass the name of the main function
1b86b27 Merge pull request diffblue#1687 from smowton/smowton/feature/class-hierarchy-dot
fd2bf6a Merge pull request diffblue#1688 from smowton/smowton/feature/parameter_indices
f570ce5 Merge pull request diffblue#1696 from smowton/smowton/fix/identical_struct_equality
61b0d6d Merge pull request diffblue#1666 from mgudemann/bugfix/removed_required_virtual_calls
3365054 Add regression test
2b6dc8b Resolve concrete function call if no implementation is found
3f1fd64 Add code_typet::get_parameter_indices
42cf61a Fix testing for empty line in test desc file
2090000 Fix missing newline at end of desc file
e448d5f Fix unsatisfiable test line
f7f033d String smoke tests: ensure no type mismatches are seen
b627c3d Replace unsound struct-cast simplification
8fa42b3 Class hierarchy: add DOT output, unit tests
04f2faf Mark GOTO instructions with unresolved virtual calls
aac181f Pass command line options via optionst
b6fa3e8 Factorize source location initialization
8da5395 Document cover functions
a7f0c3d Introduce cover instrumenter
873627a Split cover into several files
0fc08f3 Replace cover-function-only by cover-include-pattern
1f2102c Add code_typet::get_this
2801f0f Avoid crashing when --dependence-graph is used by correcting namespace scoping.
acac776 Add a test for the same-named static functions crashing dependence graph in the goto-analyser
05f46a9 Fix the problem where two static functions with the same name would cause the dependency graph to fail.

git-subtree-dir: cbmc
git-subtree-split: d190fd8
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

6 participants