package net.sourceforge.phpdt.internal.compiler.env;
/**
- * The name environment provides a callback API that the compiler
- * can use to look up types, compilation units, and packages in the
- * current environment. The name environment is passed to the compiler
- * on creation.
+ * The name environment provides a callback API that the compiler can use to
+ * look up types, compilation units, and packages in the current environment.
+ * The name environment is passed to the compiler on creation.
*/
public interface INameEnvironment {
-/**
- * Find a type with the given compound name.
- * Answer the binary form of the type if it is known to be consistent.
- * Otherwise, answer the compilation unit which defines the type
- * or null if the type does not exist.
- * Types in the default package are specified as {{typeName}}.
- *
- * It is unknown whether the package containing the type actually exists.
- *
- * NOTE: This method can be used to find a member type using its
- * internal name A$B, but the source file for A is answered if the binary
- * file is inconsistent.
- */
+ /**
+ * Find a type with the given compound name. Answer the binary form of the
+ * type if it is known to be consistent. Otherwise, answer the compilation
+ * unit which defines the type or null if the type does not exist. Types in
+ * the default package are specified as {{typeName}}.
+ *
+ * It is unknown whether the package containing the type actually exists.
+ *
+ * NOTE: This method can be used to find a member type using its internal
+ * name A$B, but the source file for A is answered if the binary file is
+ * inconsistent.
+ */
-NameEnvironmentAnswer findType(char[][] compoundTypeName);
-/**
- * Find a type named <typeName> in the package <packageName>.
- * Answer the binary form of the type if it is known to be consistent.
- * Otherwise, answer the compilation unit which defines the type
- * or null if the type does not exist.
- * The default package is indicated by char[0][].
- *
- * It is known that the package containing the type exists.
- *
- * NOTE: This method can be used to find a member type using its
- * internal name A$B, but the source file for A is answered if the binary
- * file is inconsistent.
- */
+ NameEnvironmentAnswer findType(char[][] compoundTypeName);
-NameEnvironmentAnswer findType(char[] typeName, char[][] packageName);
-/**
- * Answer whether packageName is the name of a known subpackage inside
- * the package parentPackageName. A top level package is found relative to null.
- * The default package is always assumed to exist.
- *
- * For example:
- * isPackage({{java}, {awt}}, {event});
- * isPackage(null, {java});
- */
+ /**
+ * Find a type named <typeName> in the package <packageName>. Answer the
+ * binary form of the type if it is known to be consistent. Otherwise,
+ * answer the compilation unit which defines the type or null if the type
+ * does not exist. The default package is indicated by char[0][].
+ *
+ * It is known that the package containing the type exists.
+ *
+ * NOTE: This method can be used to find a member type using its internal
+ * name A$B, but the source file for A is answered if the binary file is
+ * inconsistent.
+ */
-boolean isPackage(char[][] parentPackageName, char[] packageName);
+ NameEnvironmentAnswer findType(char[] typeName, char[][] packageName);
-/**
- * This method cleans the environment uo. It is responsible for releasing the memory
- * and freeing resources. Passed that point, the name environment is no longer usable.
- *
- * A name environment can have a long life cycle, therefore it is the responsibility of
- * the code which created it to decide when it is a good time to clean it up.
- */
-void cleanup();
+ /**
+ * Answer whether packageName is the name of a known subpackage inside the
+ * package parentPackageName. A top level package is found relative to null.
+ * The default package is always assumed to exist.
+ *
+ * For example: isPackage({{java}, {awt}}, {event}); isPackage(null,
+ * {java});
+ */
+
+ boolean isPackage(char[][] parentPackageName, char[] packageName);
+
+ /**
+ * This method cleans the environment uo. It is responsible for releasing
+ * the memory and freeing resources. Passed that point, the name environment
+ * is no longer usable.
+ *
+ * A name environment can have a long life cycle, therefore it is the
+ * responsibility of the code which created it to decide when it is a good
+ * time to clean it up.
+ */
+ void cleanup();
}