Question

Several VPI routines, that have existed before SystemVerilog, have been extended in usage with the addition of new object types and/or properties. While the extensions are fairly obvious, they are emphasized here again to turn the reader’s attention to the extended usage.

Table 30-1: Usage extensions to Verilog 2001 VPI routines

To	Use	New Usage
Get tool’s reader version	vpi_get_vlog_info()	Reader version information
Create an iterator for the loaded objects (using vpi_iterate(vpiData-Loaded, <instance>)). Create an iterator for (object or traverse) collections using vpi_iterate(vpiMember, <collection>).	vpi_iterate()	Add iteration types vpiData- Loaded and vpiMember. Extended with collection handle to create a collection member element iterator.
Obtain a traverse (collection) handle from an object (collection) handle	vpi_handle()	Add new types vpiTrvsObj and vpiTrvsCollection. Extended with collection handle (of traversable objects) to create a traverse collection from an object collection.
Obtain a property.	vpi_get()	Extended with the new check properties: vpiIsLoaded , vpiHasDataVC, vpiHasVC, vpiHasNoValue, and vpiBelong.
Get a value.	vpi_get_value()	Use traverse handle as argument to get value where handle points.
Get time traverse (collection) handle points at.	vpi_get_time()	Use traverse (collection) handle as argument to get current time where handle points. Also, get the traverse handle min, max, previous VC time, or next VC time.
Free traverse handle Free (traverse) collection handle.	vpi_free_object()	Use traverse handle as argument Use (traverse) collection handle as argument.