substr

説明

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

substr() は文字列 string の、start で指定された位置から length バイト分の文字列を返します。

start が正の場合、返される文字列は、 string の 0 から数えて start番目から始まる文字列となります。例えば、文字列'abcdef'において位置 0にある文字は、'a'であり、位置2には'c'があります。

例:


$rest = substr("abcdef", 1);    // "bcdef"を返します
$rest = substr("abcdef", 1, 3); // "bcd"を返します
$rest = substr("abcdef", 0, 4); // "abcd"を返します
$rest = substr("abcdef", 0, 8); // "abcdef"を返します

start が負の場合、返される文字列は、 stringの後ろから数えて start番目から始まる文字列となります。

例 1. 負のstartを使用


$rest = substr("abcdef", -1); //  "f" を返します
$rest = substr("abcdef", -2); // "ef" を返します
$rest = substr("abcdef", -3, 1); // "d" を返します

length が指定され、かつ正である場合、返される文字列は start から数えて length文字数分となります。負の length が指定された場合、(start は文字列の終端を過ぎているので)返される文字列は start の位置にある1文字のみとなります。

length が指定され、かつ負である場合、返される文字列は start の後ろから数えて length 文字までとなります。この指定により切り出す文字列の長さが負となる場合、start の位置にある1文字のみが文字列として返されます。

例 2. 負のlengthを使用


$rest = substr("abcdef", 0, -1);  // "abcde"を返す
$rest = substr("abcdef", 2, -1);  // "cde"を返す
$rest = substr("abcdef", 4, -4);  // ""を返す
$rest = substr("abcdef", -3, -1); // "de"を返す

strrchr() および ereg() も参照下さい。