Test whether an object is already deleted.

The operator ::test_obj_def checks whether the object still exists in the HALCON operator data base (i.e. whether the surrogate is still valid). This check especially makes sense before deleting an object if it is not sure that the object has already been deleted by a prior deleting operator (::clear_obj).

The operator ::test_obj_def can return TRUE even if the object was already deleted because the surrogates of deleted objects are re-used for new objects. In this context see the example.

Herror err;
circle(&Circle,100.0,100.0,100.0);
err = test_obj_def(Circle);
printf("Result for test_obj_def (H_MSG_TRUE): %d\n",err);
clear_obj(Circle);
err = test_obj_def(Circle);
printf("Result for test_obj_def (H_MSG_FALSE): %d\n",err);
gen_rectangle1(&Rectangle,200.0,200.0,300.0,300.0);
err = test_obj_def(Circle);
printf("Result for test_obj_def (H_MSG_TRUE!!!): %d\n",err);

The runtime complexity is O(1).

The operator ::test_obj_def returns the value H_MSG_TRUE if an object with this surrogate is present in the HALCON operator data base, otherwise the value H_MSG_FALSE is returned. The behavior in case of empty input (no input objects available) is set via the operator ::set_system('no_object_result',<Result>).

::clear_obj, ::gen_circle, ::gen_rectangle1

::set_check, ::clear_obj, ::reset_obj_db

bool

Basic operators