ruby-vpi 11.1.1 → 12.0.0

data/ref/ruby/classes/Vpi/Handle.html

@@ -138,15 +138,17 @@ names (strings or symbols) or integer constants.
       <h3 class="section-bar">Methods</h3>
 
       <div class="name-list">
-      <a href="#M000092">[]</a>&nbsp;&nbsp;
-      <a href="#M000090">get_value</a>&nbsp;&nbsp;
-      <a href="#M000089">get_value_wrapper</a>&nbsp;&nbsp;
-      <a href="#M000093">inspect</a>&nbsp;&nbsp;
-      <a href="#M000095">method_missing</a>&nbsp;&nbsp;
-      <a href="#M000091">put_value</a>&nbsp;&nbsp;
-      <a href="#M000094">to_s</a>&nbsp;&nbsp;
+      <a href="#M000094">[]</a>&nbsp;&nbsp;
+      <a href="#M000092">get_value</a>&nbsp;&nbsp;
+      <a href="#M000091">get_value_wrapper</a>&nbsp;&nbsp;
+      <a href="#M000095">inspect</a>&nbsp;&nbsp;
+      <a href="#M000097">method_missing</a>&nbsp;&nbsp;
+      <a href="#M000093">put_value</a>&nbsp;&nbsp;
+      <a href="#M000096">to_s</a>&nbsp;&nbsp;
+      <a href="#M000088">x!</a>&nbsp;&nbsp;
       <a href="#M000087">x?</a>&nbsp;&nbsp;
-      <a href="#M000088">z?</a>&nbsp;&nbsp;
+      <a href="#M000090">z!</a>&nbsp;&nbsp;
+      <a href="#M000089">z?</a>&nbsp;&nbsp;
       </div>
     </div>
 
@@ -194,12 +196,12 @@ names (strings or symbols) or integer constants.
     <div id="methods">
       <h3 class="section-bar">Public Instance methods</h3>
 
-      <div id="method-M000092" class="method-detail">
-        <a name="M000092"></a>
+      <div id="method-M000094" class="method-detail">
+        <a name="M000094"></a>
 
         <div class="method-heading">
-          <a href="Handle.src/M000092.html" target="Code" class="method-signature"
-            onclick="popupCode('Handle.src/M000092.html');return false;">
+          <a href="Handle.src/M000094.html" target="Code" class="method-signature"
+            onclick="popupCode('Handle.src/M000094.html');return false;">
           <span class="method-name">[]</span><span class="method-args">(*aTypes)</span>
           </a>
         </div>
@@ -212,12 +214,12 @@ constant).
         </div>
       </div>
 
-      <div id="method-M000090" class="method-detail">
-        <a name="M000090"></a>
+      <div id="method-M000092" class="method-detail">
+        <a name="M000092"></a>
 
         <div class="method-heading">
-          <a href="Handle.src/M000090.html" target="Code" class="method-signature"
-            onclick="popupCode('Handle.src/M000090.html');return false;">
+          <a href="Handle.src/M000092.html" target="Code" class="method-signature"
+            onclick="popupCode('Handle.src/M000092.html');return false;">
           <span class="method-name">get_value</span><span class="method-args">(aFormat = VpiObjTypeVal)</span>
           </a>
         </div>
@@ -231,12 +233,12 @@ attempt to determine the correct format.
         </div>
       </div>
 
-      <div id="method-M000089" class="method-detail">
-        <a name="M000089"></a>
+      <div id="method-M000091" class="method-detail">
+        <a name="M000091"></a>
 
         <div class="method-heading">
-          <a href="Handle.src/M000089.html" target="Code" class="method-signature"
-            onclick="popupCode('Handle.src/M000089.html');return false;">
+          <a href="Handle.src/M000091.html" target="Code" class="method-signature"
+            onclick="popupCode('Handle.src/M000091.html');return false;">
           <span class="method-name">get_value_wrapper</span><span class="method-args">(aFormat)</span>
           </a>
         </div>
@@ -249,12 +251,12 @@ Reads the value using the given format (integer constant) and returns a
         </div>
       </div>
 
-      <div id="method-M000093" class="method-detail">
-        <a name="M000093"></a>
+      <div id="method-M000095" class="method-detail">
+        <a name="M000095"></a>
 
         <div class="method-heading">
-          <a href="Handle.src/M000093.html" target="Code" class="method-signature"
-            onclick="popupCode('Handle.src/M000093.html');return false;">
+          <a href="Handle.src/M000095.html" target="Code" class="method-signature"
+            onclick="popupCode('Handle.src/M000095.html');return false;">
           <span class="method-name">inspect</span><span class="method-args">(*aPropNames)</span>
           </a>
         </div>
@@ -267,12 +269,12 @@ handles.
         </div>
       </div>
 
-      <div id="method-M000095" class="method-detail">
-        <a name="M000095"></a>
+      <div id="method-M000097" class="method-detail">
+        <a name="M000097"></a>
 
         <div class="method-heading">
