htmlentities

(PHP 3, PHP 4, PHP 5)

htmlentities --  Convierte todos los caracteres a su entidad HTML aplicable

Descripción

string htmlentities ( string string [, int quote_style [, string charset]] )

Esta función es identica en todo a htmlspecialchars(), excepto que con htmlentities(), todos los caracteres que tengan una entidad equivalente en HTML serán cambiados a esas entidades.

En htmlspecialchars(), el parámetro opcional quote_style le permite definir lo que será hecho con las comillas 'sencillas' y las "dobles". Toma uno de tres constantes con ENT_COMPAT:

Tabla 1. Constantes disponibles para quote_style

Nombre de ConstanteDescripción
ENT_COMPATConvertirá las dobles comillas y dejará solo las comillas sencillas.
ENT_QUOTESConvertirá las comillas dobles y sencillas.
ENT_NOQUOTESMantendrá las comillas dobles y sencillas sin cambios.

El parámetro opcional quote fue agregado en PHP 4.0.3.

Además htmlspecialchars(), tiene un tercer parámetro opcional charset el cual define el conjunto de caracteres que serán utilizados en la conversión. Este parámetro fue agregado en PHP 4.1.0. Actualmente, el conjunto de caracteres IS-8859-1 es usado como valor por defecto.

Los siguientes juegos de caracteres son soportados a partir de PHP 4.3.0.

Tabla 2. Juegos de caracteres soportados

Juego de caracteresAliasesDescripción
ISO-8859-1ISO8859-1 Europeo Occidental, Latin-1
ISO-8859-15ISO8859-15 Europeo Occidental, Latin-9. Añade el signo de Euro, y letras del Francés y Finlandés que hacían falta en Latin-1(ISO-8859-1).
UTF-8  Multi-byte Unicode de 8-bits compatible con ASCII.
cp866ibm866, 866 Juego de caracteres cirílicos específico de DOS. Este juego de caracteres está soportado en 4.3.2.
cp1251Windows-1251, win-1251, 1251 Juego de caracteres cirílicos específico de Windows. Este juego de caracteres está soportado en 4.3.2.
cp1252Windows-1252, 1252 Juego de caracteres específico de Windows para Europa Occidental.
KOI8-Rkoi8-ru, koi8r Ruso. Este juego de caracteres está soportado en 4.3.2.
BIG5950 Chino Tradicional, usado principalmente en Taiwán.
GB2312936 Chino Simplificado, juego de caracteres estándar nacional.
BIG5-HKSCS  Big5 con extensiones de Hong Kong, Chino Tradicional.
Shift_JISSJIS, 932 Japonés
EUC-JPEUCJP Japonés

Nota: Cualquier otro juego de caracteres no es reconocido y en su lugar se utilizará ISO-8859-1.

Si quiere hacer la operación inversa puede usar html_entity_decode().

Ejemplo 1. Un ejemplo de htmlentities()

<?php
$str
= "A 'quote' is <b>bold</b>";

// Outputs: A 'quote' is &lt;b&gt;bold&lt;/b&gt;
echo htmlentities($str);

// Outputs: A &#039;quote&#039; is &lt;b&gt;bold&lt;/b&gt;
echo htmlentities($str, ENT_QUOTES);
?>

Vea también html_entity_decode(), get_html_translation_table(), htmlspecialchars(), nl2br(), y urlencode().

Hosting by: hurra.com
Generated: 2007-01-26 18:00:42