substr (PHP 4, PHP 5)

substr — 返回字符串的子串

說明:

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

返回字符串 string 由 start 和 length 參數指定的子字符串。

參數:

string

輸入字符串。

start

如果 start 是非負數，返回的字符串將從 string 的 start 位置開始，從 0 開始計算。例如，在字符串 “abcdef” 中，在位置 0 的字符是 “a”，位置 2 的字符串是 “c” 等等。

如果 start 是負數，返回的字符串將從 string 結尾處向前數第 start 個字符開始。

如果 string 的長度小于或等于 start，將返回 FALSE。

Example #1 使用負數 start

1. <?php 
2. $rest = substr("abcdef", -1);    // 返回 "f" 
3. $rest = substr("abcdef", -2);    // 返回 "ef" 
4. $rest = substr("abcdef", -3, 1); // 返回 "d" 
5. ?> 

length

如果提供了正數的 length，返回的字符串將從 start 處開始最多包括 length 個字符（取決于string 的長度）。

如果提供了負數的 length，那么 string 末尾處的許多字符將會被漏掉（若 start 是負數則從字符串尾部算起）。如果 start 不在這段文本中，那么將返回一個空字符串。

如果提供了值為 0，FALSE 或 NULL 的 length，那么將返回一個空字符串。

如果沒有提供 length，返回的子字符串將從 start 位置開始直到字符串結尾。

Example #2 使用負數 length

1. <?php 
2. $rest = substr("abcdef", 0, -1);  // 返回 "abcde" 
3. $rest = substr("abcdef", 2, -1);  // 返回 "cde" 
4. $rest = substr("abcdef", 4, -4);  // 返回 "" 
5. $rest = substr("abcdef", -3, -1); // 返回 "de" 
6. ?> 

返回值:

返回提取的子字符串， 或者在失敗時返回 FALSE。

范例:

Example #3 substr() 基本用法

1. <?php 
2. echo substr('abcdef', 1);     // bcdef 
3. echo substr('abcdef', 1, 3);  // bcd 
4. echo substr('abcdef', 0, 4);  // abcd 
5. echo substr('abcdef', 0, 8);  // abcdef 
6. echo substr('abcdef', -1, 1); // f 
7.  
8. // 訪問字符串中的單個字符 
9. // 也可以使用中括號 
10. $string = 'abcdef'; 
11. echo $string[0];                 // a 
12. echo $string[3];                 // d 
13. echo $string[strlen($string)-1]; // f 
14. ?> 

錯誤/異常,錯誤時返回 FALSE。

1. <?php 
2. var_dump(substr('a', 1)); // bool(false) 
3. ?>