(PHP 4, PHP 5)
substr — Devuelve parte de una cadena
Devuelve una parte del string definida por los parámetros start y length.
La cadena de entrada.
Si start no es negativo, la cadena devuelta comenzará en start al inicio de la posición de la cadena string, contando desde cero. Por ejemplo, en la cadena 'abcdef', el caracter en la posición 0 es 'a', el caracter en la posición 2 es 'c', y así sucesivamente.
Si start es negativo, la cadena devuelta empezará en start contando desde el final de string.
Si la longitud de string es menor o igual a start, la función devolverá FALSE.
Example #1 Uso de start negativo
<?php
$rest = substr("abcdef", -1); // devuelve "f"
$rest = substr("abcdef", -2); // devuelve "ef"
$rest = substr("abcdef", -3, 1); // devuelve "d"
?>
Si se especifica el length y es positivo, la cadena devuelta contendrá como máximo de caracteres de la cantidada dada por length que comienza en start (dependiedo de la longitud del string).
Si se especifica length es negativo, entonces ese número de caracteres se omiten al final del string (después de la posición inicial se ha calculado a start es negativo). Si start indica una posición más allá de este truncamiento, se devolvera una cadena vacía.
Si se omite el length, la subcadena empezará por start hasta el final de la cadena donde será devuelta.
Si se especifica length y es 0, FALSE o NULL devolverá una cadena vacía.
Example #2 Usando un length negativo
<?php
$rest = substr("abcdef", 0, -1); // devuelve "abcde"
$rest = substr("abcdef", 2, -1); // devuelve "cde"
$rest = substr("abcdef", 4, -4); // devuelve ""
$rest = substr("abcdef", -3, -1); // devuelve "de"
?>
Devuelve la parte extraída de la cadena o FALSE en caso de error.
Example #3 Uso 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 caracteres específicos en una cadena
// se puede conseguir usando "corchetes"
$string = 'abcdef';
echo $string[0]; // a
echo $string[3]; // d
echo $string[strlen($string)-1]; // f
?>
Devuelve FALSE en caso de error.
<?php
var_dump(substr('a', 1)); // bool(false)
?>