-          <a href="Handle.src/M000095.html" target="Code" class="method-signature"
-            onclick="popupCode('Handle.src/M000095.html');return false;">
+          <a href="Handle.src/M000097.html" target="Code" class="method-signature"
+            onclick="popupCode('Handle.src/M000097.html');return false;">
           <span class="method-name">method_missing</span><span class="method-args">(aMeth, *aArgs, &amp;aBlockArg)</span>
           </a>
         </div>
@@ -293,18 +295,18 @@ Provides access to this handle&#8217;s
 through method calls. In the case that a child handle has the same name as
 a VPI property, the child handle will be accessed instead of the VPI
 property. However, you can still access the VPI property via <a
-href="Handle.html#M000090">get_value</a> and <a
-href="Handle.html#M000091">put_value</a>.
+href="Handle.html#M000092">get_value</a> and <a
+href="Handle.html#M000093">put_value</a>.
 </p>
         </div>
       </div>
 
-      <div id="method-M000091" class="method-detail">
-        <a name="M000091"></a>
+      <div id="method-M000093" class="method-detail">
+        <a name="M000093"></a>
 
         <div class="method-heading">
-          <a href="Handle.src/M000091.html" target="Code" class="method-signature"
-            onclick="popupCode('Handle.src/M000091.html');return false;">
+          <a href="Handle.src/M000093.html" target="Code" class="method-signature"
+            onclick="popupCode('Handle.src/M000093.html');return false;">
           <span class="method-name">put_value</span><span class="method-args">(aValue, aFormat = nil, aTime = nil, aDelay = VpiNoDelay)</span>
           </a>
         </div>
@@ -319,8 +321,8 @@ format.
         </div>
       </div>
 
-      <div id="method-M000094" class="method-detail">
-        <a name="M000094"></a>
+      <div id="method-M000096" class="method-detail">
+        <a name="M000096"></a>
 
         <div class="method-heading">
           <span class="method-name">to_s</span><span class="method-args">(*aPropNames)</span>
@@ -328,7 +330,24 @@ format.
       
         <div class="method-description">
           <p>
-Alias for <a href="Handle.html#M000093">inspect</a>
+Alias for <a href="Handle.html#M000095">inspect</a>
+</p>
+        </div>
+      </div>
+
+      <div id="method-M000088" class="method-detail">
+        <a name="M000088"></a>
+
+        <div class="method-heading">
+          <a href="Handle.src/M000088.html" target="Code" class="method-signature"
+            onclick="popupCode('Handle.src/M000088.html');return false;">
+          <span class="method-name">x!</span><span class="method-args">()</span>
+          </a>
+        </div>
+      
+        <div class="method-description">
+          <p>
+Sets the logic value of this handle to unknown (x).
 </p>
         </div>
       </div>
@@ -345,18 +364,34 @@ Alias for <a href="Handle.html#M000093">inspect</a>
       
         <div class="method-description">
           <p>
-Tests if the logic value of this handle is &quot;don&#8217;t care&quot;
-(x).
+Tests if the logic value of this handle is unknown (x).
 </p>
         </div>
       </div>
 
-      <div id="method-M000088" class="method-detail">
-        <a name="M000088"></a>
+      <div id="method-M000090" class="method-detail">
+        <a name="M000090"></a>
 
         <div class="method-heading">
-          <a href="Handle.src/M000088.html" target="Code" class="method-signature"
-            onclick="popupCode('Handle.src/M000088.html');return false;">
+          <a href="Handle.src/M000090.html" target="Code" class="method-signature"
+            onclick="popupCode('Handle.src/M000090.html');return false;">
+          <span class="method-name">z!</span><span class="method-args">()</span>
+          </a>
+        </div>
+      
+        <div class="method-description">
+          <p>
+Sets the logic value of this handle to high impedance (z).
+</p>
+        </div>
+      </div>
+
+      <div id="method-M000089" class="method-detail">
+        <a name="M000089"></a>
+
+        <div class="method-heading">
+          <a href="Handle.src/M000089.html" target="Code" class="method-signature"
+            onclick="popupCode('Handle.src/M000089.html');return false;">
           <span class="method-name">z?</span><span class="method-args">()</span>
           </a>
         </div>

data/ref/ruby/classes/Vpi/Handle.src/M000088.html

@@ -5,14 +5,14 @@
 
 <html>
 <head>
-  <title>z? (Vpi::Handle)</title>
+  <title>x! (Vpi::Handle)</title>
   <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
   <link rel="stylesheet" href="../../.././rdoc-style.css" type="text/css" media="screen" />
 </head>
 <body class="standalone-code">
   <pre>    <span class="ruby-comment cmt"># File lib/ruby-vpi/vpi.rb, line 58</span>
-58:     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">z?</span>
-59:       <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">hexStrVal</span> <span class="ruby-operator">=~</span> <span class="ruby-regexp re">/z/i</span>
+58:     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">x!</span>
+59:       <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">hexStrVal</span> = <span class="ruby-value str">'x'</span>
 60:     <span class="ruby-keyword kw">end</span></pre>
 </body>
 </html>

