substr 和 substring 名字只差幾個字母,行為卻在「負數」與「參數順序」這兩件事上完全不同。搞混它們是新手最常踩的坑之一,下面把兩者的規則攤開對照。
語法:stringvar.substr(start [, length])。它從 start 位置開始,往後取 length 個字元——第二個參數是「長度」,不是結束位置。
stringvar:必要參數,要擷取的字串或 String 物件。start:必要參數,起始索引,第一個字元的索引為 0。若為負數,會從字串尾端往前計算。length:選用參數,要包含的字元數量。若為 0 或負數,回傳空字串;若省略,則一路取到字串結尾。
function SubstrDemo() {
var s = "The rain in Spain falls mainly in the plain.";
var ss = s.substr(12, 5); // 從索引 12 起取 5 個字元
return ss; // "Spain"
}
語法:strVariable.substring(start, end)。它回傳從 start 到 end(不含 end)之間的內容——第二個參數是「結束位置」。
start 與 end 中的較小值當起點,所以 substring(0, 3) 與 substring(3, 0) 結果相同。start 或 end 為 NaN 或負數,一律被替換成 0。
function SubstringDemo() {
var s = "The rain in Spain falls mainly in the plain.";
var ss = s.substring(12, 17);
return ss; // "Spain"
}
以 var str = "0123456789"; 為例,把常見參數組合的結果整理如下:
str.substring(0) // "0123456789" str.substring(5) // "56789" str.substring(10) // "" str.substring(-5) // "0123456789" 負數視為 0 str.substring(0, 5) // "01234" str.substring(2, 0) // "01" 自動交換順序 str.substring(2, 5) // "234" str.substring(2, -2) // "01" -2 視為 0,等同 substring(2, 0) str.substr(0) // "0123456789" str.substr(5) // "56789" str.substr(10) // "" str.substr(-5) // "0123456789" 負起點從尾端算 str.substr(0, 5) // "01234" str.substr(2, 0) // "" 長度為 0 str.substr(2, 2) // "23" str.substr(2, 5) // "23456" str.substr(2, -2) // "" 長度為負 str.substr(-1, 5) // "01234"
如果表達的是「從某處取到某處」,substring 的語意更直觀,而且會自動處理參數顛倒的情況;如果表達的是「從某處取幾個字」,substr 更貼近需求,也支援負起點。兩者共同的注意事項是:索引從 0 起算、超出範圍不會報錯而是安靜地截短,因此除錯時建議先把中間結果印出來確認。
另外要提醒的是,substr 屬於附屬(annex)功能,雖然目前主流瀏覽器都支援,但在新專案裡若追求標準相容性,substring 或 ES6 之後的 slice 會是更保險的選擇。