Method demangle

python/demangle.py:422–454

Demangle a raw name into a Type and QualifiedName. The result of this function is a (Type, QualifiedName) tuple for the demangled name's details. Any unresolved named types referenced by the resulting Type will be created as empty structures or void typedefs in the view, if the result i

(
			self,
			arch: Architecture,
			name: str,
			view: Optional['binaryview.BinaryView'] = None
	)

		raise NotImplementedError()

	def demangle(
			self,
			arch: Architecture,
			name: str,
			view: Optional['binaryview.BinaryView'] = None
	) -> Optional[Tuple['types.Type', 'types.QualifiedName']]:
		"""
		Demangle a raw name into a Type and QualifiedName.

		The result of this function is a (Type, QualifiedName) tuple for the demangled
		name's details.

		Any unresolved named types referenced by the resulting Type will be created as
		empty structures or void typedefs in the view, if the result is used on
		a data structure in the view. Given this, the call to :py:func:`demangle`
		should NOT cause any side-effects creating types in the view trying to resolve this
		and instead just return a type with unresolved named type references.

		The most recently registered demangler that claims a name is a mangled string
		(returns true from :py:func:`is_mangled_string`), and then returns a value from
		this function will determine the result of a call to :py:func:`demangle_generic`.
		If this call returns None, the next most recently used demangler(s) will be tried instead.

		If the mangled name has no type information, but a name is still possible to extract,
		this function may return a successful (None, <name>) result, which will be accepted.

		:param arch: Architecture for context in which the name exists, eg for pointer sizes
		:param name: Raw mangled name
		:param view: (Optional) BinaryView context in which the name exists, eg for type lookup
		:return: Tuple of (Type, Name) if successful, None if not. Type may be None if only
		         a demangled name can be recovered from the raw name.
		"""
		raise NotImplementedError()


class CoreDemangler(Demangler):