WP_HTML_Processor::create_full_parser()public staticWP 1.0

Creates an HTML processor in the full parsing mode.

It's likely that a fragment parser is more appropriate, unless sending an entire HTML document from start to finish. Consider a fragment parser with a context node of <body>.

Since UTF-8 is the only currently-accepted charset, if working with a document that isn't UTF-8, it's important to convert the document before creating the processor: pass in the converted HTML.

Method of the class: WP_HTML_Processor{}

No Hooks.

Return

static|null. The created processor if successful, otherwise null.

Usage

$result = WP_HTML_Processor::create_full_parser( $html, $known_definite_encoding );
$html(string) (required)
Input HTML document to process.
$known_definite_encoding(string|null)
If provided, specifies the charset used in the input byte stream. Currently must be UTF-8.
Default: 'UTF-8'

WP_HTML_Processor::create_full_parser() code WP 6.7.1

public static function create_full_parser( $html, $known_definite_encoding = 'UTF-8' ) {
	if ( 'UTF-8' !== $known_definite_encoding ) {
		return null;
	}

	$processor                             = new static( $html, self::CONSTRUCTOR_UNLOCK_CODE );
	$processor->state->encoding            = $known_definite_encoding;
	$processor->state->encoding_confidence = 'certain';

	return $processor;
}