cetus.hir

Class NestedDeclarator

java.lang.Object

cetus.hir.Declarator

cetus.hir.NestedDeclarator

All Implemented Interfaces:

Printable, Symbol, Traversable, java.lang.Cloneable

public class NestedDeclarator
extends Declarator
implements Symbol

Represents a nested declarator that may contain another declarator within itself. e.g., function pointers and pointers to a chunck of arrays.

Constructor Summary

Constructors

Constructor and Description
NestedDeclarator(Declarator nested_decl) Constructs a new nested declarator with the given child declarator.
NestedDeclarator(Declarator nested_decl, java.util.List params) Constructs a new nested declarator with the given child declarator and the list of parameters.
NestedDeclarator(java.util.List leading_specs, Declarator nested_decl, java.util.List params) Constructs a new nested declarator with the given list of leading specifiers, the child declarator, and the list of parameters.
NestedDeclarator(java.util.List leading_specs, Declarator nested_decl, java.util.List params, java.util.List trailing_specs) Constructs a new nested declarator with the given list of leading specifers, the child declarator, the list of parameters, and the list of trailing specifiers.
NestedDeclarator(Specifier spec, Declarator nested_decl, java.util.List params) Constructs a new nested declarator with the given leading specifier, the child declarator, and the list of parameters.

Method Summary

Methods

Modifier and Type	Method and Description
void	addParameter(Declaration decl) Inserts a new parameter declaration to the nested declarator.
void	addParameterAfter(Declaration ref, Declaration decl) Inserts a new parameter declaration to the nested declarator after the reference parameter declaration.
void	addParameterBefore(Declaration ref, Declaration decl) Inserts a new parameter declaration to the nested declarator before the reference parameter declaration.
NestedDeclarator	clone() Returns a clone of the nested declarator.
static void	defaultPrint(NestedDeclarator d, java.io.PrintWriter o) Prints a nested declarator to a stream.
java.util.List	getArraySpecifiers() Returns the list of specifiers trailing the declarator.
Declaration	getDeclaration() Returns the parent declaration containing the symbol object.
Declarator	getDeclarator() Returns the child declarator of the nested declarator.
IDExpression	getID() Returns the name ID declared by the nested declarator.
Initializer	getInitializer() Returns the initializer of the nested declarator.
java.util.List<Declaration>	getParameters() Returns the list of parameters if the declarator represents a function.
java.lang.String	getSymbolName() Returns the name of the symbol.
java.util.List	getTypeSpecifiers() Returns a list of type specifiers.
boolean	isProcedure() Checks if the nested declarator is used to represent a procedure call.
static void	setClassPrintMethod(java.lang.reflect.Method m) Overrides the class print method, so that all subsequently created objects will use the supplied method.
void	setInitializer(Initializer init) Assigns a new initializer for the nested declarator.
void	setName(java.lang.String name) Modify the name of the symbol.

Methods inherited from class cetus.hir.Declarator

addTrailingSpecifier, defaultPrint, equals, getChildren, getParameter, getParent, getSpecifiers, hashCode, print, removeChild, setChild, setParent, toString

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

NestedDeclarator

public NestedDeclarator(Declarator nested_decl)

Constructs a new nested declarator with the given child declarator.

Parameters:

nested_decl - the child declarator to be added.

NestedDeclarator

public NestedDeclarator(Declarator nested_decl,
                java.util.List params)

Constructs a new nested declarator with the given child declarator and the list of parameters.

Parameters:

nested_decl - the child declarator to be added.

params - the list of parameters.

NestedDeclarator

public NestedDeclarator(java.util.List leading_specs,
                Declarator nested_decl,
                java.util.List params)

Constructs a new nested declarator with the given list of leading specifiers, the child declarator, and the list of parameters.

Parameters:

leading_specs - the list of leading specifiers.

nested_decl - the child declarator to be added.

params - the list of parameters.

NestedDeclarator

public NestedDeclarator(Specifier spec,
                Declarator nested_decl,
                java.util.List params)

Constructs a new nested declarator with the given leading specifier, the child declarator, and the list of parameters.

Parameters:

spec - the leading specifier.

nested_decl - the child declarator to be added.

params - the list of parameters.

NestedDeclarator

