ps://wordpress.org/favicon.ico"} -->' );
* $scanner->next_delimiter();
* null = $scanner->allocate_and_return_parsed_attributes();
* JSON_ERROR_NONE = $scanner->get_last_json_error();
*
* $scanner = Block_Scanner::create( '' );
* $scanner->next_delimiter();
* array() === $scanner->allocate_and_return_parsed_attributes();
*
* $scanner = Block_Scanner::create( '' );
* $scanner->next_delimiter();
* null = $scanner->allocate_and_return_parsed_attributes();
*
* $scanner = Block_Scanner::create( '' );
* $scanner->next_delimiter();
* null = $scanner->allocate_and_return_parsed_attributes();
* JSON_ERROR_CTRL_CHAR = $scanner->get_last_json_error();
*
* @return array|null Parsed JSON attributes, if present and valid, otherwise `null`.
*/
public function allocate_and_return_parsed_attributes(): ?array {
$this->last_json_error = JSON_ERROR_NONE;
if ( static::CLOSER === $this->type ) {
return null;
}
if ( 0 === $this->json_length ) {
return null;
}
$json_span = substr( $this->source_text, $this->json_at, $this->json_length );
$parsed = json_decode( $json_span, null, 512, JSON_OBJECT_AS_ARRAY | JSON_INVALID_UTF8_SUBSTITUTE );
$last_error = json_last_error();
$this->last_json_error = $last_error;
return ( JSON_ERROR_NONE === $last_error && is_array( $parsed ) )
? $parsed
: null;
}
/**
* Returns the span representing the currently-matched delimiter,
* if matched, otherwise `null`.
*
* Note that for freeform blocks this will return a span of length
* zero, since there is no explicit block delimiter.
*
* Example:
*
* $scanner = Block_Scanner::create( '' );
* null === $scanner->get_span();
*
* $scanner->next_delimiter();
* WP_HTML_Span( 0, 17 ) === $scanner->get_span();
*
* @return WP_HTML_Span|null Span of text in source text spanning matched delimiter.
*/
public function get_span(): ?WP_HTML_Span {
return new WP_HTML_Span( $this->delimiter_at, $this->delimiter_length );
}
// Debugging methods not meant for production use.
/**
* Prints a debugging message showing the structure of the parsed delimiter.
*
* This is not meant to be used in production!
*
* @access private
*/
public function debug_print_structure(): void {
$c = ( ! defined( 'STDOUT' ) || posix_isatty( STDOUT ) )
? function ( $color = null ) { return $color; } // phpcs:ignore
: function ( $color ) { return ''; }; // phpcs:ignore
if ( $this->is_block_type( 'core/freeform' ) ) {
$closer = static::CLOSER === $this->get_delimiter_type() ? '/' : '';
echo "{$c( "\e[90m" )}\n"; // phpcs:ignore
return;
}
$namespace = substr( $this->source_text, $this->namespace_at, $this->namespace_length );
$slash = 0 === $this->namespace_length ? '' : '/';
$block_name = substr( $this->source_text, $this->name_at, $this->name_length );
$closer = static::CLOSER === $this->type ? '/' : '';
$json = substr( $this->source_text, $this->json_at, $this->json_length );
$opener_whitespace_at = $this->delimiter_at + 4;
$opener_whitespace_length = $this->namespace_at - 3 - $opener_whitespace_at - ( static::CLOSER === $this->type ? 1 : 0 );
$after_name_whitespace_at = $this->name_at + $this->name_length;
$after_name_whitespace_length = $this->json_at - $after_name_whitespace_at;
$closing_whitespace_at = $this->json_at + $this->json_length;
$closing_whitespace_length = $this->delimiter_at + $this->delimiter_length - 3 - $closing_whitespace_at;
if ( '/' === $this->source_text[ $this->delimiter_at + $this->delimiter_length - 4 ] ) {
$void_flag = '/';
--$closing_whitespace_length;
} else {
$void_flag = '';
}
$w = function ( $whitespace ) use ( $c ) {
return $c( "\e[2;90m" ) . str_replace( array( ' ', "\t", "\f", "\r", "\n" ), array( '␣', '␉', '␌', '␍', '' ), $whitespace );
};
echo "{$c( "\e[90m" )}\n"; // phpcs:ignore
}
// Constant declarations that would otherwise pollute the top of the class.
/**
* Indicates that the block comment delimiter closes an open block.
*/
const CLOSER = 'closer';
/**
* Indicates that the parser started parsing a block comment delimiter, but
* the input document ended before it could finish. The document was likely truncated.
*/
const INCOMPLETE_INPUT = 'incomplete-input';
/**
* Indicates that the block comment delimiter opens a block.
*/
const OPENER = 'opener';
/**
* Indicates that the parser has not yet attempted to parse a block comment delimiter.
*/
const UNINITIALIZED = 'uninitialized';
/**
* Indicates that the block comment delimiter represents a void block
* with no inner content of any kind.
*/
const VOID = 'void';
}