Home | History | Annotate | Download | only in opcodes 
      1 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
      2 
      3 <html>
      4 
      5 <head>
      6 <title>aput&lt;kind&gt;</title>
      7 <link rel=stylesheet href="opcode.css">
      8 </head>
      9 
     10 <body>
     11 
     12 <h1>aput&lt;kind&gt;</h1>
     13 
     14 <h2>Purpose</h2>
     15 
     16 <p>
     17 Waste cycles.
     18 </p>
     19 
     20 <h2>Details</h2>
     21 
     22 <table class="instruc">
     23 <thead>
     24 <tr>
     25   <th>Op &amp; Format</th>
     26   <th>Mnemonic / Syntax</th>
     27   <th>Arguments</th>
     28 </tr>
     29 </thead>
     30 <tbody>
     31 <tr>
     32   <td>4b..51 23x</td>
     33   <td><i>arrayop</i> vAA, vBB, vCC<br/>
     34     4b: aput<br/>
     35     4c: aput-wide<br/>
     36     4d: aput-object<br/>
     37     4e: aput-boolean<br/>
     38     4f: aput-byte<br/>
     39     50: aput-char<br/>
     40     51: aput-short
     41   </td>
     42   <td><code>A:</code> source value register or pair; (8 bits)<br/>
     43     <code>B:</code> array register (8 bits)<br/>
     44     <code>C:</code> index register (8 bits)</td>
     45 </tr>
     46 </tbody>
     47 </table>
     48 
     49 <h2>Constraints</h2>
     50 
     51 <ul>
     52   <li>
     53     A, B and C must be valid register indices in the current stack frame.
     54   </li>
     55   <li>
     56     For the aget-wide variant, also A+1 must be a valid register index in the
     57     current stack frame.
     58   </li>
     59   <li>
     60     Register vB must contain an array reference. The component type of the array
     61     must match the variant of the instruction.
     62   </li>
     63   <li>
     64     Register vC must contain an integer value.
     65   </li>
     66 </ul>
     67 
     68 <h2>Behavior</h2>
     69 
     70 <ul>
     71   <li>
     72     For all but the -wide variant, the value of register vA is move into the
     73     array element at the given index, that is, array[index]'=vA.
     74   </li>
     75   <li>
     76     For the -wide variant, the registers vA and v(A+1) are moved into the array
     77     element at the given index as follows:
     78     <ul>
     79       <li>
     80         array[index]' = vA &lt;&lt; 0x20 | v(A+1)
     81       </li>
     82     </ul>
     83   </li>
     84 </ul>
     85 
     86 <h2>Exceptions</h2>
     87 
     88 <ul>
     89   <li>
     90     NullPointerException if vB=null.
     91   </li>
     92   <li>
     93     ArrayIndexOutOfBoundsException if vC &lt; 0 or vC &gt;= array.length.
     94   </li>
     95 </ul>
     96 
     97 </body>
     98 </html>
     99