Interface DataType

    • Method Detail

      • isDynamicallySized

        boolean isDynamicallySized()
        Indicates if this data-type is dynamically sized based upon DataOrganization.
      • isNotYetDefined

        boolean isNotYetDefined()
        Indicates if type has not yet been defined. Such types will always return a size of 1. (example: empty structure)
        Returns:
        true if this type is not yet defined.
      • getSettingsDefinitions

        SettingsDefinition[] getSettingsDefinitions()
        Gets a list of all the settingsDefinitions used by this data type.
        Returns:
        a list of the settingsDefinitions used by this data type.
      • getDefaultSettings

        Settings getDefaultSettings()
        Gets the default settings for this data type.
        Returns:
        the default settings for this dataType.
      • clone

        DataType clone​(DataTypeManager dtm)
        Returns a new instance of this DataType with its universalID and SourceArchive identity retained. Note: for built-in DataType's, clone and copy should have the same affect.
        Parameters:
        dtm - the data-type manager instance whose data-organization should apply.
      • copy

        DataType copy​(DataTypeManager dtm)
        Returns a new instance of this DataType with a new identity. Note: for built-in DataType's, clone and copy should have the same affect.
        Parameters:
        dtm - the data-type manager instance whose data-organization should apply.
      • getCategoryPath

        CategoryPath getCategoryPath()
        Gets the categoryPath associated with this data type
        Returns:
        the datatype's category path
      • getDataTypePath

        DataTypePath getDataTypePath()
        Returns the dataTypePath for this dataType;
        Returns:
        the dataTypePath for this dataType;
      • getDataTypeManager

        DataTypeManager getDataTypeManager()
        Returns the DataTypeManager that is associated with this dataType. This association should not be used to indicate whether this DataType has been resolved, but is intended to indicate whether the appropriate DataOrganization is being used.
      • getDisplayName

        java.lang.String getDisplayName()
        Gets the name for referring to this data type.
        Returns:
        generic name for this Data Type (i.e.: Word)
      • getName

        java.lang.String getName()
        Return that name of the data type
      • getPathName

        java.lang.String getPathName()
        Returns the full category path name that includes this dataType's name. If the category is null, then this just returns the dataType's name.
      • getMnemonic

        java.lang.String getMnemonic​(Settings settings)
        Get the mnemonic for this DataType.
        Returns:
        the mnemonic for this DataType.
      • getLength

        int getLength()
        Get the length (number of 8-bit bytes) of this DataType.
        Returns:
        the length of this DataType
      • getDescription

        java.lang.String getDescription()
        Get a String briefly describing this DataType.
        Returns:
        a one-liner describing this DataType.
      • setDescription

        void setDescription​(java.lang.String description)
                     throws java.lang.UnsupportedOperationException
        Sets a String briefly describing this DataType.
        Parameters:
        description - a one-liner describing this DataType.
        Throws:
        java.lang.UnsupportedOperationException - if the description is not allowed to be set for this data type.
      • getDocs

        java.net.URL getDocs()
        The getDocs method should provide a URL pointing to extended documentation for this DataType if it exists. A typical use would be to return a URL pointing to the programmers reference for this instruction or a page describing this data structure.
        Returns:
        null - there is no URL documentation for this prototype.
      • getValue

        java.lang.Object getValue​(MemBuffer buf,
                                  Settings settings,
                                  int length)
        Get the data in the form of the appropriate Object for this DataType. For instance if the data type is an AddressDT, return an Address object. a Byte, return a Scalar* (maybe this should be a Byte) a Float, return a Float
        Parameters:
        buf - the data buffer.
        settings - the settings to use.
        length - the number of bytes to get the value from.
        Returns:
        the data Object.
      • getValueClass

        java.lang.Class<?> getValueClass​(Settings settings)
        Get the Class of the value to be returned by this data type.
        Parameters:
        settings - the relevant settings to use or null for default.
        Returns:
        Class of the value to be returned by this data type or null if it can vary or is unspecified. Types which correspond to a string or char array will return the String class.
      • getDefaultLabelPrefix

        java.lang.String getDefaultLabelPrefix()
        Returns the appropriate string to use as the default label prefix in the absence of any data.
        Returns:
        the default label prefix or null if none specified.
      • getDefaultAbbreviatedLabelPrefix

        java.lang.String getDefaultAbbreviatedLabelPrefix()
        Returns the prefix to use for this datatype when an abbreviated prefix is desired. For example, some data types will built a large default label, at which is is more desirable to have a shortened prefix.
        Returns:
        the prefix to use for this datatype when an abbreviated prefix is desired. May return null.
      • getDefaultLabelPrefix

        java.lang.String getDefaultLabelPrefix​(MemBuffer buf,
                                               Settings settings,
                                               int len,
                                               DataTypeDisplayOptions options)
        Returns the appropriate string to use as the default label prefix.
        Parameters:
        buf - memory buffer containing the bytes.
        settings - the Settings object
        length - the length of the data.
        options - options for how to format the default label prefix.
        Returns:
        the default label prefix or null if none specified.
      • getDefaultOffcutLabelPrefix

        java.lang.String getDefaultOffcutLabelPrefix​(MemBuffer buf,
                                                     Settings settings,
                                                     int len,
                                                     DataTypeDisplayOptions options,
                                                     int offcutOffset)
        Returns the appropriate string to use as the default label prefix, taking into account the fact that there exists a reference to the data that references offcutLength bytes into this type
        Parameters:
        buf - memory buffer containing the bytes.
        settings - the Settings object
        length - the length of the data.
        options - options for how to format the default label prefix.
        offcutOffset -
        Returns:
        the default label prefix.
      • getRepresentation

        java.lang.String getRepresentation​(MemBuffer buf,
                                           Settings settings,
                                           int length)
        Get bytes from memory in a printable format for this type.
        Parameters:
        buf - the data.
        settings - the settings to use for the representation.
        length - the number of bytes to represent.
        Returns:
        the representation of the data in this format, never null.
      • isDeleted

        boolean isDeleted()
        Returns true if this data type has been deleted and is no longer valid
        Returns:
        true if this data type has been deleted and is no longer valid.
      • isEquivalent

        boolean isEquivalent​(DataType dt)
        Returns true if the given dataType is equivalent to this dataType. The precise meaning of "equivalent" is dataType dependent.
        Parameters:
        dt - the dataType being tested for equivalence.
        Returns:
        true if the if the given dataType is equivalent to this dataType.
      • dataTypeSizeChanged

        void dataTypeSizeChanged​(DataType dt)
        Notification that the given dataType's size has changed. DataTypes may need to make internal changes in response.
        TODO: This method is reserved for internal DB use and should be removed from the public DataType interface!!
        Parameters:
        dt - the dataType that has changed.
      • dataTypeDeleted

        void dataTypeDeleted​(DataType dt)
        Informs this dataType that the given dataType has been deleted.
        TODO: This method is reserved for internal DB use and should be removed from the public DataType interface!!
        Parameters:
        dt - the dataType that has been deleted.
      • dataTypeReplaced

        void dataTypeReplaced​(DataType oldDt,
                              DataType newDt)
        Informs this data type that the given oldDT has been replaced with newDT
        TODO: This method is reserved for internal DB use and should be removed from the public DataType interface!!
        Parameters:
        oldDt - old data type
        newDt - new data type
      • setDefaultSettings

        void setDefaultSettings​(Settings settings)
        Set the default settings for this data type.
        TODO: This method is reserved for internal DB use and should be removed from the public DataType interface!!
        Parameters:
        settings - the settings to be used as this dataTypes default settings.
      • addParent

        void addParent​(DataType dt)
        Inform this data type that it has the given parent
        TODO: This method is reserved for internal DB use and should be removed from the public DataType interface!!
        Parameters:
        dt - parent data type
      • removeParent

        void removeParent​(DataType dt)
        Remove a parent data type
        TODO: This method is reserved for internal DB use and should be removed from the public DataType interface!!
        Parameters:
        dt - parent data type
      • dataTypeNameChanged

        void dataTypeNameChanged​(DataType dt,
                                 java.lang.String oldName)
        Informs this data type that its name has changed from the indicated old name.
        TODO: This method is reserved for internal DB use and should be removed from the public DataType interface!!
        Parameters:
        dt - the data type whose name changed
        oldName - the data type's old name
      • getParents

        DataType[] getParents()
        Returns:
        an array of parents of this data type
      • getAlignment

        int getAlignment()
        Gets the alignment to be used when aligning this data type within another data type.
        Returns:
        this data type's alignment.
      • dependsOn

        boolean dependsOn​(DataType dt)
        Returns true if this dataType depends on the existence of the given dataType. For example byte[] depends on byte. If byte were deleted, then byte[] would also be deleted.
        Parameters:
        dt - the dataType to test that this dataType depends on.
      • getSourceArchive

        SourceArchive getSourceArchive()
        Get the source archive where this type originated
        Returns:
        source archive object
      • setSourceArchive

        void setSourceArchive​(SourceArchive archive)
        Set the source archive where this type originated
        Parameters:
        archive - source archive object
      • getLastChangeTime

        long getLastChangeTime()
        Get the timestamp corresponding to the last time this type was changed within its data type manager
        Returns:
        timestamp of last change within data type manager
      • getLastChangeTimeInSourceArchive

        long getLastChangeTimeInSourceArchive()
        Get the timestamp corresponding to the last time this type was sync'd within its source archive
        Returns:
        timestamp of last sync with source archive
      • getUniversalID

        UniversalID getUniversalID()
        Get the universal ID for this data type. This value is intended to be a unique identifier across all programs and archives. The same ID indicates that two data types were originally the same one. Keep in mind names, categories, and component makeup may differ and have changed since there origin.
        Returns:
        data type UniversalID
      • replaceWith

        void replaceWith​(DataType dataType)
        For dataTypes that support change, this method replaces the internals of this dataType with the internals of the given dataType. The dataTypes must be of the same "type" (i.e. structure can only be replacedWith another structure.
        Parameters:
        dataType - the dataType that contains the internals to upgrade to.
        Throws:
        java.lang.UnsupportedOperationException - if the dataType does not support change.
        java.lang.IllegalArgumentException - if the given dataType is not the same type as this dataType.
      • setLastChangeTime

        void setLastChangeTime​(long lastChangeTime)
        Sets the lastChangeTime for this dataType. Normally, this is updated automatically when a dataType is changed, but when committing or updating while synchronizing an archive, the lastChangeTime may need to be updated externally.
        Parameters:
        lastChangeTime - the time to use as the lastChangeTime for this dataType
      • setLastChangeTimeInSourceArchive

        void setLastChangeTimeInSourceArchive​(long lastChangeTimeInSourceArchive)
        Sets the lastChangeTimeInSourceArchive for this dataType. This is used by when a dataType change is committed back to its source archive.
        Parameters:
        lastChangeTimeInSourceArchive - the time to use as the lastChangeTimeInSourceArchive for this dataType
      • getDataOrganization

        DataOrganization getDataOrganization()
        Returns the DataOrganization associated with this data-type