<!DOCTYPE html>
<html lang="en">

<head>
    <meta charset="UTF-8">
    <meta http-equiv="X-UA-Compatible" content="IE=edge">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <link href="https://cdn.jsdelivr.net/npm/bootstrap@5.3.0-alpha1/dist/css/bootstrap.min.css" rel="stylesheet"
        integrity="sha384-GLhlTQ8iRABdZLl6O3oVMWSktQOp6b7In1Zl3/Jr59b6EGGoI1aFkw7cmDA6j6gD" crossorigin="anonymous">
    <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/6.3.0/css/all.min.css"
        integrity="sha512-SzlrxWUlpfuzQ+pcUCosxcglQRNAq/DZjVsC0lE40xsADsfeQoEypE+enwcOiGjk/bSuGGKHEyjSoQ1zVisanQ=="
        crossorigin="anonymous" referrerpolicy="no-referrer" />
</head>
</html>
<?php
/**
 * XML API: XMLUnsupportedException class
 *
 * @package WordPress\XML
 */

namespace WordPress\XML;

use Exception;

/**
 * Core class used by the XML processor during XML parsing
 * for indicating that a given operation is unsupported.
 *
 * This class is designed for internal use by the XML processor.
 *
 * The XML API aims to operate in compliance with the XML 1.0
 * specification, but does not implement the full specification.
 * In cases where it lacks support it should not cause breakage
 * or unexpected behavior. In the cases where it recognizes that
 * it cannot proceed, this class is used to abort from any
 * operation and signify that the given XML cannot be processed.
 *
 * @since 6.4.0
 * @since 6.7.0 Gained contextual information for use in debugging parse failures.
 *
 * @access private
 *
 * @see XMLProcessor
 */
class XMLUnsupportedException extends Exception {
	/**
	 * Name of the matched token when the exception was raised,
	 * if matched on a token.
	 *
	 * This does not imply that the token itself was unsupported, but it
	 * may have been the case that the token triggered part of the XML
	 * parsing that isn't supported, such as the adoption agency algorithm.
	 *
	 * @var string
	 */
	public $token_name;

	/**
	 * Number of bytes into the input XML document where the parser was
	 * parsing when the exception was raised.
	 *
	 * Use this to reconstruct context for the failure.
	 *
	 * @var int
	 */
	public $token_at;

	/**
	 * Full raw text of the matched token when the exception was raised,
	 * if matched on a token.
	 *
	 * Whereas the `$token_name` will be normalized, this contains the full
	 * raw text of the token, including original casing, duplicated attributes,
	 * and other syntactic variations that are normally abstracted in the XML API.
	 *
	 * @var string
	 */
	public $token;

	/**
	 * Stack of open elements when the exception was raised.
	 *
	 * Use this to trace the parsing circumstances which led to the exception.
	 *
	 * @var string[]
	 */
	public $stack_of_open_elements = array();

	/**
	 * Constructor function.
	 *
	 * @param  string   $message  Brief message explaining what is unsupported, the reason this exception was raised.
	 * @param  string   $token_name  Normalized name of matched token when this exception was raised.
	 * @param  int      $token_at  Number of bytes into source XML document where matched token starts.
	 * @param  string   $token  Full raw text of matched token when this exception was raised.
	 * @param  string[] $stack_of_open_elements  Stack of open elements when this exception was raised.
	 */
	public function __construct( string $message, string $token_name, int $token_at, string $token, array $stack_of_open_elements ) {
		parent::__construct( $message );

		$this->token_name = $token_name;
		$this->token_at   = $token_at;
		$this->token      = $token;

		$this->stack_of_open_elements = $stack_of_open_elements;
	}

	public function __toString() {
		return $this->message . ' at ' . $this->token_at . ' in ' . $this->token;
	}
}
