errata/398: errata/398: new proposal for vpi_handle_muti_index

From: Francoise Martinolle (fm@cadence.com)
Date: Mon Mar 22 2004 - 07:30:00 PST

  • Next message: Charles Dawson: "PTF agenda for 3/22/2004"

    The following reply was made to PR errata/398; it has been noted by GNATS.

    From: Francoise Martinolle <fm@cadence.com>
    To: ptf-bugs@boyd.com
    Cc:
    Subject: errata/398: new proposal for vpi_handle_muti_index
    Date: Mon, 22 Mar 2004 10:38:28 -0500

     --=====================_2878158==_.ALT
     Content-Type: text/plain; charset="us-ascii"; format=flowed
     
     Charles,
       I need a number for vpiIsArray.
     All,
     Please review and let me know if that is okay.
     
     We decided to
     1. add boolean property: vpiIsArray property on the following object types:
     variables, instance array, reg array, net array, namedEvent array.
     
     add vpiIsArray to vpi_user.h
     #define vpiIsArray xxx /* Object is an array */
     
     2. and to modify the vpi_handle_by_multi_index description as:
     
     CHANGE synopsis section:
     Obtain a handle to a sub object using an array of indexes and a parent object.
     
     TO:
     Obtain a handle to a sub object using an array of indices and a reference
     object.
     
     in the description of the argument num_index:
     CHANGE:
     number of indexes in the index array
     TO:
     number of indices in the index array
     
     In the description of argument index_array
     CHANGE:
     array of indexes.
     TO:
     array of indices
     
     In the table description, CHANGE:
     Handle to an object of type vpiRegBit, vpiNetBit, vpiRegWord, or vpiNetWord
     TO:
     Handle to an object
     
     CHANGE description:
     The VPI routine vpi_handle_by_multi_index() shall return a handle to an
     object based on the list of
     indexes and parent object passed in. The argument num_index will contain
     the number of indexes in the provided
     array index_array. The order of the indexes provided, shall be for the left
     most select first, progressing
     to the right most select last. This function can be used to access all
     objects whose property vpiMultiArray is
     TRUE. This routine shall only provide access to a bit or word of the parent
     object.
     
     TO:
     The VPI routine vpi_handle_by_multi_index() shall return a handle to an
     object based on the list of
     indices provided by the argument index_array, and reference handle denoted
     by obj. The argument num_index will contain the number of indices in the
     provided array index_array. The order of the indices provided, shall be for
     the left most select first, progressing to the right most select last. This
     routine can be used on a reference handle whose property vpiIsArray is
     TRUE. This routine shall only provide access to an array element of the
     reference handle.
     
     
     
     --=====================_2878158==_.ALT
     Content-Type: text/html; charset="us-ascii"
     
     <html>
     Charles,<br>
     &nbsp;I need a number for vpiIsArray.<br>
     All, <br>
     Please review and let me know if that is okay.<br>
     <br>
     We decided to<br>
     1. add boolean property: vpiIsArray property on the following object
     types:<br>
     variables, instance array, reg array, net array, namedEvent array. <br>
     <br>
     add vpiIsArray to vpi_user.h<br>
     #define vpiIsArray xxx /* Object is an array */<br>
     <br>
     2. and to modify the vpi_handle_by_multi_index description as:<br>
     <br>
     CHANGE synopsis section:<br>
     Obtain a handle to a sub object using an array of indexes and a parent
     object.<br>
     <br>
     TO:<br>
     Obtain a handle to a sub object using an array of indices and a reference
     object.<br>
     <br>
     in the description of the argument num_index:<br>
     CHANGE:<br>
     number of indexes in the index array<br>
     TO:<br>
     number of indices in the index array<br>
     <br>
     In the description of argument index_array<br>
     CHANGE:<br>
     array of indexes.<br>
     TO: <br>
     array of indices<br>
     <br>
     In the table description, CHANGE:<br>
     Handle to an object of type vpiRegBit, vpiNetBit, vpiRegWord, or
     vpiNetWord<br>
     TO:<br>
     Handle to an object<br>
     <br>
     CHANGE description:<br>
     The VPI routine <b>vpi_handle_by_multi_index() </b>shall return a handle
     to an object based on the list of<br>
     indexes and parent object passed in. The argument <i>num_index </i>will
     contain the number of indexes in the provided<br>
     array <i>index_array</i>. The order of the indexes provided, shall be for
     the left most select first, progressing<br>
     to the right most select last. This function can be used to access all
     objects whose property <b>vpiMultiArray </b>is<br>
     <font face="Courier, Courier">TRUE</font>. This routine shall only
     provide access to a bit or word of the parent object.<br>
     <br>
     TO:<br>
     The VPI routine <b>vpi_handle_by_multi_index() </b>shall return a handle
     to an object based on the list of<br>
     indices provided by the argument <i>index_array,</i> and reference handle
     denoted by <i>obj</i>. The argument <i>num_index </i>will contain the
     number of indices in the provided array <i>index_array</i>. The order of
     the indices provided, shall be for the left most select first,
     progressing to the right most select last. This routine can be used on a
     reference handle whose property <b>vpiIsArray </b>is
     <font face="Courier, Courier">TRUE</font>. This routine shall only
     provide access to an array element of the reference handle.<br>
     <br>
     <br>
     </html>
     
     --=====================_2878158==_.ALT--
     

    This archive was generated by hypermail 2.1.4 : Mon Mar 22 2004 - 07:30:07 PST and
    sponsored by Boyd Technology, Inc.