wp_has_noncharacters( string $text ): bool

Returns whether the given string contains Unicode noncharacters.

Description

XML recommends against using noncharacters and HTML forbids their use in attribute names. Unicode recommends that they not be used in open exchange of data.

Noncharacters are code points within the following ranges:

U+FDD0–U+FDEF
U+FFFE–U+FFFF
U+1FFFE, U+1FFFF, U+2FFFE, U+2FFFF, …, U+10FFFE, U+10FFFF

Parameters

$textstringrequired: Are there noncharacters in this string?

Return

bool Whether noncharacters were found in the string.

Source

function wp_has_noncharacters( string $text ): bool {
	/*
	 * Match the UTF-8 byte sequences directly so malformed UTF-8 elsewhere
	 * in the subject does not cause PCRE's Unicode mode to reject the string.
	 */
	return 1 === preg_match(
		'~
			# U+FDD0-U+FDEF, U+FFFE-U+FFFF
			\xEF(?:\xB7[\x90-\xAF]|\xBF[\xBE\xBF])
			|
			# U+nFFFE/U+nFFFF
			(?:\xF0[\x9F\xAF\xBF]|[\xF1-\xF3][\x8F\x9F\xAF\xBF]|\xF4\x8F)\xBF[\xBE\xBF]
		~x',
		$text
	);
}

View all references View on Trac View on GitHub

Used by	Description
_wp_has_noncharacters_fallback()`wp-includes/compat-utf8.php`	Fallback support for determining if a string contains Unicode noncharacters.
WP_HTML_Tag_Processor::set_attribute()`wp-includes/html-api/class-wp-html-tag-processor.php`	Updates or creates a new attribute on the currently matched tag with the passed value.

Changelog

Version	Description
6.9.0	Introduced.

User Contributed Notes

You must log in before being able to contribute a note or feedback.