data/ref/ruby/classes/Vpi/Handle.src/M000089.html

@@ -5,18 +5,14 @@
 
 <html>
 <head>
-  <title>get_value_wrapper (Vpi::Handle)</title>
+  <title>z? (Vpi::Handle)</title>
   <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
   <link rel="stylesheet" href="../../.././rdoc-style.css" type="text/css" media="screen" />
 </head>
 <body class="standalone-code">
   <pre>    <span class="ruby-comment cmt"># File lib/ruby-vpi/vpi.rb, line 63</span>
-63:     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">get_value_wrapper</span> <span class="ruby-identifier">aFormat</span>
-64:       <span class="ruby-identifier">val</span> = <span class="ruby-constant">S_vpi_value</span>.<span class="ruby-identifier">new</span>
-65:       <span class="ruby-identifier">val</span>.<span class="ruby-identifier">format</span> = <span class="ruby-identifier">aFormat</span>
-66: 
-67:       <span class="ruby-identifier">vpi_get_value</span> <span class="ruby-keyword kw">self</span>, <span class="ruby-identifier">val</span>
-68:       <span class="ruby-identifier">val</span>
-69:     <span class="ruby-keyword kw">end</span></pre>
+63:     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">z?</span>
+64:       <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">hexStrVal</span> <span class="ruby-operator">=~</span> <span class="ruby-regexp re">/z/i</span>
+65:     <span class="ruby-keyword kw">end</span></pre>
 </body>
 </html>

data/ref/ruby/classes/Vpi/Handle.src/M000090.html

@@ -5,40 +5,14 @@
 
 <html>
 <head>
-  <title>get_value (Vpi::Handle)</title>
+  <title>z! (Vpi::Handle)</title>
   <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
   <link rel="stylesheet" href="../../.././rdoc-style.css" type="text/css" media="screen" />
 </head>
 <body class="standalone-code">
-  <pre>     <span class="ruby-comment cmt"># File lib/ruby-vpi/vpi.rb, line 72</span>
- 72:     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">get_value</span> <span class="ruby-identifier">aFormat</span> = <span class="ruby-constant">VpiObjTypeVal</span>
- 73:       <span class="ruby-identifier">val</span> = <span class="ruby-identifier">get_value_wrapper</span>(<span class="ruby-identifier">resolve_prop_type</span>(<span class="ruby-identifier">aFormat</span>))
- 74: 
- 75:       <span class="ruby-keyword kw">case</span> <span class="ruby-identifier">val</span>.<span class="ruby-identifier">format</span>
- 76:         <span class="ruby-keyword kw">when</span> <span class="ruby-constant">VpiBinStrVal</span>, <span class="ruby-constant">VpiOctStrVal</span>, <span class="ruby-constant">VpiDecStrVal</span>, <span class="ruby-constant">VpiHexStrVal</span>, <span class="ruby-constant">VpiStringVal</span>
- 77:           <span class="ruby-identifier">val</span>.<span class="ruby-identifier">value</span>.<span class="ruby-identifier">str</span>
- 78: 
- 79:         <span class="ruby-keyword kw">when</span> <span class="ruby-constant">VpiScalarVal</span>
- 80:           <span class="ruby-identifier">val</span>.<span class="ruby-identifier">value</span>.<span class="ruby-identifier">scalar</span>
- 81: 
- 82:         <span class="ruby-keyword kw">when</span> <span class="ruby-constant">VpiIntVal</span>
- 83:           <span class="ruby-identifier">get_value_wrapper</span>(<span class="ruby-constant">VpiHexStrVal</span>).<span class="ruby-identifier">value</span>.<span class="ruby-identifier">str</span>.<span class="ruby-identifier">to_i</span>(<span class="ruby-value">16</span>)
- 84: 
- 85:         <span class="ruby-keyword kw">when</span> <span class="ruby-constant">VpiRealVal</span>
- 86:           <span class="ruby-identifier">val</span>.<span class="ruby-identifier">value</span>.<span class="ruby-identifier">real</span>
- 87: 
- 88:         <span class="ruby-keyword kw">when</span> <span class="ruby-constant">VpiTimeVal</span>
- 89:           <span class="ruby-identifier">val</span>.<span class="ruby-identifier">value</span>.<span class="ruby-identifier">time</span>
- 90: 
- 91:         <span class="ruby-keyword kw">when</span> <span class="ruby-constant">VpiVectorVal</span>
- 92:           <span class="ruby-identifier">val</span>.<span class="ruby-identifier">value</span>.<span class="ruby-identifier">vector</span>
- 93: 
- 94:         <span class="ruby-keyword kw">when</span> <span class="ruby-constant">VpiStrengthVal</span>
- 95:           <span class="ruby-identifier">val</span>.<span class="ruby-identifier">value</span>.<span class="ruby-identifier">strength</span>
- 96: 
- 97:         <span class="ruby-keyword kw">else</span>
- 98:           <span class="ruby-identifier">raise</span> <span class="ruby-node">&quot;unknown S_vpi_value.format: #{val.format}&quot;</span>
- 99:       <span class="ruby-keyword kw">end</span>
-100:     <span class="ruby-keyword kw">end</span></pre>
+  <pre>    <span class="ruby-comment cmt"># File lib/ruby-vpi/vpi.rb, line 68</span>
+68:     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">z!</span>
+69:       <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">hexStrVal</span> = <span class="ruby-value str">'z'</span>
+70:     <span class="ruby-keyword kw">end</span></pre>
 </body>
 </html>

