substr()

string substr ( string $string, int $start [ , int $length ] )

Описание

substr() возвращает часть строки, заданную параметрами start и length.

Параметры

$string - входная строка
$start - если $start неотрицателен, возвращаемая строка будет начинаться с позиции $start’th в строке
Если $start отрицательное, возвращаемая строка начинается с символа $start’th от конца строки
Если $string меньше или равно длине $start, возвращается FALSE
$length - если $length является положительным значением, возвращаемая строка будет содержать не более символов длины, начинающихся с начала
Если $length отрицательное, абсолютное значение будет опущено в конце строки (после того, как начальная позиция была вычислена, когда старт отрицателен)
Если $length задано и равно 0, будет возвращена пустая строка
Если $length пропущена, будет возвращена подстрока, начинающаяся с $start до конца строки

Возврат значений

Возвращает извлеченную часть строки в случае успеха; FALSE в случае неудачи.

Пример

<?php
$str = "abcdef";
$ret = substr($str, 2); echo "$ret\r\n";       // OUTPUT: cdef
$ret = substr($str, -1); echo "$ret\r\n";      // OUTPUT: f
$ret = substr($str, -2); echo "$ret\r\n";      // OUTPUT: ef
$ret = substr($str, 2, 3); echo "$ret\r\n";    // OUTPUT: cde
$ret = substr($str, -3, 1); echo "$ret\r\n";   // OUTPUT: d
$ret = substr($str, 0, -1); echo "$ret\r\n";   // OUTPUT: abcde
$ret = substr($str, 2, -1); echo "$ret\r\n";   // OUTPUT: cde
$ret = substr($str, 4, -4); echo "$ret\r\n";   // OUTPUT: 0
$ret = substr($str, -3, -1); echo "$ret\r\n";  // OUTPUT: de

$ret = substr($str, 9); 
if($ret === FALSE) echo "returned FALSE\r\n";  // OUTPUT: returned FALSE
?>

Примечание

Данная функция соответствует функции substr() группы PHP.

< strtoupper()

substr_replace() >