Receive notification of a recoverable error.

This corresponds to the definition of "error" in section 1.2 of the W3C XML 1.0 Recommendation. For example, a validating parser would use this callback to report the violation of a validity constraint. The default behaviour is to take no action.

The SAX parser must continue to provide normal parsing events after invoking this method: it should still be possible for the application to process the document through to the end. If the application cannot do so, then the parser should report a fatal error even if the XML 1.0 recommendation does not require it to do so.

Filters may use this method to report other, non-XML errors as well.

Parameter:

  • exception: error information encapsulated in a SAX parse exception.

Property definitions

sax $ ErrorHandler :: error
	# Receive notification of a recoverable error.
	#
	# This corresponds to the definition of "error" in section 1.2
	# of the W3C XML 1.0 Recommendation. For example, a validating
	# parser would use this callback to report the violation of a
	# validity constraint. The default behaviour is to take no
	# action.
	#
	# The SAX parser must continue to provide normal parsing events
	# after invoking this method: it should still be possible for the
	# application to process the document through to the end. If the
	# application cannot do so, then the parser should report a fatal
	# error even if the XML 1.0 recommendation does not require it to
	# do so.
	#
	# Filters may use this method to report other, non-XML errors
	# as well.
	#
	# Parameter:
	#
	# * `exception`: error information encapsulated in a SAX parse
	# exception.
	fun error(exception: SAXParseException) do end
lib/sax/error_handler.nit:59,2--81,47

sax $ XMLFilterImpl :: error
	redef fun error(exception) do
		if error_handler != null then
			error_handler.error(exception)
		end
	end
lib/sax/helpers/xml_filter_impl.nit:334,2--338,4

saxophonit $ SAXEventLogger :: error
	redef fun error(exception) do
		log.push(["error", exception.full_message])
		super
	end
lib/saxophonit/testing.nit:425,2--428,4