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().
