• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
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>
17Waste 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