View Javadoc
1   /*
2    * Licensed to the Apache Software Foundation (ASF) under one or more
3    * contributor license agreements.  See the NOTICE file distributed with
4    * this work for additional information regarding copyright ownership.
5    * The ASF licenses this file to You under the Apache License, Version 2.0
6    * (the "License"); you may not use this file except in compliance with
7    * the License.  You may obtain a copy of the License at
8    *
9    *      http://www.apache.org/licenses/LICENSE-2.0
10   *
11   *  Unless required by applicable law or agreed to in writing, software
12   *  distributed under the License is distributed on an "AS IS" BASIS,
13   *  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14   *  See the License for the specific language governing permissions and
15   *  limitations under the License.
16   *
17   */
18  package org.apache.bcel.generic;
19  
20  import java.io.DataOutputStream;
21  import java.io.IOException;
22  
23  import org.apache.bcel.ExceptionConst;
24  import org.apache.bcel.util.ByteSequence;
25  
26  /**
27   * NEWARRAY -  Create new array of basic type (int, short, ...)
28   * <PRE>Stack: ..., count -&gt; ..., arrayref</PRE>
29   * type must be one of T_INT, T_SHORT, ...
30   *
31   */
32  public class NEWARRAY extends Instruction implements AllocationInstruction, ExceptionThrower,
33          StackProducer {
34  
35      private byte type;
36  
37  
38      /**
39       * Empty constructor needed for Instruction.readInstruction.
40       * Not to be used otherwise.
41       */
42      NEWARRAY() {
43      }
44  
45  
46      public NEWARRAY(final byte type) {
47          super(org.apache.bcel.Const.NEWARRAY, (short) 2);
48          this.type = type;
49      }
50  
51  
52      public NEWARRAY(final BasicType type) {
53          this(type.getType());
54      }
55  
56  
57      /**
58       * Dump instruction as byte code to stream out.
59       * @param out Output stream
60       */
61      @Override
62      public void dump( final DataOutputStream out ) throws IOException {
63          out.writeByte(super.getOpcode());
64          out.writeByte(type);
65      }
66  
67  
68      /**
69       * @return numeric code for basic element type
70       */
71      public final byte getTypecode() {
72          return type;
73      }
74  
75  
76      /**
77       * @return type of constructed array
78       */
79      public final Type getType() {
80          return new ArrayType(BasicType.getType(type), 1);
81      }
82  
83  
84      /**
85       * @return mnemonic for instruction
86       */
87      @Override
88      public String toString( final boolean verbose ) {
89          return super.toString(verbose) + " " + org.apache.bcel.Const.getTypeName(type);
90      }
91  
92  
93      /**
94       * Read needed data (e.g. index) from file.
95       */
96      @Override
97      protected void initFromFile( final ByteSequence bytes, final boolean wide ) throws IOException {
98          type = bytes.readByte();
99          super.setLength(2);
100     }
101 
102 
103     @Override
104     public Class<?>[] getExceptions() {
105         return new Class[] {
106             ExceptionConst.NEGATIVE_ARRAY_SIZE_EXCEPTION
107         };
108     }
109 
110 
111     /**
112      * Call corresponding visitor method(s). The order is:
113      * Call visitor methods of implemented interfaces first, then
114      * call methods according to the class hierarchy in descending order,
115      * i.e., the most specific visitXXX() call comes last.
116      *
117      * @param v Visitor object
118      */
119     @Override
120     public void accept( final Visitor v ) {
121         v.visitAllocationInstruction(this);
122         v.visitExceptionThrower(this);
123         v.visitStackProducer(this);
124         v.visitNEWARRAY(this);
125     }
126 }