GP-5023: Deprecating GhidraScript.getDemangled()

This commit is contained in:
Ryan Kurtz 2025-06-17 08:15:12 -04:00
parent cd5e163c0a
commit a5c0dd9897
2 changed files with 13 additions and 10 deletions

View file

@ -1002,7 +1002,9 @@ public abstract class GhidraScript extends FlatProgramAPI {
* *
* @param mangled the mangled string to demangled * @param mangled the mangled string to demangled
* @return a demangled version of the mangled string, or null if it could not be demangled * @return a demangled version of the mangled string, or null if it could not be demangled
* @deprecated Use {@link DemanglerUtil#demangle(Program, String, Address)} instead
*/ */
@Deprecated(since = "11.5")
public String getDemangled(String mangled) { public String getDemangled(String mangled) {
List<DemangledObject> demangledObjs = DemanglerUtil.demangle(currentProgram, mangled, null); List<DemangledObject> demangledObjs = DemanglerUtil.demangle(currentProgram, mangled, null);
if (!demangledObjs.isEmpty()) { if (!demangledObjs.isEmpty()) {

View file

@ -46,11 +46,11 @@ public class DemanglerUtil {
/** /**
* Deprecated. Use {@link #demangle(Program, String, Address)}. See class header for more * Deprecated. Use {@link #demangle(Program, String, Address)}. See class header for more
* details. * details.
* * <p>
* Locates all available demanglers, then it attempts to demangle. This method will * Locates all available demanglers, then it attempts to demangle. This method will
* query all demanglers regardless of architecture. * query all demanglers regardless of architecture.
* * <p>
* <p>This method will use only the default options for demangling. If you need to * 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 * specify options, then you will have to call each specific demangler directly, creating
* the options and mangled context specifically needed for each demangler. See * the options and mangled context specifically needed for each demangler. See
* {@link Demangler#createMangledContext(String, DemanglerOptions, Program, Address)} and * {@link Demangler#createMangledContext(String, DemanglerOptions, Program, Address)} and
@ -82,11 +82,11 @@ public class DemanglerUtil {
/** /**
* Deprecated. Use {@link #demangle(Program, String, Address)}. See class header for more * Deprecated. Use {@link #demangle(Program, String, Address)}. See class header for more
* details. * details.
* * <p>
* <p>Locates all available demanglers and checks to see if the supplied program is * Locates all available demanglers and checks to see if the supplied program is
* supported, then it attempts to demangle. * supported, then it attempts to demangle.
* * <p>
* <p>This method will use only the default options for demangling. If you need to * 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 * specify options, then you will have to call each specific demangler directly, creating
* the options and mangled context specifically needed for each demangler. See * the options and mangled context specifically needed for each demangler. See
* {@link Demangler#createMangledContext(String, DemanglerOptions, Program, Address)} and * {@link Demangler#createMangledContext(String, DemanglerOptions, Program, Address)} and
@ -123,9 +123,9 @@ public class DemanglerUtil {
/** /**
* Locates all available demanglers and checks to see if the supplied program is * Locates all available demanglers and checks to see if the supplied program is
* supported, then it attempts to demangle. Returns a list of {@link DemangledObject} of * supported, then it attempts to demangle. Returns a list of {@link DemangledObject} of
* successful demanglings * successful demanglings.
* * <p>
* <p>This method will use only the default options for demangling. If you need to * 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 * specify options, then you will have to call each specific demangler directly, creating
* the options and mangled context specifically needed for each demangler. See * the options and mangled context specifically needed for each demangler. See
* {@link Demangler#createMangledContext(String, DemanglerOptions, Program, Address)} and * {@link Demangler#createMangledContext(String, DemanglerOptions, Program, Address)} and
@ -170,6 +170,7 @@ public class DemanglerUtil {
/** /**
* Remove superfluous function signature spaces from specified string * Remove superfluous function signature spaces from specified string
*
* @param str string * @param str string
* @return string with unwanted spaces removed * @return string with unwanted spaces removed
*/ */