trim

(PHP 4, PHP 5)

trim — Elimina espacios en blanco (u otros caracteres) del principio y final de una cadena

Descripción

string trim ( string $cadena [, string $lista_caracteres ] )

La función devuelve una cadena con los espacios en blanco eliminados del principio y del final de la cadena indicada en el parámetro cadena . Si no se emplea el segundo parámetro (lista_caracteres ), la función trim() elimina los siguientes caracteres:

" " (ASCII 32 (0x20)), un espacio en blanco.
"\t" (ASCII 9 (0x09)), un tabulador.
"\n" (ASCII 10 (0x0A)), una nueva linea.
"\r" (ASCII 13 (0x0D)), un retorno de carro.
"\0" (ASCII 0 (0x00)), el byte NUL.
"\x0B" (ASCII 11 (0x0B)), un tabulador vertical.

Lista de parámetros

cadena: La cadena a la que se eliminan los espacios en blanco (u otros caracteres)
lista_caracteres: Además, con el parámetro lista_caracteres , se puede especificar la lista de caracteres que se quieren eliminar. El método consiste en enumerar todos los caracteres que se quieren eliminar, con la posibilidad de emplear .. para indicar un rango de caracteres.

Valores retornados

La cadena con los espacios en blanco (u otros caracteres) eliminados

Registro de cambios

Versión	Descripción
4.1.0	Se incluyó el parámetro opcional `lista_caracteres` .

Ejemplos

Example#1 Ejemplo de uso de trim()


<?php

$texto = "\t\tEn un lugar de la Mancha :) ...  ";

echo trim($texto);           // "En un lugar de la Mancha :) ..."
echo trim($texto, " \t.");   // "En un lugar de la Mancha :)"

// elimina los caracteres ASCII de control que aparecen al principio y al final de $datos_binarios 
// (desde el car&aacute;cter de control 0 hasta el 31, ambos inclusive)
$datos_normales = trim($datos_binarios, "\x00..\x1F");

?>

Example#2 Limpiar valores de matrices con trim()


<?php
function limpia_valores(&$valor) 
{ 
    $valor = trim($valor); 
}

$frutas = array('manzana','platano ', ' arandano ');
var_dump($frutas);

array_walk($frutas, 'limpia_valores');
var_dump($frutas);

?>

El resultado del ejemplo seria:

array(3) {
  [0]=>
  string(5) "manzana"
  [1]=>
  string(7) "platano "
  [2]=>
  string(11) " arandano "
}
array(3) {
  [0]=>
  string(5) "manzana"
  [1]=>
  string(6) "platano"
  [2]=>
  string(9) "arandano"
}

Ver también