Method clear_user_var_value

python/function.py:2951–2982

Clears a previously defined user variable value. :param Variable var: Variable for which the value was informed :param int def_addr: Address of the definition site of the variable :rtype: None

(self, var: 'variable.Variable', def_addr: int, after: bool = True)

		core.BNSetUserVariableValue(self.handle, var.to_BNVariable(), def_site, after, value._to_core_struct())

	def clear_user_var_value(self, var: 'variable.Variable', def_addr: int, after: bool = True) -> None:
		"""
		Clears a previously defined user variable value.

		:param Variable var: Variable for which the value was informed
		:param int def_addr: Address of the definition site of the variable
		:rtype: None
		"""
		if var.index == 0:
			# Special case: function parameters have index 0 and are defined at the start of the function
			def_addr = self.start
		else:
			func_mlil = self.mlil
			if func_mlil is None:
				raise ValueError("Could not get definition for Variable")

			var_defs = func_mlil.get_var_definitions(var)
			if var_defs is None:
				raise ValueError("Could not get definition for Variable")

			found = False
			for site in var_defs:
				if site.address == def_addr:
					found = True
					break
			if not found:
				raise ValueError("No definition for Variable found at given address")
		def_site = core.BNArchitectureAndAddress()
		def_site.arch = self.arch.handle
		def_site.address = def_addr

		core.BNClearUserVariableValue(self.handle, var.to_BNVariable(), def_site, after)

	def get_all_user_var_values(
	    self