Changes:
[phpeclipse.git] / net.sourceforge.phpeclipse / src / net / sourceforge / phpdt / internal / compiler / ast / AstNode.java
index e686abf..e7ed112 100644 (file)
@@ -1,30 +1,89 @@
 package net.sourceforge.phpdt.internal.compiler.ast;
 
+import java.util.List;
+
 /**
  * It will be the mother of our own ast tree for php just like the ast tree of Eclipse.
  * @author Matthieu Casanova
  */
 public abstract class AstNode {
 
+  /** Starting and ending position of the node in the sources. */
   public int sourceStart, sourceEnd;
 
   /**
+   * Create a node giving starting and ending offset
+   * @param sourceStart starting offset
+   * @param sourceEnd ending offset
+   */
+  public AstNode(final int sourceStart, final int sourceEnd) {
+    this.sourceStart = sourceStart;
+    this.sourceEnd = sourceEnd;
+  }
+
+  /**
    * Add some tabulations.
    * @param tab the number of tabulations
    * @return a String containing some spaces
    */
-  public static String tabString(int tab) {
-    StringBuffer s = new StringBuffer();
-    for (int i = tab; i > 0; i--)
+  public static String tabString(final int tab) {
+    final StringBuffer s = new StringBuffer(2 * tab);
+    for (int i = tab; i > 0; i--) {
       s.append("  "); //$NON-NLS-1$
+    }
     return s.toString();
   }
 
+  /**
+   * Return the object into String.
+   * It should be overriden
+   * @return a String
+   */
   public String toString() {
-    return toString(0);
+    return "****" + super.toString() + "****";  //$NON-NLS-2$ //$NON-NLS-1$
   }
 
-  public String toString(int tab) {
-    return "****" + super.toString() + "****";  //$NON-NLS-2$ //$NON-NLS-1$
+  /**
+   * Return the object into String.
+   * @param tab how many tabs (not used here
+   * @return a String
+   */
+  public abstract String toString(int tab);
+
+  /**
+   * Get the variables from outside (parameters, globals ...)
+   */
+  public abstract void getOutsideVariable(List list);
+
+  /**
+   * get the modified variables.
+   */
+  public abstract void getModifiedVariable(List list);
+
+  /**
+   * Get the variables used.
+   */
+  public abstract void getUsedVariable(List list);
+
+  /**
+   * This method will analyze the code.
+   * by default it will do nothing
+   */
+  public void analyzeCode() {
+  }
+
+  /**
+   * Check if the array array contains the object o
+   * @param array an array
+   * @param o an obejct
+   * @return true if the array contained the object o
+   */
+  public boolean arrayContains(Object[] array, Object o) {
+    for (int i = 0; i < array.length; i++) {
+      if (array[i].equals(o)) {
+        return true;
+      }
+    }
+    return false;
   }
 }