stringObject.substr(start, length)
| 參數 | 說明 |
|---|---|
| start | 必要。要抽取的子字串起始索引,必須是數值。如果是負數,該參數宣告的是從字串尾部開始算起的位置:也就是 -1 指字串中最後一個字元,-2 指倒數第二個字元,依此類推。 |
| length | 可選。子字串中的字元數,必須是數值。如果省略該參數,則回傳從 start 位置到字串結尾的所有字元。 |
如果 length 為 0 或負數,將回傳一個空字串。如果沒有指定該參數,子字串將延續到字串的最後。
截取字串的第一個字元:
var str = "javascript"; console.log(str.substr(0, 1)); // "j"
從第 12 個字元開始,截取 5 個長度的內容:
var str = "Hello World!"; console.log(str.substr(3)); // "lo World!"
下面兩個例子更完整示範了它的用法。
範例一,從字串中提取一段字元:
var str = "Hello world!"; document.write(str.substr(3));
輸出:
lo world!
範例二,同時指定起始位置與長度:
var str = "Hello world!"; document.write(str.substr(3, 7));
輸出:
lo worl
JavaScript 有三個容易混淆的字串截取方法,釐清差異比記住單一用法更重要。
substring(start, end) 的第二個參數是結束位置而非長度,且不接受負數(負值會被視為 0);若 start 大於 end,兩者會自動交換。
slice(start, end) 與 substring 類似,但支援負數索引,負值代表從尾端回算,這是它最受歡迎的原因。
substr(start, length) 的第二個參數是長度,這也是它與前兩者最直觀的差異所在。
var s = "Hello world!"; s.slice(3, 8); // "lo wo" s.substring(3, 8); // "lo wo" s.substr(3, 5); // "lo wo" s.slice(-6); // "world!" s.substring(-6); // "Hello world!"(負值被視為 0) s.substr(-6); // "world!"
實務上的建議:優先使用 slice,因為它語意清楚且支援負索引。substr 屬於附錄中的 legacy 方法,雖然所有主流瀏覽器仍支援,但 MDN 已明確標註不建議在新程式碼中使用;substring 則因為負值與參數交換的隱性行為,容易寫出意料之外的結果。若你在維護舊程式碼,理解這三者的差異能省去大量誤判的時間。