PHP マニュアル
前のページ |  | 次のページ

# substr

(PHP 3, PHP 4 )

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() も参照下さい。

前のページ | ホーム | 次のページ
substr_replace | 上に戻る | trim