Package ghidra.app.util.demangler

Class DemanglerUtil

java.lang.Object

ghidra.app.util.demangler.DemanglerUtil

public class DemanglerUtil
extends Object

Demangler Utility class. For version 11.3, we have migrated to a new Demangler API that requires a MangledContext be passed to the demangler. This provides more information for properly demangling symbols.

Two methods below have been deprecated, as they do not provide enough information to produce the MangledContext. A new method @link demangle(Program, String, Address) is provided to permit proper operation using a completed context. Moreover, this new method returns all results instead of the first one found, as is how the deprecated methods work.

Constructor Summary

Constructors

Constructor	Description
DemanglerUtil()

Method Summary

Modifier and Type	Method	Description
static DemangledObject	demangle(Program program, String mangled)	Deprecated, for removal: This API element is subject to removal in a future version. see above
static List<DemangledObject>	demangle(Program program, String mangled, Address address)	Locates all available demanglers and checks to see if the supplied program is supported, then it attempts to demangle.
static DemangledObject	demangle(String mangled)	Deprecated, for removal: This API element is subject to removal in a future version. see above
static String	stripSuperfluousSignatureSpaces(String str)	Remove superfluous function signature spaces from specified string

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details

DemanglerUtil

public DemanglerUtil()

Method Details

demangle

@Deprecated(since="11.3",
            forRemoval=true)
public static DemangledObject demangle(String mangled)

Deprecated, for removal: This API element is subject to removal in a future version.

see above

Deprecated. Use demangle(Program, String, Address). See class header for more details. Locates all available demanglers, then it attempts to demangle. This method will query all demanglers regardless of architecture.

This method will use only the default options for demangling. If you need to specify options, then you will have to call each specific demangler directly, creating the options and mangled context specifically needed for each demangler. See Demangler.createMangledContext(String, DemanglerOptions, Program, Address) and Demangler.createDefaultOptions().

Parameters:

mangled - the mangled name

Returns:

the demangled object or null

demangle

@Deprecated(since="11.3",
            forRemoval=true)
public static DemangledObject demangle(Program program,
 String mangled)

Deprecated, for removal: This API element is subject to removal in a future version.

see above

Deprecated. Use demangle(Program, String, Address). See class header for more details.

Locates all available demanglers and checks to see if the supplied program is supported, then it attempts to demangle.

This method will use only the default options for demangling. If you need to specify options, then you will have to call each specific demangler directly, creating the options and mangled context specifically needed for each demangler. See Demangler.createMangledContext(String, DemanglerOptions, Program, Address) and Demangler.createDefaultOptions().

Parameters:

program - the program containing the mangled name

mangled - the mangled name

Returns:

the demangled object or null

demangle

public static List<DemangledObject> demangle(Program program,
 String mangled,
 Address address)

Locates all available demanglers and checks to see if the supplied program is supported, then it attempts to demangle. Returns a list of DemangledObject of successful demanglings

This method will use only the default options for demangling. If you need to specify options, then you will have to call each specific demangler directly, creating the options and mangled context specifically needed for each demangler. See Demangler.createMangledContext(String, DemanglerOptions, Program, Address) and Demangler.createDefaultOptions().

Parameters:

program - the program containing the mangled name; can be null

mangled - the mangled name

address - the address of the mangled name; can be null

Returns:

the list of DemangledObject

stripSuperfluousSignatureSpaces

public static String stripSuperfluousSignatureSpaces(String str)

Remove superfluous function signature spaces from specified string

Parameters:

str - string

Returns:

string with unwanted spaces removed