Receive notification of a non-recoverable error.

This corresponds to the definition of "fatal error" in section 1.2 of the W3C XML 1.0 Recommendation. For example, a parser would use this callback to report the violation of a well-formedness constraint.

The application must assume that the document is unusable after the parser has invoked this method, and should continue (if at all) only for the sake of collecting additional error messages: in fact, SAX parsers are free to stop reporting any other events once this method has been invoked.

Parameter:

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

Property definitions

sax $ ErrorHandler :: fatal_error
	# Receive notification of a non-recoverable error.
	#
	# This corresponds to the definition of "fatal error" in
	# section 1.2 of the W3C XML 1.0 Recommendation. For example, a
	# parser would use this callback to report the violation of a
	# well-formedness constraint.
	#
	# The application must assume that the document is unusable
	# after the parser has invoked this method, and should continue
	# (if at all) only for the sake of collecting additional error
	# messages: in fact, SAX parsers are free to stop reporting any
	# other events once this method has been invoked.
	#
	# Parameter:
	#
	# * `exception`: error information encapsulated in a SAX parse
	# exception.
	fun fatal_error(exception: SAXParseException) do
		exception.throw
	end
lib/sax/error_handler.nit:83,2--102,4

sax $ XMLFilterImpl :: fatal_error
	redef fun fatal_error(exception) do
		if error_handler != null then
			error_handler.fatal_error(exception)
		else
			exception.throw
		end
	end
lib/sax/helpers/xml_filter_impl.nit:340,2--346,4

saxophonit $ SAXEventLogger :: fatal_error
	redef fun fatal_error(exception) do
		log.push(["fatal_error", exception.full_message])
		if error_handler != null then
			error_handler.fatal_error(exception)
		end
	end
lib/saxophonit/testing.nit:430,2--435,4