Datatype object representing an array of elements. More...

#include <type.hh>

Inheritance diagram for TypeArray:

Collaboration diagram for TypeArray:

Public Member Functions
	TypeArray (const TypeArray &op)
	Construct from another TypeArray.

	TypeArray (int4 n, Datatype *ao)
	Construct given an array size and element data-type.

Datatype *	getSubEntry (int4 off, int4 sz, int4 newoff, int4 el) const
	Figure out what a byte range overlaps. More...

virtual void	printRaw (ostream &s) const
	Print a description of the type to stream. More...

virtual Datatype *	getSubType (uintb off, uintb *newoff) const
	Recover component data-type one-level down. More...

virtual int4	numDepend (void) const

virtual Datatype *	getDepend (int4 index) const

virtual void	printNameBase (ostream &s) const

virtual int4	compare (const Datatype &op, int4 level) const
	Compare for functional equivalence. More...

virtual int4	compareDependency (const Datatype &op) const
	Compare for storage in tree structure. More...

virtual Datatype *	clone (void) const
	Clone the data-type.

virtual void	saveXml (ostream &s) const
	Serialize the data-type to XML. More...

Public Member Functions inherited from Datatype
	Datatype (const Datatype &op)
	Construct the base data-type copying low-level properties of another.

	Datatype (int4 s, type_metatype m)
	Construct the base data-type providing size and meta-type.

	Datatype (int4 s, type_metatype m, const string &n)
	Construct the base data-type providing size, meta-type, and name.

bool	hasSameVariableBase (const Datatype *ct) const
	Are these the same variable length data-type. More...

virtual Datatype *	nearestArrayedComponentForward (uintb off, uintb newoff, int4 elSize) const

virtual Datatype *	nearestArrayedComponentBackward (uintb off, uintb newoff, int4 elSize) const

int4	typeOrderBool (const Datatype &op) const
	Order this with -op-, treating bool data-type as special. More...

void	saveXmlBasic (ostream &s) const
	Save basic data-type properties. More...

void	saveXmlRef (ostream &s) const
	Write an XML reference of this to stream. More...

bool	isPtrsubMatching (uintb offset) const
	Is this data-type suitable as input to a CPUI_PTRSUB op. More...

Protected Member Functions
virtual void	restoreXml (const Element *el, TypeFactory &typegrp)
	Restore data-type from XML. More...

	TypeArray (void)
	Internal constructor for restoreXml.

Protected Member Functions inherited from Datatype
void	restoreXmlBasic (const Element *el)
	Recover basic data-type properties. More...

Protected Attributes
Datatype *	arrayof
	type of which we have an array

int4	arraysize
	Number of elements in the array.

Protected Attributes inherited from Datatype
int4	size
	Size (of variable holding a value of this type)

string	name
	Name of type.

type_metatype	metatype
	Meta-type - type disregarding size.

uint4	flags
	Boolean properties of the type.

uint8	id
	A unique id for the type (or 0 if an id is not assigned)

Friends
class	TypeFactory

Additional Inherited Members
Protected Types inherited from Datatype
enum	{ coretype = 1, chartype = 2, enumtype = 4, poweroftwo = 8, utf16 = 16, utf32 = 32, opaque_string = 64, variable_length = 128 }
	Boolean properties of datatypes. More...

Static Protected Member Functions inherited from Datatype
static uint8	hashName (const string &nm)
	Produce a data-type id by hashing the type name. More...

static uint8	hashSize (uint8 id, int4 size)
	Reversibly hash size into id. More...

Detailed Description

Datatype object representing an array of elements.

Member Function Documentation

◆ compare()

int4 TypeArray::compare	(	const Datatype &	op,
		int4	level
	)		const

virtual

Compare for functional equivalence.

0 (equality) means the data-types are functionally equivalent (even if names differ) Smaller types come earlier. More specific types come earlier.

Parameters

op	is the data-type to compare with this
level	is maximum level to descend when recursively comparing

Returns: negative, 0, positive depending on ordering of types

Reimplemented from Datatype.

◆ compareDependency()

int4 TypeArray::compareDependency ( const Datatype & op ) const

virtual

Compare for storage in tree structure.

Ordering of data-types for the main TypeFactory container. Comparison only goes down one-level in the component structure, before just comparing pointers.

Parameters

op	is the data-type to compare with this

Returns: negative, 0, positive depending on ordering of types

Reimplemented from Datatype.

◆ getSubEntry()

Datatype * TypeArray::getSubEntry	(	int4	off,
		int4	sz,
		int4 *	newoff,
		int4 *	el
	)		const

Figure out what a byte range overlaps.

Given some contiguous piece of the array, figure out which element overlaps the piece, and pass back the element index and the renormalized offset

Parameters

off	is the offset into the array
sz	is the size of the piece (in bytes)
newoff	is a pointer to the renormalized offset to pass back
el	is a pointer to the array index to pass back

Returns: the element data-type or NULL if the piece overlaps more than one

◆ getSubType()

Datatype * TypeArray::getSubType	(	uintb	off,
		uintb *	newoff
	)		const

virtual

Recover component data-type one-level down.

Given an offset into this data-type, return the component data-type at that offset. Also, pass back a "renormalized" offset suitable for recursize getSubType() calls: i.e. if the original offset hits the exact start of the sub-type, 0 is passed back. If there is no valid component data-type at the offset, return NULL and pass back the original offset

Parameters

off	is the offset into this data-type
newoff	is a pointer to the passed-back offset

Returns: a pointer to the component data-type or NULL

Reimplemented from Datatype.

◆ printRaw()

void TypeArray::printRaw ( ostream & s ) const

virtual

Print a description of the type to stream.

Print a raw description of the type to stream. Intended for debugging. Not intended to produce parsable C.

Parameters

s	is the output stream

Reimplemented from Datatype.

◆ restoreXml()

void TypeArray::restoreXml	(	const Element *	el,
		TypeFactory &	typegrp
	)

protectedvirtual

Restore data-type from XML.

Restore a Datatype object from an XML element

Parameters

el	is the XML element
typegrp	is the underlying TypeFactory that will hold the new object

Reimplemented from Datatype.

◆ saveXml()

void TypeArray::saveXml ( ostream & s ) const

virtual

Serialize the data-type to XML.

Write out a formal description of the data-type as an XML <type> tag. For composite data-types, the description goes down one level, describing the component types only by reference.

Parameters

s	is the stream to write to

Reimplemented from Datatype.

The documentation for this class was generated from the following files:

type.hh
type.cc

Public Member Functions

Protected Member Functions

Protected Attributes

Friends

Additional Inherited Members

Detailed Description

Member Function Documentation

◆ compare()

◆ compareDependency()

◆ getSubEntry()

◆ getSubType()

◆ printRaw()

◆ restoreXml()

◆ saveXml()