ENTRECOMILLADO_IGNORAR_COMILLAS
ENTRECOMILLADO_IGNORAR_COMILLAS
Posible valor para el parámetro <var>$procesamiento_existentes</var> en <tt>self::entrecomillado*()</tt>: no se deben tener en cuenta las comillas existentes.
Provee métodos estáticos para aplicar formateo a valores.
mensaje(string $mensaje, array $args) : string
Reemplaza en un string argumentos con nombre por valores asociados.
Los argumentos en $mensaje se deben dar con el formato "${nombrearg}"
y se reemplazan por el valor en $args con clave "nombrearg".
Por ejemplo:
$mensaje = "Hoy es ${dia}. ${saludo}.";
$args = array('dia' => '09/09/2009', 'saludo' => 'Buenas noches');
echo Formateo::mensaje($mensaje, $args);
// Salida: Hoy es 09/09/2009. Buenas noches.
| string | $mensaje | |
| array | $args |
errorPhp(array $error_struct) : string|null
Formatea un string con la información de un error de PHP.
| array | $error_struct | resultado de {@link error_get_last()} |
null si $error_struct es vacío; si no, un string con formato "({type} @ {file}:{line}) {message}"
ip4SinCerosIniciales(String $ip) : String
Dado un IPv4, elimina los ceros iniciales que pudiera tener cada byte.
Ejemplos:
echo Formateo::ip4SinCerosIniciales('1.2.3.4'); // => 1.2.3.4
echo Formateo::ip4SinCerosIniciales('1.02.003.004'); // => 1.2.3.4
echo Formateo::ip4SinCerosIniciales('1.23.456.789'); // => 1.23.456.789
echo Formateo::ip4SinCerosIniciales('001.023.456.789'); // => 1.23.456.789
| String | $ip | el IPv4, en formato '\d{1,3}.\d{1,3}.\d{1,3}.\d{1,3}' |
el IP sin ceros iniciales, o NULL si $ip no tiene el formato correcto; notar que sólo se comprueba que el IP esté formado por cuatro secuencias de 1 a 3 dígitos separados por '.', pero no que represente un IP válido, es decir que no comprueba que el valor de cada byte sea menor que 256
entrecomilladoSimple(string $valor, integer $procesamiento_existentes = self::ENTRECOMILLADO_ESCAPAR_COMILLAS, mixed $param_procesamiento = NULL) : string
Encierra un string entre comillas simples.
| string | $valor | el string a entrecomillar |
| integer | $procesamiento_existentes | una de las constantes self::ENTRECOMILLADO_*; indica qué se debe hacer con las comillas simples ya existentes en $valor |
| mixed | $param_procesamiento | si $procesamiento_existentes = self::ENTRECOMILLADO_REEMPLAZAR_COMILLAS, debe ser el string por el que se deben reemplazar las comillas existentes; en los otros casos no se tiene en cuenta |
entrecomilladoDoble(string $valor, integer $procesamiento_existentes = self::ENTRECOMILLADO_ESCAPAR_COMILLAS, mixed $param_procesamiento = NULL) : string
Encierra un string entre comillas dobles.
| string | $valor | el string a entrecomillar |
| integer | $procesamiento_existentes | una de las constantes self::ENTRECOMILLADO_*; indica qué se debe hacer con las comillas dobles ya existentes en $valor |
| mixed | $param_procesamiento | si $procesamiento_existentes = self::ENTRECOMILLADO_REEMPLAZAR_COMILLAS, debe ser el string por el que se deben reemplazar las comillas existentes; en los otros casos no se tiene en cuenta |
prepararSalidaString(string $str, array $tags_permitidos = array(), string $compactar_blancos = null, boolean $traducir_html = false, boolean $traducir_extras = true, $corregir_falso_escape_entidades = true) : String
Prepara un string para salida a una página, transformando los caracteres que tienen una entidad HTML equivalente en dicha entidad y, opcionalmente, eliminando tags HTML y compactando blancos. Deja intactos los caracteres que ya están codificados como entidades.
| string | $str | el string a preparar |
| array | $tags_permitidos | un arreglo que indica los nombres de los tags HTML que se deben dejar intactos en $str; un arreglo vacío indica que se deben eliminar todos los tags; un valor nulo indica que se deben dejar pasar todos; por ejemplo: array('img','a','br') deja pasar imágenes, links y saltos de línea |
| string | $compactar_blancos | especifica un string por el que se deben reemplazar las secuencias de blancos consecutivos; un valor nulo indica que los blancos se deben dejar intactos; por ejemplo: $str = " a b\t\t\tc\nd", $compactar_blancos = ' ' --> resultado = " a b c d" |
| boolean | $traducir_html | ¿se deben traducir a entidades los caracteres contemplados por htmlspecialchars()? Si $str contiene código HTML, este parámetro debe ser false |
| boolean | $traducir_extras | ¿se deben traducir a entidades los caracteres contemplados por htmlentities(), exceptuando los contemplados por htmlspecialchars()? |
| $corregir_falso_escape_entidades | ¿se deben {@link corregir_falso_escape_entidades() corregir las entidades escapadas más de una vez}? |
prepararSalidaUrl(string $url) : string
Prepara un URL para salida a una página, convirtiendo los caracteres HTML especiales en entidades HTML.
Notar que este método sólo prepara el URL para que sea seguro emitirlo como salida HTML, pero NO lo prepara para transmisión, es decir, no le aplica \urlencode() / \rawurlencode(). Tampoco comprueba que $url contenga un URL válido.
| string | $url |
truncar(string $string, integer $largo_max, string $marca_truc = '...') : string
Asegura que un string no tenga una longitud mayor que <var>$largo_max</var>, cortándolo al final y agregando <var>$marca_truc</var>, si la supera.
No tiene en cuenta si existen palabras o algún tipo de código (como HTML) en $string; simplemente trunca por la longitud máxima.
| string | $string | el string de origen |
| integer | $largo_max | longitud máxima |
| string | $marca_truc | texto a agregar al final si se trunca el string |
$string potencialmente truncado al final
textoPlanoAHtml(string $texto) : string
Convierte texto plano a formato HTML.
El resultado es el texto dado, con:
| string | $texto |
el texto dado, convertido a HTML