data/ref/ruby/classes/Vpi/Handle.src/M000091.html

@@ -5,83 +5,18 @@
 
 <html>
 <head>
-  <title>put_value (Vpi::Handle)</title>
+  <title>get_value_wrapper (Vpi::Handle)</title>
   <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
   <link rel="stylesheet" href="../../.././rdoc-style.css" type="text/css" media="screen" />
 </head>
 <body class="standalone-code">
-  <pre>     <span class="ruby-comment cmt"># File lib/ruby-vpi/vpi.rb, line 103</span>
-103:     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">put_value</span> <span class="ruby-identifier">aValue</span>, <span class="ruby-identifier">aFormat</span> = <span class="ruby-keyword kw">nil</span>, <span class="ruby-identifier">aTime</span> = <span class="ruby-keyword kw">nil</span>, <span class="ruby-identifier">aDelay</span> = <span class="ruby-constant">VpiNoDelay</span>
-104:       <span class="ruby-identifier">aFormat</span> =
-105:         <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">aFormat</span>
-106:           <span class="ruby-identifier">resolve_prop_type</span>(<span class="ruby-identifier">aFormat</span>)
-107:         <span class="ruby-keyword kw">else</span>
-108:           <span class="ruby-identifier">get_value_wrapper</span>(<span class="ruby-constant">VpiObjTypeVal</span>).<span class="ruby-identifier">format</span>
-109:         <span class="ruby-keyword kw">end</span>
-110: 
-111:       <span class="ruby-identifier">newVal</span> = <span class="ruby-constant">S_vpi_value</span>.<span class="ruby-identifier">new</span>
-112:       <span class="ruby-identifier">newVal</span>.<span class="ruby-identifier">format</span> = <span class="ruby-identifier">aFormat</span>
-113: 
-114:       <span class="ruby-keyword kw">case</span> <span class="ruby-identifier">aFormat</span>
-115:         <span class="ruby-keyword kw">when</span> <span class="ruby-constant">VpiBinStrVal</span>, <span class="ruby-constant">VpiOctStrVal</span>, <span class="ruby-constant">VpiDecStrVal</span>, <span class="ruby-constant">VpiHexStrVal</span>, <span class="ruby-constant">VpiStringVal</span>
-116:           <span class="ruby-identifier">newVal</span>.<span class="ruby-identifier">value</span>.<span class="ruby-identifier">str</span> = <span class="ruby-identifier">aValue</span>.<span class="ruby-identifier">to_s</span>
-117: 
-118:         <span class="ruby-keyword kw">when</span> <span class="ruby-constant">VpiScalarVal</span>
-119:           <span class="ruby-identifier">newVal</span>.<span class="ruby-identifier">value</span>.<span class="ruby-identifier">scalar</span> = <span class="ruby-identifier">aValue</span>
-120: 
-121:         <span class="ruby-keyword kw">when</span> <span class="ruby-constant">VpiIntVal</span>
-122:           <span class="ruby-identifier">newVal</span>.<span class="ruby-identifier">format</span> = <span class="ruby-constant">VpiHexStrVal</span>
-123:           <span class="ruby-identifier">newVal</span>.<span class="ruby-identifier">value</span>.<span class="ruby-identifier">str</span> = <span class="ruby-identifier">aValue</span>.<span class="ruby-identifier">to_i</span>.<span class="ruby-identifier">to_s</span>(<span class="ruby-value">16</span>)
-124: 
-125:         <span class="ruby-keyword kw">when</span> <span class="ruby-constant">VpiRealVal</span>
-126:           <span class="ruby-identifier">newVal</span>.<span class="ruby-identifier">value</span>.<span class="ruby-identifier">real</span> = <span class="ruby-identifier">aValue</span>.<span class="ruby-identifier">to_f</span>
-127: 
-128:         <span class="ruby-keyword kw">when</span> <span class="ruby-constant">VpiTimeVal</span>
-129:           <span class="ruby-identifier">newVal</span>.<span class="ruby-identifier">value</span>.<span class="ruby-identifier">time</span> = <span class="ruby-identifier">aValue</span>
-130: 
-131:         <span class="ruby-keyword kw">when</span> <span class="ruby-constant">VpiVectorVal</span>
-132:           <span class="ruby-identifier">newVal</span>.<span class="ruby-identifier">value</span>.<span class="ruby-identifier">vector</span> = <span class="ruby-identifier">aValue</span>
-133: 
-134:         <span class="ruby-keyword kw">when</span> <span class="ruby-constant">VpiStrengthVal</span>
-135:           <span class="ruby-identifier">newVal</span>.<span class="ruby-identifier">value</span>.<span class="ruby-identifier">strength</span> = <span class="ruby-identifier">aValue</span>
-136: 
-137:         <span class="ruby-keyword kw">else</span>
-138:           <span class="ruby-identifier">raise</span> <span class="ruby-node">&quot;unknown S_vpi_value.format: #{newVal.format}&quot;</span>
-139:       <span class="ruby-keyword kw">end</span>
-140: 
-141:       <span class="ruby-identifier">vpi_put_value</span> <span class="ruby-keyword kw">self</span>, <span class="ruby-identifier">newVal</span>, <span class="ruby-identifier">aTime</span>, <span class="ruby-identifier">aDelay</span>
-142: 
-143:       <span class="ruby-comment cmt"># ensure that value was written correctly</span>
-144:         <span class="ruby-identifier">readenVal</span> = <span class="ruby-identifier">get_value</span>(<span class="ruby-identifier">aFormat</span>)
-145: 
-146:         <span class="ruby-identifier">writtenCorrectly</span> =
-147:           <span class="ruby-keyword kw">case</span> <span class="ruby-identifier">aFormat</span>
-148:             <span class="ruby-keyword kw">when</span> <span class="ruby-constant">VpiBinStrVal</span>, <span class="ruby-constant">VpiOctStrVal</span>, <span class="ruby-constant">VpiDecStrVal</span>, <span class="ruby-constant">VpiHexStrVal</span>
-149:               <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">aValue</span> <span class="ruby-operator">=~</span> <span class="ruby-regexp re">/[xz]/i</span>  <span class="ruby-comment cmt"># TODO: verify 'z' behavior</span>
-150:                 <span class="ruby-identifier">readenVal</span> <span class="ruby-operator">=~</span> <span class="ruby-regexp re">/[xz]/i</span>
-151:               <span class="ruby-keyword kw">else</span>
-152:                 <span class="ruby-identifier">readenVal</span> <span class="ruby-operator">==</span> <span class="ruby-identifier">aValue</span>.<span class="ruby-identifier">to_s</span>
-153:               <span class="ruby-keyword kw">end</span>
-154: 
-155:             <span class="ruby-keyword kw">when</span> <span class="ruby-constant">VpiStringVal</span>
-156:               <span class="ruby-identifier">readenVal</span> <span class="ruby-operator">==</span> <span class="ruby-identifier">aValue</span>.<span class="ruby-identifier">to_s</span>
-157: 
-158:             <span class="ruby-keyword kw">when</span> <span class="ruby-constant">VpiIntVal</span>
-159:               <span class="ruby-comment cmt"># allow for register overflow when limit reached</span>
-160:               <span class="ruby-identifier">readenVal</span> <span class="ruby-operator">==</span> (<span class="ruby-identifier">aValue</span>.<span class="ruby-identifier">to_i</span> <span class="ruby-operator">%</span> (<span class="ruby-value">2</span> <span class="ruby-operator">**</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">vpiSize</span>))
-161: 
-162:             <span class="ruby-keyword kw">when</span> <span class="ruby-constant">VpiRealVal</span>
-163:               <span class="ruby-identifier">readenVal</span> <span class="ruby-operator">==</span> <span class="ruby-identifier">aValue</span>.<span class="ruby-identifier">to_f</span>
-164: 
-165:             <span class="ruby-keyword kw">else</span>
-166:               <span class="ruby-keyword kw">true</span>
-167:           <span class="ruby-keyword kw">end</span>
-168: 
-169:         <span class="ruby-keyword kw">unless</span> <span class="ruby-identifier">writtenCorrectly</span>
-170:           <span class="ruby-identifier">raise</span> <span class="ruby-node">&quot;value written (#{aValue.inspect}) does not match value read (#{readenVal.inspect}) from handle #{self}&quot;</span>
-171:         <span class="ruby-keyword kw">end</span>
-172: 
-173:       <span class="ruby-identifier">aValue</span>
-174:     <span class="ruby-keyword kw">end</span></pre>
+  <pre>    <span class="ruby-comment cmt"># File lib/ruby-vpi/vpi.rb, line 73</span>
+73:     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">get_value_wrapper</span> <span class="ruby-identifier">aFormat</span>
+74:       <span class="ruby-identifier">val</span> = <span class="ruby-constant">S_vpi_value</span>.<span class="ruby-identifier">new</span>
+75:       <span class="ruby-identifier">val</span>.<span class="ruby-identifier">format</span> = <span class="ruby-identifier">aFormat</span>
+76: 
+77:       <span class="ruby-identifier">vpi_get_value</span> <span class="ruby-keyword kw">self</span>, <span class="ruby-identifier">val</span>
+78:       <span class="ruby-identifier">val</span>
+79:     <span class="ruby-keyword kw">end</span></pre>
 </body>
 </html>

data/ref/ruby/classes/Vpi/Handle.src/M000092.html

@@ -5,26 +5,40 @@
 
 <html>
 <head>
-  <title>[] (Vpi::Handle)</title>
+  <title>get_value (Vpi::Handle)</title>
   <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
   <link rel="stylesheet" href="../../.././rdoc-style.css" type="text/css" media="screen" />
 </head>
 <body class="standalone-code">
-  <pre>     <span class="ruby-comment cmt"># File lib/ruby-vpi/vpi.rb, line 177</span>
-177:     <span class="ruby-keyword kw">def</span> <span class="ruby-operator">[]</span> <span class="ruby-operator">*</span><span class="ruby-identifier">aTypes</span>
-178:       <span class="ruby-identifier">handles</span> = []
-179: 
-180:       <span class="ruby-identifier">aTypes</span>.<span class="ruby-identifier">each</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">t</span><span class="ruby-operator">|</span>
-181:         <span class="ruby-identifier">t</span> = <span class="ruby-identifier">resolve_prop_type</span>(<span class="ruby-identifier">t</span>)
-182: 
-183:         <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">itr</span> = <span class="ruby-identifier">vpi_iterate</span>(<span class="ruby-identifier">t</span>, <span class="ruby-keyword kw">self</span>)
-184:           <span class="ruby-keyword kw">while</span> <span class="ruby-identifier">h</span> = <span class="ruby-identifier">vpi_scan</span>(<span class="ruby-identifier">itr</span>)
-185:             <span class="ruby-identifier">handles</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-identifier">h</span>
-186:           <span class="ruby-keyword kw">end</span>
-187:         <span class="ruby-keyword kw">end</span>
-188:       <span class="ruby-keyword kw">end</span>
-189: 
-190:       <span class="ruby-identifier">handles</span>
-191:     <span class="ruby-keyword kw">end</span></pre>
+  <pre>     <span class="ruby-comment cmt"># File lib/ruby-vpi/vpi.rb, line 82</span>
+ 82:     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">get_value</span> <span class="ruby-identifier">aFormat</span> = <span class="ruby-constant">VpiObjTypeVal</span>
+ 83:       <span class="ruby-identifier">val</span> = <span class="ruby-identifier">get_value_wrapper</span>(<span class="ruby-identifier">resolve_prop_type</span>(<span class="ruby-identifier">aFormat</span>))
+ 84: 
+ 85:       <span class="ruby-keyword kw">case</span> <span class="ruby-identifier">val</span>.<span class="ruby-identifier">format</span>
+ 86:         <span class="ruby-keyword kw">when</span> <span class="ruby-constant">VpiBinStrVal</span>, <span class="ruby-constant">VpiOctStrVal</span>, <span class="ruby-constant">VpiDecStrVal</span>, <span class="ruby-constant">VpiHexStrVal</span>, <span class="ruby-constant">VpiStringVal</span>
+ 87:           <span class="ruby-identifier">val</span>.<span class="ruby-identifier">value</span>.<span class="ruby-identifier">str</span>
+ 88: 
+ 89:         <span class="ruby-keyword kw">when</span> <span class="ruby-constant">VpiScalarVal</span>
+ 90:           <span class="ruby-identifier">val</span>.<span class="ruby-identifier">value</span>.<span class="ruby-identifier">scalar</span>
+ 91: 
+ 92:         <span class="ruby-keyword kw">when</span> <span class="ruby-constant">VpiIntVal</span>
+ 93:           <span class="ruby-identifier">get_value_wrapper</span>(<span class="ruby-constant">VpiHexStrVal</span>).<span class="ruby-identifier">value</span>.<span class="ruby-identifier">str</span>.<span class="ruby-identifier">to_i</span>(<span class="ruby-value">16</span>)
+ 94: 
+ 95:         <span class="ruby-keyword kw">when</span> <span class="ruby-constant">VpiRealVal</span>
+ 96:           <span class="ruby-identifier">val</span>.<span class="ruby-identifier">value</span>.<span class="ruby-identifier">real</span>
+ 97: 
+ 98:         <span class="ruby-keyword kw">when</span> <span class="ruby-constant">VpiTimeVal</span>
+ 99:           <span class="ruby-identifier">val</span>.<span class="ruby-identifier">value</span>.<span class="ruby-identifier">time</span>
+100: 
+101:         <span class="ruby-keyword kw">when</span> <span class="ruby-constant">VpiVectorVal</span>
+102:           <span class="ruby-identifier">val</span>.<span class="ruby-identifier">value</span>.<span class="ruby-identifier">vector</span>
+103: 
+104:         <span class="ruby-keyword kw">when</span> <span class="ruby-constant">VpiStrengthVal</span>
+105:           <span class="ruby-identifier">val</span>.<span class="ruby-identifier">value</span>.<span class="ruby-identifier">strength</span>
+106: 
+107:         <span class="ruby-keyword kw">else</span>
+108:           <span class="ruby-identifier">raise</span> <span class="ruby-node">&quot;unknown S_vpi_value.format: #{val.format}&quot;</span>
+109:       <span class="ruby-keyword kw">end</span>
+110:     <span class="ruby-keyword kw">end</span></pre>
 </body>
 </html>

data/ref/ruby/classes/Vpi/Handle.src/M000093.html

@@ -5,20 +5,83 @@
 
 <html>
 <head>
-  <title>inspect (Vpi::Handle)</title>
+  <title>put_value (Vpi::Handle)</title>
   <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
   <link rel="stylesheet" href="../../.././rdoc-style.css" type="text/css" media="screen" />
 </head>
 <body class="standalone-code">
-  <pre>     <span class="ruby-comment cmt"># File lib/ruby-vpi/vpi.rb, line 194</span>
-194:     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">inspect</span> <span class="ruby-operator">*</span><span class="ruby-identifier">aPropNames</span>
-195:       <span class="ruby-identifier">aPropNames</span>.<span class="ruby-identifier">unshift</span> <span class="ruby-identifier">:fullName</span>, <span class="ruby-identifier">:size</span>, <span class="ruby-identifier">:file</span>, <span class="ruby-identifier">:lineNo</span>
-196: 
-197:       <span class="ruby-identifier">aPropNames</span>.<span class="ruby-identifier">map!</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">name</span><span class="ruby-operator">|</span>
-198:         <span class="ruby-node">&quot;#{name}=#{self.send(name.to_sym)}&quot;</span>
-199:       <span class="ruby-keyword kw">end</span>
-200: 
-201:       <span class="ruby-node">&quot;#&lt;Vpi::Handle #{vpiType_s} #{aPropNames.join(', ')}&gt;&quot;</span>
-202:     <span class="ruby-keyword kw">end</span></pre>
+  <pre>     <span class="ruby-comment cmt"># File lib/ruby-vpi/vpi.rb, line 113</span>
+113:     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">put_value</span> <span class="ruby-identifier">aValue</span>, <span class="ruby-identifier">aFormat</span> = <span class="ruby-keyword kw">nil</span>, <span class="ruby-identifier">aTime</span> = <span class="ruby-keyword kw">nil</span>, <span class="ruby-identifier">aDelay</span> = <span class="ruby-constant">VpiNoDelay</span>
+114:       <span class="ruby-identifier">aFormat</span> =
+115:         <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">aFormat</span>
+116:           <span class="ruby-identifier">resolve_prop_type</span>(<span class="ruby-identifier">aFormat</span>)
+117:         <span class="ruby-keyword kw">else</span>
+118:           <span class="ruby-identifier">get_value_wrapper</span>(<span class="ruby-constant">VpiObjTypeVal</span>).<span class="ruby-identifier">format</span>
+119:         <span class="ruby-keyword kw">end</span>
+120: 
+121:       <span class="ruby-identifier">newVal</span> = <span class="ruby-constant">S_vpi_value</span>.<span class="ruby-identifier">new</span>
+122:       <span class="ruby-identifier">newVal</span>.<span class="ruby-identifier">format</span> = <span class="ruby-identifier">aFormat</span>
+123: 
+124:       <span class="ruby-keyword kw">case</span> <span class="ruby-identifier">aFormat</span>
+125:         <span class="ruby-keyword kw">when</span> <span class="ruby-constant">VpiBinStrVal</span>, <span class="ruby-constant">VpiOctStrVal</span>, <span class="ruby-constant">VpiDecStrVal</span>, <span class="ruby-constant">VpiHexStrVal</span>, <span class="ruby-constant">VpiStringVal</span>
+126:           <span class="ruby-identifier">newVal</span>.<span class="ruby-identifier">value</span>.<span class="ruby-identifier">str</span> = <span class="ruby-identifier">aValue</span>.<span class="ruby-identifier">to_s</span>
+127: 
+128:         <span class="ruby-keyword kw">when</span> <span class="ruby-constant">VpiScalarVal</span>
+129:           <span class="ruby-identifier">newVal</span>.<span class="ruby-identifier">value</span>.<span class="ruby-identifier">scalar</span> = <span class="ruby-identifier">aValue</span>
+130: 
+131:         <span class="ruby-keyword kw">when</span> <span class="ruby-constant">VpiIntVal</span>
+132:           <span class="ruby-identifier">newVal</span>.<span class="ruby-identifier">format</span> = <span class="ruby-constant">VpiHexStrVal</span>
+133:           <span class="ruby-identifier">newVal</span>.<span class="ruby-identifier">value</span>.<span class="ruby-identifier">str</span> = <span class="ruby-identifier">aValue</span>.<span class="ruby-identifier">to_i</span>.<span class="ruby-identifier">to_s</span>(<span class="ruby-value">16</span>)
+134: 
+135:         <span class="ruby-keyword kw">when</span> <span class="ruby-constant">VpiRealVal</span>
+136:           <span class="ruby-identifier">newVal</span>.<span class="ruby-identifier">value</span>.<span class="ruby-identifier">real</span> = <span class="ruby-identifier">aValue</span>.<span class="ruby-identifier">to_f</span>
+137: 
+138:         <span class="ruby-keyword kw">when</span> <span class="ruby-constant">VpiTimeVal</span>
+139:           <span class="ruby-identifier">newVal</span>.<span class="ruby-identifier">value</span>.<span class="ruby-identifier">time</span> = <span class="ruby-identifier">aValue</span>
+140: 
+141:         <span class="ruby-keyword kw">when</span> <span class="ruby-constant">VpiVectorVal</span>
+142:           <span class="ruby-identifier">newVal</span>.<span class="ruby-identifier">value</span>.<span class="ruby-identifier">vector</span> = <span class="ruby-identifier">aValue</span>
+143: 
+144:         <span class="ruby-keyword kw">when</span> <span class="ruby-constant">VpiStrengthVal</span>
+145:           <span class="ruby-identifier">newVal</span>.<span class="ruby-identifier">value</span>.<span class="ruby-identifier">strength</span> = <span class="ruby-identifier">aValue</span>
+146: 
+147:         <span class="ruby-keyword kw">else</span>
+148:           <span class="ruby-identifier">raise</span> <span class="ruby-node">&quot;unknown S_vpi_value.format: #{newVal.format}&quot;</span>
+149:       <span class="ruby-keyword kw">end</span>
+150: 
+151:       <span class="ruby-identifier">vpi_put_value</span> <span class="ruby-keyword kw">self</span>, <span class="ruby-identifier">newVal</span>, <span class="ruby-identifier">aTime</span>, <span class="ruby-identifier">aDelay</span>
+152: 
+153:       <span class="ruby-comment cmt"># ensure that value was written correctly</span>
+154:         <span class="ruby-identifier">readenVal</span> = <span class="ruby-identifier">get_value</span>(<span class="ruby-identifier">aFormat</span>)
+155: 
+156:         <span class="ruby-identifier">writtenCorrectly</span> =
+157:           <span class="ruby-keyword kw">case</span> <span class="ruby-identifier">aFormat</span>
+158:             <span class="ruby-keyword kw">when</span> <span class="ruby-constant">VpiBinStrVal</span>, <span class="ruby-constant">VpiOctStrVal</span>, <span class="ruby-constant">VpiDecStrVal</span>, <span class="ruby-constant">VpiHexStrVal</span>
+159:               <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">aValue</span> <span class="ruby-operator">=~</span> <span class="ruby-regexp re">/[xz]/i</span>  <span class="ruby-comment cmt"># TODO: verify 'z' behavior</span>
+160:                 <span class="ruby-identifier">readenVal</span> <span class="ruby-operator">=~</span> <span class="ruby-regexp re">/[xz]/i</span>
+161:               <span class="ruby-keyword kw">else</span>
+162:                 <span class="ruby-identifier">readenVal</span> <span class="ruby-operator">==</span> <span class="ruby-identifier">aValue</span>.<span class="ruby-identifier">to_s</span>
+163:               <span class="ruby-keyword kw">end</span>
+164: 
+165:             <span class="ruby-keyword kw">when</span> <span class="ruby-constant">VpiStringVal</span>
+166:               <span class="ruby-identifier">readenVal</span> <span class="ruby-operator">==</span> <span class="ruby-identifier">aValue</span>.<span class="ruby-identifier">to_s</span>
+167: 
+168:             <span class="ruby-keyword kw">when</span> <span class="ruby-constant">VpiIntVal</span>
+169:               <span class="ruby-comment cmt"># allow for register overflow when limit reached</span>
+170:               <span class="ruby-identifier">readenVal</span> <span class="ruby-operator">==</span> (<span class="ruby-identifier">aValue</span>.<span class="ruby-identifier">to_i</span> <span class="ruby-operator">%</span> (<span class="ruby-value">2</span> <span class="ruby-operator">**</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">vpiSize</span>))
+171: 
+172:             <span class="ruby-keyword kw">when</span> <span class="ruby-constant">VpiRealVal</span>
+173:               <span class="ruby-identifier">readenVal</span> <span class="ruby-operator">==</span> <span class="ruby-identifier">aValue</span>.<span class="ruby-identifier">to_f</span>
+174: 
+175:             <span class="ruby-keyword kw">else</span>
+176:               <span class="ruby-keyword kw">true</span>
+177:           <span class="ruby-keyword kw">end</span>
+178: 
+179:         <span class="ruby-keyword kw">unless</span> <span class="ruby-identifier">writtenCorrectly</span>
+180:           <span class="ruby-identifier">raise</span> <span class="ruby-node">&quot;value written (#{aValue.inspect}) does not match value read (#{readenVal.inspect}) from handle #{self}&quot;</span>
+181:         <span class="ruby-keyword kw">end</span>
+182: 
+183:       <span class="ruby-identifier">aValue</span>
+184:     <span class="ruby-keyword kw">end</span></pre>
 </body>
 </html>