Method register_for_address

python/plugin.py:420–453

r""" ``register_for_address`` Register a plugin to be called with an address argument :param str name: name of the plugin (use 'Folder\\Name' to have the menu item nested in a folder) :param str description: description of the plugin :param callback action: function to call with the :class:

(
	    cls, name: str, description: str, action: Callable[['binaryview.BinaryView', int], None],
	    is_valid: Optional[Callable[['binaryview.BinaryView', int], bool]] = None
	)

	@classmethod
	def register_for_address(
	    cls, name: str, description: str, action: Callable[['binaryview.BinaryView', int], None],
	    is_valid: Optional[Callable[['binaryview.BinaryView', int], bool]] = None
	):
		r"""
		``register_for_address`` Register a plugin to be called with an address argument

		:param str name: name of the plugin (use 'Folder\\Name' to have the menu item nested in a folder)
		:param str description: description of the plugin
		:param callback action: function to call with the :class:`~binaryview.BinaryView` and address as arguments
		:param callback is_valid: optional argument of a function passed a :class:`~binaryview.BinaryView` and address to determine whether the plugin should be enabled for that view
		:rtype: None
		:Example:

			>>> def my_plugin(bv: BinaryView, address: int):
			>>> 	log_info(f"My plugin was called on bv: `{bv}` at address {hex(address)}")
			>>> PluginCommand.register_for_address("My Plugin", "My plugin description (not used)", my_plugin)
			True
			>>> def is_valid(bv: BinaryView, address: int) -> bool:
			>>> 	return False
			>>> PluginCommand.register_for_address("My Plugin (With Valid Function)", "My plugin description (not used)", my_plugin, is_valid)
			True

		.. warning:: Calling ``register_for_address`` with the same function name will replace the existing function but will leak the memory of the original plugin.
		"""
		binaryninja._init_plugins()
		action_obj = ctypes.CFUNCTYPE(None, ctypes.c_void_p, ctypes.POINTER(
		    core.BNBinaryView
		), ctypes.c_ulonglong)(lambda ctxt, view, addr: cls._address_action(view, addr, action))
		is_valid_obj = ctypes.CFUNCTYPE(
		    ctypes.c_bool, ctypes.c_void_p, ctypes.POINTER(core.BNBinaryView), ctypes.c_ulonglong
		)(lambda ctxt, view, addr: cls._address_is_valid(view, addr, is_valid))
		cls._registered_commands.append((action_obj, is_valid_obj))
		core.BNRegisterPluginCommandForAddress(name, description, action_obj, is_valid_obj, None)

	@classmethod
	def register_for_range(