Package ghidra.program.model.data

Class DataTypeComponentImpl

java.lang.Object

ghidra.program.model.data.DataTypeComponentImpl

All Implemented Interfaces:

DataTypeComponent, InternalDataTypeComponent, java.io.Serializable

public class DataTypeComponentImpl
extends java.lang.Object
implements InternalDataTypeComponent, java.io.Serializable

Basic implementation of a DataTypeComponent

See Also:

Serialized Form

Field Summary

Fields inherited from interface ghidra.program.model.data.DataTypeComponent

DEFAULT_FIELD_NAME_PREFIX

Constructor Summary

Constructors

Constructor	Description
DataTypeComponentImpl(DataType dataType, CompositeDataTypeImpl parent, int length, int ordinal, int offset)	Create a new DataTypeComponent
DataTypeComponentImpl(DataType dataType, CompositeDataTypeImpl parent, int length, int ordinal, int offset, java.lang.String fieldName, java.lang.String comment)	Create a new DataTypeComponent

Method Summary

Modifier and Type	Method	Description
static void	checkDefaultFieldName(java.lang.String fieldName)
boolean	equals(java.lang.Object obj)
java.lang.String	getComment()	Get the comment for this dataTypeComponent.
DataType	getDataType()	Returns the dataType in this component.
Settings	getDefaultSettings()	Gets the default settings for this data type component.
int	getEndOffset()	Get the byte offset of where this component ends relative to the start of the parent data type.
java.lang.String	getFieldName()	Get the name of the field name as a component of a Data Type.
int	getLength()	Get the length of this component.
int	getOffset()	Get the byte offset of where this component begins relative to the start of the parent data type.
int	getOrdinal()	Get the ordinal position within the parent dataType.
DataType	getParent()	returns the dataType that contains this component.
int	hashCode()
boolean	isBitFieldComponent()	Determine if the specified component corresponds to a bit-field.
boolean	isEquivalent(DataTypeComponent dtc)	Returns true if the given dataTypeComponent is equivalent to this dataTypeComponent.
boolean	isZeroBitFieldComponent()	Determine if the specified component corresponds to a zero-length bit-field.
void	setComment(java.lang.String comment)	Sets the comment for the component.
void	setDataType(DataType dt)	Sets the DataType for this component.
void	setDefaultSettings(Settings settings)	Set default settings for this dataType.
void	setFieldName(java.lang.String name)	Sets the field name.
java.lang.String	toString()
void	update(int ordinal, int offset, int length)	Update component ordinal, offset and length during alignment

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface ghidra.program.model.data.DataTypeComponent

getDefaultFieldName

Constructor Detail

DataTypeComponentImpl

public DataTypeComponentImpl(DataType dataType,
                             CompositeDataTypeImpl parent,
                             int length,
                             int ordinal,
                             int offset,
                             java.lang.String fieldName,
                             java.lang.String comment)

Create a new DataTypeComponent

Parameters:

dataType - the dataType for this component

parent - the dataType that this component belongs to

length - the length of the dataType in this component.

ordinal - the index within its parent.

offset - the byte offset within the parent

fieldName - the name associated with this component

comment - the comment associated with this component

DataTypeComponentImpl

public DataTypeComponentImpl(DataType dataType,
                             CompositeDataTypeImpl parent,
                             int length,
                             int ordinal,
                             int offset)

Create a new DataTypeComponent

Parameters:

dataType - the dataType for this component

parent - the dataType that this component belongs to

length - the length of the dataType in this component.

ordinal - the index of this component within its parent.

offset - the byte offset within the parent

Method Detail

isBitFieldComponent

public boolean isBitFieldComponent()

Description copied from interface: DataTypeComponent

Determine if the specified component corresponds to a bit-field.

Specified by:

isBitFieldComponent in interface DataTypeComponent

Returns:

true if bit-field else false

isZeroBitFieldComponent

public boolean isZeroBitFieldComponent()

Description copied from interface: DataTypeComponent

Determine if the specified component corresponds to a zero-length bit-field.

Specified by:

isZeroBitFieldComponent in interface DataTypeComponent

Returns:

true if zero-length bit-field else false

getOffset

public int getOffset()

Description copied from interface: DataTypeComponent

Get the byte offset of where this component begins relative to the start of the parent data type.

Specified by:

getOffset in interface DataTypeComponent

Returns:

offset of start of component relative to the start of the parent data type.

getEndOffset

