Package ghidra.program.model.data

Class CharsetSettingsDefinition

java.lang.Object
ghidra.program.model.data.CharsetSettingsDefinition
All Implemented Interfaces:
EnumSettingsDefinition, SettingsDefinition
public class CharsetSettingsDefinition extends Object implements EnumSettingsDefinition
SettingsDefinition for setting the charset of a string instance.

Charsets control how raw bytes are converted to native java String instances.

CharsetInfo controls the list of character sets that the user is shown.

  • Field Details

  • Method Details

    • getCharset

      public String getCharset(Settings settings, String defaultValue)

    • getValueString

      public String getValueString(Settings settings)
      Description copied from interface: SettingsDefinition
      Get the setting value as a string which corresponds to this definition. A default value string will be returned if a setting has not been stored.
      Specified by:
      getValueString in interface SettingsDefinition
      Parameters:
      settings - settings
      Returns:
      value string or null if not set and default has not specified by this definition

    • setCharset

      public void setCharset(Settings settings, String charset)

    • getChoice

      public int getChoice(Settings settings)
      Description copied from interface: EnumSettingsDefinition
      Returns the current value for this settings
      Specified by:
      getChoice in interface EnumSettingsDefinition
      Parameters:
      settings - The settings to search
      Returns:
      the value for the settingsDefintions

    • setChoice

      public void setChoice(Settings settings, int ordinalOfValue)
      Description copied from interface: EnumSettingsDefinition
      Sets the given value into the settings object using this definition as a key
      Specified by:
      setChoice in interface EnumSettingsDefinition
      Parameters:
      settings - the settings to store the value.
      ordinalOfValue - the settings value to be stored.

    • getDisplayChoices

      public String[] getDisplayChoices(Settings settings)
      Description copied from interface: EnumSettingsDefinition
      Gets the list of choices as strings based on the current settings
      Specified by:
      getDisplayChoices in interface EnumSettingsDefinition
      Parameters:
      settings - the instance settings
      Returns:
      an array of strings which represent valid choices based on the current settings.

    • getName

      public String getName()
      Description copied from interface: SettingsDefinition
      Returns the display name of this SettingsDefinition
      Specified by:
      getName in interface SettingsDefinition
      Returns:
      display name for setting

    • getStorageKey

      public String getStorageKey()
      Description copied from interface: SettingsDefinition
      Get the Settings key which is used when storing a key/value entry.
      Specified by:
      getStorageKey in interface SettingsDefinition
      Returns:
      settings storage key

    • getDescription

      public String getDescription()
      Description copied from interface: SettingsDefinition
      Returns a description of this settings definition
      Specified by:
      getDescription in interface SettingsDefinition
      Returns:
      setting description

    • getDisplayChoice

      public String getDisplayChoice(int ordinalOfValue, Settings s1)
      Description copied from interface: EnumSettingsDefinition
      Returns the String for the given enum value
      Specified by:
      getDisplayChoice in interface EnumSettingsDefinition
      Parameters:
      ordinalOfValue - the value to get a display string for
      s1 - the instance settings which may affect the results
      Returns:
      the display string for the given settings.

    • clear

      public void clear(Settings settings)
      Description copied from interface: SettingsDefinition
      Removes any values in the given settings object assocated with this settings definition
      Specified by:
      clear in interface SettingsDefinition
      Parameters:
      settings - the settings object to be cleared.

    • copySetting

      public void copySetting(Settings settings, Settings destSettings)
      Description copied from interface: SettingsDefinition
      Copies any setting value associated with this settings definition from the srcSettings settings to the destSettings.
      Specified by:
      copySetting in interface SettingsDefinition
      Parameters:
      settings - the settings to be copied
      destSettings - the settings to be updated.

    • hasValue

      public boolean hasValue(Settings setting)
      Description copied from interface: SettingsDefinition
      Determine if a setting value has been stored
      Specified by:
      hasValue in interface SettingsDefinition
      Parameters:
      setting - stored settings
      Returns:
      true if a value has been stored, else false

    • setStaticEncodingMappingValues

      public static void setStaticEncodingMappingValues(Map<Long,List<String>> mappingValues)
      Sets a static lookup table that maps from old deprecated (language,encoding) index values to a charset name.

      The old index values were used by old-style MBCS data type.

      Parameters:
      mappingValues - map of language_id to list of charset names.