PHP substr()関数

PHP String 参考手册PHP String リファレンスマニュアル

例

文字列から "world" を返します:

<?php echo substr("Hello world",6); ?>

サンプルを実行 »

定義と使用法

substr() 関数は文字列の一部を返します。

注記:start パラメータが負の数で、length が start 以下の場合、length は 0 になります。


構文

substr(string,start,length)

パラメータ 説明
string 必須。返す部分を含む文字列を指定します。
start 必須。文字列のどこから開始するかを指定します。
  • 正数 - 文字列の指定位置から開始
  • 負数 - 文字列の末尾から指定位置で開始
  • 0 - 文字列の最初の文字から開始
length 省略可能。返す文字列の長さを指定します。デフォルトは文字列の末尾までです。
  • 正数 - start パラメータの位置から返す
  • 負数 - 文字列の末尾から返す

技術詳細

戻り値: 文字列の抽出部分を返し、失敗した場合は FALSE または空文字列を返します。
PHP バージョン: 4+
更新履歴: PHP 5.2.2 から 5.2.6 では、start パラメータが負の切り詰めまたは範囲外の位置を表す場合は FALSE を返します。他のバージョンでは、start 位置から文字列を取得します。


その他の例

例 1

正負の異なる start パラメータを使用する:

<?php echo substr("Hello world",10)."<br>"; echo substr("Hello world",1)."<br>"; echo substr("Hello world",3)."<br>"; echo substr("Hello world",7)."<br>"; echo substr("Hello world",-1)."<br>"; echo substr("Hello world",-10)."<br>"; echo substr("Hello world",-8)."<br>"; echo substr("Hello world",-4)."<br>"; ?>

サンプルを実行 »

例 2

正負の異なる start と length パラメータを使用する:

<?php echo substr("Hello world",0,10)."<br>"; echo substr("Hello world",1,8)."<br>"; echo substr("Hello world",0,5)."<br>"; echo substr("Hello world",6,6)."<br>"; echo substr("Hello world",0,-1)."<br>"; echo substr("Hello world",-10,-2)."<br>"; echo substr("Hello world",0,-6)."<br>"; echo substr("Hello world",-2-3)."<br>"; ?>


PHP String 参考手册PHP String リファレンスマニュアル その他の拡張