WP_HTML_Processor::__construct( string $html, string|null $use_the_static_create_methods_instead = null )

Source

 * @param string      $html                    Input HTML document to process.
 * @param string|null $known_definite_encoding Optional. If provided, specifies the charset used
 *                                             in the input byte stream. Currently must be UTF-8.
 * @return static|null The created processor if successful, otherwise null.
 */
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;
}

/**
 * Constructor.
 *
 * Do not use this method. Use the static creator methods instead.
 *
 * @access private
 *
 * @since 6.4.0
 *
 * @see WP_HTML_Processor::create_fragment()
 *
 * @param string      $html                                  HTML to process.
 * @param string|null $use_the_static_create_methods_instead This constructor should not be called manually.
 */
public function __construct( $html, $use_the_static_create_methods_instead = null ) {
	parent::__construct( $html );

	if ( self::CONSTRUCTOR_UNLOCK_CODE !== $use_the_static_create_methods_instead ) {
		_doing_it_wrong(
			__METHOD__,
			sprintf(
				/* translators: %s: WP_HTML_Processor::create_fragment(). */
				__( 'Call %s to create an HTML Processor instead of calling the constructor directly.' ),
				'<code>WP_HTML_Processor::create_fragment()</code>'
			),
			'6.4.0'
		);

View all references View on Trac View on GitHub