日常開發裡,字串處理永遠是最高頻的需求之一:統計子字串出現次數、過濾特定字元、批次取代、去除前後空白……。把這些操作收攏成一個命名空間下的工具函式,比到處複製貼上片段要可靠得多。以下是一個以 jscript.string 為命名空間的字串工具包。
/**
* jscript.string package
* This package contains utility functions for working with strings.
*/
if (typeof jscript == 'undefined') {
jscript = function() { }
}
jscript.string = function() { }
先判斷 jscript 是否存在再宣告,可以避免與其他程式庫或使用者的全域變數互相覆蓋,這是寫工具包時值得養成的小習慣。
利用 split 以搜尋字串切開原字串,切出幾段就代表出現了「段數 − 1」次,這個技巧比迴圈比對簡潔許多。
jscript.string.substrCount = function(inStr, inSearchStr) {
if (inStr == null || inStr == "" ||
inSearchStr == null || inSearchStr == "") {
return 0;
}
var splitChars = inStr.split(inSearchStr);
return splitChars.length - 1;
} // End substrCount().
這個函式有兩種模式:傳入 "strip" 時,清單裡的字元會被剔除;傳入 "allow" 時,只有清單裡的字元會被保留,其餘全部丟掉。
jscript.string.stripChars = function(inStr, inStripOrAllow, inCharList) {
if (inStr == null || inStr == "" ||
inCharList == null || inCharList == "" ||
inStripOrAllow == null || inStripOrAllow == "") {
return "";
}
inStripOrAllow = inStripOrAllow.toLowerCase();
var outStr = "";
var i;
var j;
var nextChar;
var keepChar;
for (i = 0; i < inStr.length; i++) {
nextChar = inStr.substr(i, 1);
if (inStripOrAllow == "allow") {
keepChar = false;
} else {
keepChar = true;
}
for (j = 0; j < inCharList.length; j++) {
checkChar = inCharList.substr(j, 1);
if (inStripOrAllow == "allow" && nextChar == checkChar) {
keepChar = true;
}
if (inStripOrAllow == "strip" && nextChar == checkChar) {
keepChar = false;
}
}
if (keepChar == true) {
outStr = outStr + nextChar;
}
}
return outStr;
} // End stripChars().
表單驗證時常需要確認「輸入內容只能包含某些字元」或「不得包含某些字元」,這個函式用 from_list 與 not_from_list 兩個參數切換兩種語意。
jscript.string.strContentValid = function(inString, inCharList, inFromExcept) {
if (inString == null || inCharList == null || inFromExcept == null ||
inString == "" || inCharList == "") {
return false;
}
inFromExcept = inFromExcept.toLowerCase();
var i;
if (inFromExcept == "from_list") {
for (i = 0; i < inString.length; i++) {
if (inCharList.indexOf(inString.charAt(i)) == -1) {
return false;
}
}
return true;
}
if (inFromExcept == "not_from_list") {
for (i = 0; i < inString.length; i++) {
if (inCharList.indexOf(inString.charAt(i)) != -1) {
return false;
}
}
return true;
}
} // End strContentValid().
原生 replace 只會換掉第一個符合項,因此這裡用迴圈反覆替換,直到找不到目標為止。
jscript.string.replace = function(inSrc, inOld, inNew) {
if (inSrc == null || inSrc == "" || inOld == null || inOld == "" ||
inNew == null || inNew == "") {
return "";
}
while (inSrc.indexOf(inOld) > -1) {
inSrc = inSrc.replace(inOld, inNew);
}
return inSrc;
} // End replace().
在 String.prototype.trim 成為標準之前,去空白得自己動手。這三個函式分別處理左側、右側與兩側的空白字元。
jscript.string.leftTrim = function(inStr) {
if (inStr == null || inStr == "") {
return null;
}
var j;
for (j = 0; inStr.charAt(j) == " "; j++) { }
return inStr.substring(j, inStr.length);
} // End leftTrim().
jscript.string.rightTrim = function(inStr) {
if (inStr == null || inStr == "") {
return null;
}
var j;
for (j = inStr.length - 1; inStr.charAt(j) == " "; j--) { }
return inStr.substring(0, j + 1);
} // End rightTrim().
jscript.string.fullTrim = function(inStr) {
if (inStr == null || inStr == "") {
return "";
}
inStr = this.leftTrim(inStr);
inStr = this.rightTrim(inStr);
return inStr;
} // End fullTrim().
下面是可以直接跑的展示區,涵蓋上述各函式以及一個按固定長度切行的 breakLine():
這類工具包的價值不在於程式碼多精妙,而在於把重複出現的字串操作集中管理。實務上要留意兩點:一是 stripChars 採雙層迴圈,遇到長字串時效能表現普通,可以改用正則表達式改寫;二是現代環境已有 trim()、replaceAll() 等原生方法,移植時不妨優先採用標準 API,只保留業務相關的客製函式。