wp_kses_xml_named_entities() WordPress Function
The wp_kses_xml_named_entities() function is used to filter a string of text and convert all named entities to their corresponding numeric entities. This is useful when you want to make sure that your text is properly formatted for XML.
wp_kses_xml_named_entities( array $matches ) #
Callback for wp_kses_normalize_entities() regular expression.
Description
This function only accepts valid named entity references, which are finite, case-sensitive, and highly scrutinized by XML validators. HTML named entity references are converted to their code points.
Parameters
- $matches
(array)(Required)preg_replace_callback() matches array.
Return
(string) Correctly encoded entity.
Source
File: wp-includes/kses.php
function wp_kses_xml_named_entities( $matches ) {
global $allowedentitynames, $allowedxmlentitynames;
if ( empty( $matches[1] ) ) {
return '';
}
$i = $matches[1];
if ( in_array( $i, $allowedxmlentitynames, true ) ) {
return "&$i;";
} elseif ( in_array( $i, $allowedentitynames, true ) ) {
return html_entity_decode( "&$i;", ENT_HTML5 );
}
return "&$i;";
}
Expand full source codeCollapse full source codeView on TracView on GitHub
Changelog
| Version | Description |
|---|---|
| 5.5.0 | Introduced. |