将许多HTML实体转换为其特殊字符。

原型

wp_specialchars_decode( string $string, string|int $quote_style = ENT_NOQUOTES )

描述

具体处理:

参数

$string (string) (Required) 要解码的文本。

$quote_style (string|int) (Optional)  如果设置为ENT_COMPAT,则转换双引号;如果设置为ENT_QUOTES,则转换为双引号;如果设置为ENT_NOQUOTES,则转换为none。也与旧的_wp_specialchars()值兼容;如果设置为’single’则转换单引号,如果设置为’double’则转换为double,否则设置为两者。默认为ENT_NOQUOTES。

返回值

(string)  没有HTML实体的解码文本。

源文件

路径:wp-includes/formatting.php

<?php
...
function wp_specialchars_decode( $string, $quote_style = ENT_NOQUOTES ) {
	$string = (string) $string;
	if ( 0 === strlen( $string ) ) {
		return '';
	}
	// Don't bother if there are no entities - saves a lot of processing
	if ( strpos( $string, '&' ) === false ) {
		return $string;
	}
	// Match the previous behaviour of _wp_specialchars() when the $quote_style is not an accepted value
	if ( empty( $quote_style ) ) {
		$quote_style = ENT_NOQUOTES;
	} elseif ( !in_array( $quote_style, array( 0, 2, 3, 'single', 'double' ), true ) ) {
		$quote_style = ENT_QUOTES;
	}
	// More complete than get_html_translation_table( HTML_SPECIALCHARS )
	$single = array( '&#039;'  => ''', '&#x27;' => ''' );
	$single_preg = array( '/&#0*39;/'  => '&#039;', '/&#x0*27;/i' => '&#x27;' );
	$double = array( '&quot;' => '"', '&#034;'  => '"', '&#x22;' => '"' );
	$double_preg = array( '/&#0*34;/'  => '&#034;', '/&#x0*22;/i' => '&#x22;' );
	$others = array( '&lt;'   => '<', '&#060;'  => '<', '&gt;'   => '>', '&#062;'  => '>', '&amp;'  => '&', '&#038;'  => '&', '&#x26;' => '&' );
	$others_preg = array( '/&#0*60;/'  => '&#060;', '/&#0*62;/'  => '&#062;', '/&#0*38;/'  => '&#038;', '/&#x0*26;/i' => '&#x26;' );
	if ( $quote_style === ENT_QUOTES ) {
		$translation = array_merge( $single, $double, $others );
		$translation_preg = array_merge( $single_preg, $double_preg, $others_preg );
	} elseif ( $quote_style === ENT_COMPAT || $quote_style === 'double' ) {
		$translation = array_merge( $double, $others );
		$translation_preg = array_merge( $double_preg, $others_preg );
	} elseif ( $quote_style === 'single' ) {
		$translation = array_merge( $single, $others );
		$translation_preg = array_merge( $single_preg, $others_preg );
	} elseif ( $quote_style === ENT_NOQUOTES ) {
		$translation = $others;
		$translation_preg = $others_preg;
	}
	// Remove zero padding on numeric entities
	$string = preg_replace( array_keys( $translation_preg ), array_values( $translation_preg ), $string );
	// Replace characters according to translation table
	return strtr( $string, $translation );
}
...
?>

其他

英文文档:https://developer.wordpress.org/reference/functions/wp_specialchars_decode/