substr
そふぃのPHP入門 >> PHP関数リファレンス >> 文字列関数 >> substr

substr

解説 文字列の一部分を取得する
書式 string substr( string string , int start [, int length ] )
string substr( string 文字列 , int 開始位置 [, int 長さ ] )
引数 string 文字列
start 開始位置
length 長さ
返値 指定した文字列の、開始位置から長さ分の文字列

PHPマニュアル:substr substr()

substr()関数:概略解説

substr()は指定した文字列中で、指定した開始位置から指定した長さバイト分の文字列を取り出します。

substr()関数:返り値解説

取り出した文字列を返します。

substr()関数:引数解説

string文字列
取り出したい文字列を含む元の文字列を指定します。
start開始位置

開始位置を数値で指定します。正の数の場合は最初の文字を 0 として数えます。

負の数の場合は最後の文字から数えます。負の数を指定した場合は最後の文字から逆方向に数えます。

{include file='parts/goto.tpl' goto=$goto[0]}
length長さ
取り出す長さを指定します。省略した場合は開始位置から最後まで取り出します。

参考関数

  • strstr() ---- 文字列が最初に表れる場所を取得する
  • strchr() ---- strstr()関数のエイリアス
  • stristr() ---- 大文字・小文字を区別せずに文字列が最初に表れる位置を数値で取得する
  • strrchr() ---- 文字が最後に現れる場所を取得する
  • ereg() ---- 正規表現によるパターンマッチを行う

サンプルスクリプト

簡単な利用例

  1. <?php
  2. $str = 'abcdef';
  3. print substr($str, 1)."<br />\n"; // 1番目の文字から最後まで
  4. print substr($str, 0, 3); // 0番目の文字から3バイト分
  5. ?>

出力結果

bcdef
abc

負の開始位置

  1. <?php
  2. $str = 'abcdef';
  3. print substr($str, -1)."<br />\n"; // -1番目の文字から最後まで
  4. print substr($str, -2)."<br />\n"; // -2番目の文字から最後まで
  5. print substr($str, -3, 2); // -3番目の文字から2バイト分
  6. ?>

出力結果

f
ef
de

負の長さ

  1. <?php
  2. $str = 'abcdef';
  3. print substr($str, 0, -1)."<br />\n"; // 0番目の文字から-1バイト分
  4. print substr($str, 2, -1)."<br />\n"; // 2番目の文字から-1バイト分
  5. print substr($str, -4, -2); // -4番目の文字から-2バイト分
  6. ?>

出力結果

abcde
cde
cd
PHP辞典
PHP辞典 PHP5の関数にも対応したリファレンスですが、関数ごとにバージョンが表示されているのでPHP4ユーザにも安心。簡単なサンプルが全ての関数についている事と目的別検索が魅力です。
PHPポケットリファレンス
PHPポケットリファレンス 携帯用でもOKの小さめの本。関数本にありがちな分厚い・重い・見るのがおっくうという欠点をコンパクト化で解消してます。小さいながらも関数の掲載量・内容は共に十分充実しており、関数ごとのサンプルや目的別検索もあります。