public NestedDeclarator(java.util.List leading_specs,
                Declarator nested_decl,
                java.util.List params,
                java.util.List trailing_specs)

Constructs a new nested declarator with the given list of leading specifers, the child declarator, the list of parameters, and the list of trailing specifiers.

Parameters:

leading_specs - the list of leading specifiers.

nested_decl - the child declarator to be added.

params - the list of parameters.

trailing_specs - the list of trailing specifiers.

Method Detail

addParameter

public void addParameter(Declaration decl)

Inserts a new parameter declaration to the nested declarator.

Specified by:

addParameter in class Declarator

Parameters:

decl - the new parameter declaration to be added.

addParameterBefore

public void addParameterBefore(Declaration ref,
                      Declaration decl)

Inserts a new parameter declaration to the nested declarator before the reference parameter declaration.

Specified by:

addParameterBefore in class Declarator

Parameters:

ref - the reference parameter declaration.

decl - the new parameter declaration to be added.

addParameterAfter

public void addParameterAfter(Declaration ref,
                     Declaration decl)

Inserts a new parameter declaration to the nested declarator after the reference parameter declaration.

Specified by:

addParameterAfter in class Declarator

Parameters:

ref - the reference parameter declaration.

decl - the new parameter declaration to be added.

clone

public NestedDeclarator clone()

Returns a clone of the nested declarator.

Overrides:

clone in class Declarator

defaultPrint

public static void defaultPrint(NestedDeclarator d,
                java.io.PrintWriter o)

Prints a nested declarator to a stream.

Parameters:

d - The declarator to print.

o - The writer on which to print the declarator.

getDeclarator

public Declarator getDeclarator()

Returns the child declarator of the nested declarator.

getParameters

public java.util.List<Declaration> getParameters()

Returns the list of parameters if the declarator represents a function.

Specified by:

getParameters in class Declarator

Returns:

the list of parameters if it does, null otherwise.

getID

public IDExpression getID()

Returns the name ID declared by the nested declarator.

Specified by:

getID in class Declarator

Returns:

the name ID of the declarator.

setClassPrintMethod

public static void setClassPrintMethod(java.lang.reflect.Method m)

Overrides the class print method, so that all subsequently created objects will use the supplied method.

Parameters:

m - The new print method.

getInitializer

public Initializer getInitializer()

Returns the initializer of the nested declarator.

Overrides:

getInitializer in class Declarator

Returns:

the initializer if exists, null otherwise.

setInitializer

public void setInitializer(Initializer init)

Assigns a new initializer for the nested declarator. The existing initializer is dicarded.

Overrides:

setInitializer in class Declarator

Parameters:

init - An initial value for the variable.

isProcedure

public boolean isProcedure()

Checks if the nested declarator is used to represent a procedure call.

getTypeSpecifiers

public java.util.List getTypeSpecifiers()

Description copied from interface: Symbol

Returns a list of type specifiers.

Specified by:

getTypeSpecifiers in interface Symbol

Returns:

the list of type specifiers.

getSymbolName

public java.lang.String getSymbolName()

Description copied from interface: Symbol

Returns the name of the symbol.

Specified by:

getSymbolName in interface Symbol

Returns:

the name of the symbol.

getArraySpecifiers

public java.util.List getArraySpecifiers()

Description copied from class: Declarator

Returns the list of specifiers trailing the declarator.

Specified by:

getArraySpecifiers in interface Symbol

Overrides:

getArraySpecifiers in class Declarator

Returns:

the trailing specifiers.

setName

public void setName(java.lang.String name)

Description copied from interface: Symbol

Modify the name of the symbol. This method effectively renames all the identifiers constructed from the symbol object. Pass writers should be cautious when renaming global names since the effective scope of this operation is within a translation unit; extern variables and procedure names are not automatically handled.

Specified by:

setName in interface Symbol

Parameters:

name - the new name of the symbol.

getDeclaration

public Declaration getDeclaration()

Description copied from interface: Symbol

Returns the parent declaration containing the symbol object. The return value is searched from the internal look-up table. Depending on the type of the symbol, this method may return the symbol object itself, or null if the symbol object does not exist in the IR.

Specified by:

getDeclaration in interface Symbol

Returns:

the parent declaration.