annotate src/clojure/asm/Edge.java @ 10:ef7dbbd6452c

added clojure source goodness
author Robert McIntyre <rlm@mit.edu>
date Sat, 21 Aug 2010 06:25:44 -0400
parents
children
rev   line source
rlm@10 1 /***
rlm@10 2 * ASM: a very small and fast Java bytecode manipulation framework
rlm@10 3 * Copyright (c) 2000-2005 INRIA, France Telecom
rlm@10 4 * All rights reserved.
rlm@10 5 *
rlm@10 6 * Redistribution and use in source and binary forms, with or without
rlm@10 7 * modification, are permitted provided that the following conditions
rlm@10 8 * are met:
rlm@10 9 * 1. Redistributions of source code must retain the above copyright
rlm@10 10 * notice, this list of conditions and the following disclaimer.
rlm@10 11 * 2. Redistributions in binary form must reproduce the above copyright
rlm@10 12 * notice, this list of conditions and the following disclaimer in the
rlm@10 13 * documentation and/or other materials provided with the distribution.
rlm@10 14 * 3. Neither the name of the copyright holders nor the names of its
rlm@10 15 * contributors may be used to endorse or promote products derived from
rlm@10 16 * this software without specific prior written permission.
rlm@10 17 *
rlm@10 18 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
rlm@10 19 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
rlm@10 20 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
rlm@10 21 * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
rlm@10 22 * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
rlm@10 23 * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
rlm@10 24 * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
rlm@10 25 * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
rlm@10 26 * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
rlm@10 27 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF
rlm@10 28 * THE POSSIBILITY OF SUCH DAMAGE.
rlm@10 29 */
rlm@10 30 package clojure.asm;
rlm@10 31
rlm@10 32 /**
rlm@10 33 * An edge in the control flow graph of a method body. See {@link Label Label}.
rlm@10 34 *
rlm@10 35 * @author Eric Bruneton
rlm@10 36 */
rlm@10 37 class Edge{
rlm@10 38
rlm@10 39 /**
rlm@10 40 * Denotes a normal control flow graph edge.
rlm@10 41 */
rlm@10 42 final static int NORMAL = 0;
rlm@10 43
rlm@10 44 /**
rlm@10 45 * Denotes a control flow graph edge corresponding to an exception handler.
rlm@10 46 * More precisely any {@link Edge} whose {@link #info} is strictly positive
rlm@10 47 * corresponds to an exception handler. The actual value of {@link #info} is
rlm@10 48 * the index, in the {@link ClassWriter} type table, of the exception that
rlm@10 49 * is catched.
rlm@10 50 */
rlm@10 51 final static int EXCEPTION = 0x7FFFFFFF;
rlm@10 52
rlm@10 53 /**
rlm@10 54 * Information about this control flow graph edge. If
rlm@10 55 * {@link ClassWriter#COMPUTE_MAXS} is used this field is the (relative)
rlm@10 56 * stack size in the basic block from which this edge originates. This size
rlm@10 57 * is equal to the stack size at the "jump" instruction to which this edge
rlm@10 58 * corresponds, relatively to the stack size at the beginning of the
rlm@10 59 * originating basic block. If {@link ClassWriter#COMPUTE_FRAMES} is used,
rlm@10 60 * this field is the kind of this control flow graph edge (i.e. NORMAL or
rlm@10 61 * EXCEPTION).
rlm@10 62 */
rlm@10 63 int info;
rlm@10 64
rlm@10 65 /**
rlm@10 66 * The successor block of the basic block from which this edge originates.
rlm@10 67 */
rlm@10 68 Label successor;
rlm@10 69
rlm@10 70 /**
rlm@10 71 * The next edge in the list of successors of the originating basic block.
rlm@10 72 * See {@link Label#successors successors}.
rlm@10 73 */
rlm@10 74 Edge next;
rlm@10 75 }