L'accesso a questa funzione è contrassegnato come privato. Ciò significa che non è destinata all'uso da parte degli sviluppatori di plugin o temi, ma solo ad altre funzioni principali. È elencata qui per completezza.

Converte una serie di caratteri speciali nelle loro entità HTML.

Descrizione

Tratta specificamente: &, <, >, ", e '.

$quote_style può essere impostato su ENT_COMPAT per codificare " a ", o su ENT_QUOTES per fare entrambe le cose. L'impostazione predefinita è ENT_NOQUOTES, dove non vengono codificate le virgolette.

Parametri

$stringa

(stringa)(Richiesto)Il testo da codificare.

$quote_style

(int|stringa)(Opzionale) Converte i doppi apici se impostato su ENT_COMPAT, sia singoli che doppi se impostato su ENT_QUOTES o nessuno se impostato su ENT_NOQUOTES. Converte le virgolette singole e doppie e converte le entità denominate HTML (che non sono anche entità denominate XML) nei loro punti di codice se impostate su ENT_XML1. Compatibile anche con i vecchi valori; converte le virgolette singole se impostate su 'single', le doppie se impostate su 'double' o entrambe se impostate diversamente. L'impostazione predefinita è ENT_NOQUOTES.

Valore predefinito: ENT_NOQUOTES

$carset

(falso|stringa)(Opzionale) La codifica dei caratteri della stringa.

Valore predefinito: false

$double_encode

(bool)(Opzionale) Se codificare le entità HTML esistenti.

Valore predefinito: false

Ritorno

(stringa) Il testo codificato con entità HTML.

Fonte

File: wp-includes/formatting.php

function_wp_specialchars($string,$quote_style=ENT_NOQUOTES,$charset=false,$double_encode=false){$string=(string)$string;if(0===strlen($string)){return'';}// Don't bother if there are no specialchars - saves some processing.if(!preg_match('/[&<>"']/',$string)){return$string;}// Account for the previous behaviour of the function when the $quote_style is not an accepted value.if(empty($quote_style)){$quote_style=ENT_NOQUOTES;}elseif(ENT_XML1===$quote_style){$quote_style=ENT_QUOTES|ENT_XML1;}elseif(!in_array($quote_style,array(ENT_NOQUOTES,ENT_COMPAT,ENT_QUOTES,'single','double'),true)){$quote_style=ENT_QUOTES;}// Store the site charset as a static to avoid multiple calls to wp_load_alloptions().if(!$charset){static$_charset=null;if(!isset($_charset)){$alloptions=wp_load_alloptions();$_charset=isset($alloptions['blog_charset'])?$alloptions['blog_charset']:'';}$charset=$_charset;}if(in_array($charset,array('utf8','utf-8','UTF8'),true)){$charset='UTF-8';}$_quote_style=$quote_style;if('double'===$quote_style){$quote_style=ENT_COMPAT;$_quote_style=ENT_COMPAT;}elseif('single'===$quote_style){$quote_style=ENT_NOQUOTES;}if(!$double_encode){// Guarantee every &entity; is valid, convert &garbage; into &garbage;// This is required for PHP < 5.4.0 because ENT_HTML401 flag is unavailable.$string=wp_kses_normalize_entities($string,($quote_style&ENT_XML1)?'xml':'html');}$string=htmlspecialchars($string,$quote_style,$charset,$double_encode);// Back-compat.if('single'===$_quote_style){$string=str_replace("'",''',$string);}return$string;}

Correlato

Utilizzi

Usi Descrizione
wp-includes/kses.php: wp_kses_normalize_entities()

Converte e corregge le entità HTML.

wp-includes/option.php: wp_load_alloptions()

Carica e mette in cache tutte le opzioni autocaricate, se disponibili, o tutte le opzioni.

Utilizzato da

Usato da Descrizione
wp-includes/formatting.php: esc_xml()

Escaping per i blocchi XML.

wp-includes/formatting.php: esc_js()

Esegue l'escape di apici singoli, htmlspecialchar " &, e corregge le terminazioni di riga.

wp-includes/formatting.php: esc_html()

Escaping per i blocchi HTML.

wp-includes/formatting.php: esc_attr()

Escaping per gli attributi HTML.

wp-includes/deprecated.php: wp_specialchars()

Escaping legacy per i blocchi HTML.

Changelog

Versione Descrizione
5.5.0 $quote_style accetta anche ENT_XML1.
1.2.2 Introdotto.