DIV CSS 佈局教程網

JavaScript 字串工具包:jscript.string 完整解析
編輯:關於JavaScript     

日常開發裡,字串處理永遠是最高頻的需求之一:統計子字串出現次數、過濾特定字元、批次取代、去除前後空白……。把這些操作收攏成一個命名空間下的工具函式,比到處複製貼上片段要可靠得多。以下是一個以 jscript.string 為命名空間的字串工具包。

命名空間的建立

/**
* jscript.string package
* This package contains utility functions for working with strings.
*/
if (typeof jscript == 'undefined') {
jscript = function() { }
}
jscript.string = function() { }

先判斷 jscript 是否存在再宣告,可以避免與其他程式庫或使用者的全域變數互相覆蓋,這是寫工具包時值得養成的小習慣。

substrCount:統計子字串出現次數

利用 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().

stripChars:黑名單或白名單式字元過濾

這個函式有兩種模式:傳入 "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().

strContentValid:字元組合法規檢核

表單驗證時常需要確認「輸入內容只能包含某些字元」或「不得包含某些字元」,這個函式用 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:全域取代

原生 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().

leftTrim、rightTrim 與 fullTrim

在 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().

實際 demo 對照

下面是可以直接跑的展示區,涵蓋上述各函式以及一個按固定長度切行的 breakLine():


[Ctrl+A 全選 注:如需引入外部Js需刷新才能執行]

小結

這類工具包的價值不在於程式碼多精妙,而在於把重複出現的字串操作集中管理。實務上要留意兩點:一是 stripChars 採雙層迴圈,遇到長字串時效能表現普通,可以改用正則表達式改寫;二是現代環境已有 trim()、replaceAll() 等原生方法,移植時不妨優先採用標準 API,只保留業務相關的客製函式。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved