A variable description (like PHPFunctionDeclaration)
[phpeclipse.git] / net.sourceforge.phpeclipse / src / net / sourceforge / phpdt / internal / compiler / env / INameEnvironment.java
1 /*******************************************************************************
2  * Copyright (c) 2000, 2001, 2002 International Business Machines Corp. and others.
3  * All rights reserved. This program and the accompanying materials 
4  * are made available under the terms of the Common Public License v0.5 
5  * which accompanies this distribution, and is available at
6  * http://www.eclipse.org/legal/cpl-v05.html
7  * 
8  * Contributors:
9  *     IBM Corporation - initial API and implementation
10  ******************************************************************************/
11 package net.sourceforge.phpdt.internal.compiler.env;
12
13 /**
14  * The name environment provides a callback API that the compiler
15  * can use to look up types, compilation units, and packages in the
16  * current environment.  The name environment is passed to the compiler
17  * on creation.
18  */
19 public interface INameEnvironment {
20 /**
21  * Find a type with the given compound name.
22  * Answer the binary form of the type if it is known to be consistent.
23  * Otherwise, answer the compilation unit which defines the type
24  * or null if the type does not exist.
25  * Types in the default package are specified as {{typeName}}.
26  *
27  * It is unknown whether the package containing the type actually exists.
28  *
29  * NOTE: This method can be used to find a member type using its
30  * internal name A$B, but the source file for A is answered if the binary
31  * file is inconsistent.
32  */
33
34 NameEnvironmentAnswer findType(char[][] compoundTypeName);
35 /**
36  * Find a type named <typeName> in the package <packageName>.
37  * Answer the binary form of the type if it is known to be consistent.
38  * Otherwise, answer the compilation unit which defines the type
39  * or null if the type does not exist.
40  * The default package is indicated by char[0][].
41  *
42  * It is known that the package containing the type exists.
43  *
44  * NOTE: This method can be used to find a member type using its
45  * internal name A$B, but the source file for A is answered if the binary
46  * file is inconsistent.
47  */
48
49 NameEnvironmentAnswer findType(char[] typeName, char[][] packageName);
50 /**
51  * Answer whether packageName is the name of a known subpackage inside
52  * the package parentPackageName. A top level package is found relative to null.
53  * The default package is always assumed to exist.
54  *
55  * For example:
56  *      isPackage({{java}, {awt}}, {event});
57  *      isPackage(null, {java});
58  */
59
60 boolean isPackage(char[][] parentPackageName, char[] packageName);
61
62 /**
63  * This method cleans the environment uo. It is responsible for releasing the memory
64  * and freeing resources. Passed that point, the name environment is no longer usable.
65  * 
66  * A name environment can have a long life cycle, therefore it is the responsibility of
67  * the code which created it to decide when it is a good time to clean it up.
68  */
69 void cleanup();
70
71 }