13c5df37a2df7368eb274eb097e9cfa2ccc7fffb6Dan Bornstein/*
23c5df37a2df7368eb274eb097e9cfa2ccc7fffb6Dan Bornstein * Copyright (C) 2011 The Android Open Source Project
33c5df37a2df7368eb274eb097e9cfa2ccc7fffb6Dan Bornstein *
43c5df37a2df7368eb274eb097e9cfa2ccc7fffb6Dan Bornstein * Licensed under the Apache License, Version 2.0 (the "License");
53c5df37a2df7368eb274eb097e9cfa2ccc7fffb6Dan Bornstein * you may not use this file except in compliance with the License.
63c5df37a2df7368eb274eb097e9cfa2ccc7fffb6Dan Bornstein * You may obtain a copy of the License at
73c5df37a2df7368eb274eb097e9cfa2ccc7fffb6Dan Bornstein *
83c5df37a2df7368eb274eb097e9cfa2ccc7fffb6Dan Bornstein *      http://www.apache.org/licenses/LICENSE-2.0
93c5df37a2df7368eb274eb097e9cfa2ccc7fffb6Dan Bornstein *
103c5df37a2df7368eb274eb097e9cfa2ccc7fffb6Dan Bornstein * Unless required by applicable law or agreed to in writing, software
113c5df37a2df7368eb274eb097e9cfa2ccc7fffb6Dan Bornstein * distributed under the License is distributed on an "AS IS" BASIS,
123c5df37a2df7368eb274eb097e9cfa2ccc7fffb6Dan Bornstein * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
133c5df37a2df7368eb274eb097e9cfa2ccc7fffb6Dan Bornstein * See the License for the specific language governing permissions and
143c5df37a2df7368eb274eb097e9cfa2ccc7fffb6Dan Bornstein * limitations under the License.
153c5df37a2df7368eb274eb097e9cfa2ccc7fffb6Dan Bornstein */
163c5df37a2df7368eb274eb097e9cfa2ccc7fffb6Dan Bornstein
17537939ca06a47668f719ee06159303bcd3175c69Dan Bornsteinpackage com.android.dx.io.instructions;
183c5df37a2df7368eb274eb097e9cfa2ccc7fffb6Dan Bornstein
1919cefdcde26ea31d06cef031032b2ef78013d976Dan Bornsteinimport java.io.EOFException;
2019cefdcde26ea31d06cef031032b2ef78013d976Dan Bornstein
213c5df37a2df7368eb274eb097e9cfa2ccc7fffb6Dan Bornstein/**
223c5df37a2df7368eb274eb097e9cfa2ccc7fffb6Dan Bornstein * Input stream of code units, for reading in Dalvik bytecode.
233c5df37a2df7368eb274eb097e9cfa2ccc7fffb6Dan Bornstein */
24d63837a6a16a19e3ae943cdfad52b6f6c8d04a22Dan Bornsteinpublic interface CodeInput extends CodeCursor {
2532dd826ad1742993cf0627448cd083a5021d71bbDan Bornstein    /**
2638b861bc63b91114d52ba01e74d31fbf316a5784Dan Bornstein     * Returns whether there are any more code units to read. This
2738b861bc63b91114d52ba01e74d31fbf316a5784Dan Bornstein     * is analogous to {@code hasNext()} on an interator.
2838b861bc63b91114d52ba01e74d31fbf316a5784Dan Bornstein     */
2938b861bc63b91114d52ba01e74d31fbf316a5784Dan Bornstein    public boolean hasMore();
3038b861bc63b91114d52ba01e74d31fbf316a5784Dan Bornstein
3138b861bc63b91114d52ba01e74d31fbf316a5784Dan Bornstein    /**
3219cefdcde26ea31d06cef031032b2ef78013d976Dan Bornstein     * Reads a code unit.
333c5df37a2df7368eb274eb097e9cfa2ccc7fffb6Dan Bornstein     */
3419cefdcde26ea31d06cef031032b2ef78013d976Dan Bornstein    public int read() throws EOFException;
353c5df37a2df7368eb274eb097e9cfa2ccc7fffb6Dan Bornstein
363c5df37a2df7368eb274eb097e9cfa2ccc7fffb6Dan Bornstein    /**
3719cefdcde26ea31d06cef031032b2ef78013d976Dan Bornstein     * Reads two code units, treating them as a little-endian {@code int}.
383c5df37a2df7368eb274eb097e9cfa2ccc7fffb6Dan Bornstein     */
3919cefdcde26ea31d06cef031032b2ef78013d976Dan Bornstein    public int readInt() throws EOFException;
403c5df37a2df7368eb274eb097e9cfa2ccc7fffb6Dan Bornstein
413c5df37a2df7368eb274eb097e9cfa2ccc7fffb6Dan Bornstein    /**
4219cefdcde26ea31d06cef031032b2ef78013d976Dan Bornstein     * Reads four code units, treating them as a little-endian {@code long}.
433c5df37a2df7368eb274eb097e9cfa2ccc7fffb6Dan Bornstein     */
4419cefdcde26ea31d06cef031032b2ef78013d976Dan Bornstein    public long readLong() throws EOFException;
453c5df37a2df7368eb274eb097e9cfa2ccc7fffb6Dan Bornstein}
46