1. package com.sun.org.apache.bcel.internal.classfile;
  2. /* ====================================================================
  3. * The Apache Software License, Version 1.1
  4. *
  5. * Copyright (c) 2001 The Apache Software Foundation. All rights
  6. * reserved.
  7. *
  8. * Redistribution and use in source and binary forms, with or without
  9. * modification, are permitted provided that the following conditions
  10. * are met:
  11. *
  12. * 1. Redistributions of source code must retain the above copyright
  13. * notice, this list of conditions and the following disclaimer.
  14. *
  15. * 2. Redistributions in binary form must reproduce the above copyright
  16. * notice, this list of conditions and the following disclaimer in
  17. * the documentation and/or other materials provided with the
  18. * distribution.
  19. *
  20. * 3. The end-user documentation included with the redistribution,
  21. * if any, must include the following acknowledgment:
  22. * "This product includes software developed by the
  23. * Apache Software Foundation (http://www.apache.org/)."
  24. * Alternately, this acknowledgment may appear in the software itself,
  25. * if and wherever such third-party acknowledgments normally appear.
  26. *
  27. * 4. The names "Apache" and "Apache Software Foundation" and
  28. * "Apache BCEL" must not be used to endorse or promote products
  29. * derived from this software without prior written permission. For
  30. * written permission, please contact apache@apache.org.
  31. *
  32. * 5. Products derived from this software may not be called "Apache",
  33. * "Apache BCEL", nor may "Apache" appear in their name, without
  34. * prior written permission of the Apache Software Foundation.
  35. *
  36. * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
  37. * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
  38. * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
  39. * DISCLAIMED. IN NO EVENT SHALL THE APACHE SOFTWARE FOUNDATION OR
  40. * ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
  41. * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
  42. * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
  43. * USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
  44. * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
  45. * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
  46. * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  47. * SUCH DAMAGE.
  48. * ====================================================================
  49. *
  50. * This software consists of voluntary contributions made by many
  51. * individuals on behalf of the Apache Software Foundation. For more
  52. * information on the Apache Software Foundation, please see
  53. * <http://www.apache.org/>.
  54. */
  55. import com.sun.org.apache.bcel.internal.Constants;
  56. import java.io.*;
  57. /**
  58. * This class represents a (PC offset, line number) pair, i.e., a line number in
  59. * the source that corresponds to a relative address in the byte code. This
  60. * is used for debugging purposes.
  61. *
  62. * @version $Id: LineNumber.java,v 1.1.1.1 2001/10/29 20:00:02 jvanzyl Exp $
  63. * @author <A HREF="mailto:markus.dahm@berlin.de">M. Dahm</A>
  64. * @see LineNumberTable
  65. */
  66. public final class LineNumber implements Cloneable, Node {
  67. private int start_pc; // Program Counter (PC) corresponds to line
  68. private int line_number; // number in source file
  69. /**
  70. * Initialize from another object.
  71. */
  72. public LineNumber(LineNumber c) {
  73. this(c.getStartPC(), c.getLineNumber());
  74. }
  75. /**
  76. * Construct object from file stream.
  77. * @param file Input stream
  78. * @throw IOException
  79. */
  80. LineNumber(DataInputStream file) throws IOException
  81. {
  82. this(file.readUnsignedShort(), file.readUnsignedShort());
  83. }
  84. /**
  85. * @param start_pc Program Counter (PC) corresponds to
  86. * @param line_number line number in source file
  87. */
  88. public LineNumber(int start_pc, int line_number)
  89. {
  90. this.start_pc = start_pc;
  91. this.line_number = line_number;
  92. }
  93. /**
  94. * Called by objects that are traversing the nodes of the tree implicitely
  95. * defined by the contents of a Java class. I.e., the hierarchy of methods,
  96. * fields, attributes, etc. spawns a tree of objects.
  97. *
  98. * @param v Visitor object
  99. */
  100. public void accept(Visitor v) {
  101. v.visitLineNumber(this);
  102. }
  103. /**
  104. * Dump line number/pc pair to file stream in binary format.
  105. *
  106. * @param file Output file stream
  107. * @throw IOException
  108. */
  109. public final void dump(DataOutputStream file) throws IOException
  110. {
  111. file.writeShort(start_pc);
  112. file.writeShort(line_number);
  113. }
  114. /**
  115. * @return Corresponding source line
  116. */
  117. public final int getLineNumber() { return line_number; }
  118. /**
  119. * @return PC in code
  120. */
  121. public final int getStartPC() { return start_pc; }
  122. /**
  123. * @param line_number.
  124. */
  125. public final void setLineNumber(int line_number) {
  126. this.line_number = line_number;
  127. }
  128. /**
  129. * @param start_pc.
  130. */
  131. public final void setStartPC(int start_pc) {
  132. this.start_pc = start_pc;
  133. }
  134. /**
  135. * @return String representation
  136. */
  137. public final String toString() {
  138. return "LineNumber(" + start_pc + ", " + line_number + ")";
  139. }
  140. /**
  141. * @return deep copy of this object
  142. */
  143. public LineNumber copy() {
  144. try {
  145. return (LineNumber)clone();
  146. } catch(CloneNotSupportedException e) {}
  147. return null;
  148. }
  149. }