public int getEndOffset()

Description copied from interface: DataTypeComponent

Get the byte offset of where this component ends relative to the start of the parent data type.

Specified by:

getEndOffset in interface DataTypeComponent

Returns:

offset of end of component relative to the start of the parent data type.

getComment

public java.lang.String getComment()

Description copied from interface: DataTypeComponent

Get the comment for this dataTypeComponent.

Specified by:

getComment in interface DataTypeComponent

Returns:

component comment string or null if one has not been set

setComment

public void setComment(java.lang.String comment)

Description copied from interface: DataTypeComponent

Sets the comment for the component.

Specified by:

setComment in interface DataTypeComponent

Parameters:

comment - this components comment or null to clear comment.

getFieldName

public java.lang.String getFieldName()

Description copied from interface: DataTypeComponent

Get the name of the field name as a component of a Data Type.

Specified by:

getFieldName in interface DataTypeComponent

Returns:

the name as a component of another Data Type.

setFieldName

public void setFieldName(java.lang.String name)
                  throws DuplicateNameException

Description copied from interface: DataTypeComponent

Sets the field name. If the field name is empty it will be set to null, which is the default field name. An exception is thrown if one of the parent's other components already has the specified field name.

Specified by:

setFieldName in interface DataTypeComponent

Parameters:

name - the new field name for this component.

Throws:

DuplicateNameException - if another component of the parent has the specified field name.

checkDefaultFieldName

public static void checkDefaultFieldName(java.lang.String fieldName)
                                  throws DuplicateNameException

Throws:

DuplicateNameException

getDataType

public DataType getDataType()

Description copied from interface: DataTypeComponent

Returns the dataType in this component.

Specified by:

getDataType in interface DataTypeComponent

Returns:

the dataType in this component

getParent

public DataType getParent()

Description copied from interface: DataTypeComponent

returns the dataType that contains this component.

Specified by:

getParent in interface DataTypeComponent

Returns:

the dataType that contains this component.

update

public void update(int ordinal,
                   int offset,
                   int length)

Description copied from interface: InternalDataTypeComponent

Update component ordinal, offset and length during alignment

Specified by:

update in interface InternalDataTypeComponent

Parameters:

ordinal - updated ordinal

offset - updated offset

length - updated byte length

getLength

public int getLength()

Description copied from interface: DataTypeComponent

Get the length of this component. Zero-length components will report a length of 0 and may overlap other components at the same offset. Similarly, multiple adjacent bit-field components may appear to overlap at the byte-level.

Specified by:

getLength in interface DataTypeComponent

Returns:

the length of this component

getOrdinal

public int getOrdinal()

Description copied from interface: DataTypeComponent

Get the ordinal position within the parent dataType.

Specified by:

getOrdinal in interface DataTypeComponent

Returns:

ordinal of this component within the parent data type.

getDefaultSettings

public Settings getDefaultSettings()

Description copied from interface: DataTypeComponent

Gets the default settings for this data type component.

Specified by:

getDefaultSettings in interface DataTypeComponent

Returns:

a Settings object that is the set of default values for this dataType component

setDefaultSettings

public void setDefaultSettings(Settings settings)

Description copied from interface: DataTypeComponent

Set default settings for this dataType.

Specified by:

setDefaultSettings in interface DataTypeComponent

Parameters:

settings - the new default settings.

hashCode

public int hashCode()

Overrides:

hashCode in class java.lang.Object

equals

public boolean equals(java.lang.Object obj)

Overrides:

equals in class java.lang.Object

isEquivalent

public boolean isEquivalent(DataTypeComponent dtc)

Description copied from interface: DataTypeComponent

Returns true if the given dataTypeComponent is equivalent to this dataTypeComponent. A dataTypeComponent is "equivalent" if the other component has a data type that is equivalent to this component's data type. The dataTypeComponents must also have the same offset, field name, and comment. The length is only checked for components which are dyanmic and whose size must be specified when creating a component.

Specified by:

isEquivalent in interface DataTypeComponent

Parameters:

dtc - the dataTypeComponent being tested for equivalence.

Returns:

true if the given dataTypeComponent is equivalent to this dataTypeComponent.

setDataType

public void setDataType(DataType dt)

Description copied from interface: InternalDataTypeComponent

Sets the DataType for this component. Must be used carefully since the component will not be resized.

Specified by:

setDataType in interface InternalDataTypeComponent

Parameters:

dt - the new DataType for this component

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object