Frama-C API - frama_c_visitor

Class type for a database-aware visitor. This is done by defining auxiliary methods that can be redefined in inherited classes, while the corresponding ones from Cil.cilVisitor must retain their values as defined here. Otherwise, annotations may not be visited properly. The replaced functions are

• vstmt (use vstmt_aux instead)
• vglob (use vglob_aux instead)

A few hints on how to use correctly this visitor

• when initializing a new project with it (see File.init_project_from_visitor), use a visitor with copy behavior

• SkipChildren and ChangeTo must be used with extreme care in a visitor with copy behavior, or some nodes may be shared between the original and the copy.

• Do not erase a statement during the visit, as there might be annotations attached to it. Change it to Skip instead, the generic_frama_c_visitor will know what to do.

• Be careful if you change the vid or sid: this must be done before anything has been attached to the corresponding variable or statement in the new project, which means -- for statements, in vstmt, for the current statement only -- for variables, at their declaration point.