substr

(PHP 3, PHP 4, PHP 5)

substr -- Devuelve parte de una cadena

Descripción

string substr ( string cadena, int comienzo [, int longitud] )

substr() devuelve la porción de cadena especificada por los parámetros comienzo y longitud.

Si comienzo es positivo o 0, la cadena devuelta comenzará en dicho carácter de cadena (los caracteres empiezan a contarse en cero). Por ejemplo, en la cadena 'abcdef', el carácter en la posición 0 es 'a', el carácter en la posición 2 es 'c', y así sucesivamente.

Ejemplo 1. Ejemplo básico de substr()

<?php
echo substr('abcdef', 1);     // bcdef
echo substr('abcdef', 1, 3);  // bcd
echo substr('abcdef', 0, 4);  // abcd
echo substr('abcdef', 0, 8);  // abcdef
echo substr('abcdef', -1, 1); // f

// El acceso a los caracteres dentro de una cadena se puede
// realizar directamente mediante las llaves
$string = 'abcdef';
echo
$string{0};                 // a
echo $string{3};                 // d
echo $string{strlen($string)-1}; // f

?>

Si comienzo es negativo, la cadena devuelta comenzará en dicha posición contando desde el final de cadena.

Ejemplo 2. Ejemplo de valores negativos de comienzo

<?php
$rest
= substr("abcdef", -1);    // devuelve "f"
$rest = substr("abcdef", -2);    // devuelve "ef"
$rest = substr("abcdef", -3, 1); // devuelve "d"
?>

Si se especifica longitud y es positiva, la cadena devuelta terminará como máximo longitud caracteres tras el comienzo. Si la longitud de la cadena es inferior o igual al valor del comienzo, la función devuelve FALSE.

Si se especifica longitud y es negativa, se omitirán longitud caracteres desde el final de la cadena (después de que la posición de comienzo se haya determinado cuando el comienzo es negativo). Si comienzo indica una posición mas allá de estos límites, se devuelve una cadean vacía.

Ejemplo 3. Ejemplo de uso de una longitud negativa

<?php
$rest
= substr("abcdef", 0, -1);  // returns "abcde"
$rest = substr("abcdef", 2, -1);  // returns "cde"
$rest = substr("abcdef", 4, -4);  // returns ""
$rest = substr("abcdef", -3, -1); // returns "de"
?>

Vea también strrchr(), substr_replace(), ereg(), trim(), mb_substr() y wordwrap().

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