ms:string-compare 函式
執行字串比較。這個函式是必要的，因為您無法使用 XPath，對兩個字串進行語法上的比較。
number ms:string-compare(string x, string y, [,string language _
[,string options]])
參數
- string x
比較的字串值。非字串值會先轉換成字串值後，再進行比較。
- string y
比較的字串值。非字串值會先轉換成字串值後，再進行比較。
- string language[optional]
定義語言來決定排序順序。這與<xsl:sort> lang屬性相似 (例如"en-US"或"fr-CA")。若省略這個參數，或者參數是空字串，則會以系統環境定義語言 (目前執行緒的語言)。
string options[optional]
預設會以區分大小寫方式進行比較，小寫優先。選項 說明 u
以區分大小寫方式進行比較，大寫優先。
i
對字元之間所有傳統上的差異，例如大小寫、假名和寬度，都會以不區分大小寫的方式進行比較 (字元寬度僅適用於某些語言)。
傳回值
傳回下列三個數值之一。
| 如果 | 範例函式傳回 |
|---|---|
x < y |
-1 |
x = y |
0 |
x > y |
1 |
備註
按語法 (字典) 順序進行字串間的比較。指定不支援的語言或選項將發生 Runtime 錯誤。若為 MSXML 元件，會傳回 E_FAIL。
範例
下列程式碼範例將示範如何使用 ms:string-compare 函式比較兩個字串。這個範例會將三個數字字串 ("1"、"2" 和 "3") 與 "2" 做比較。比較結果會顯示於程式碼下方的表格。
XML 檔
XSLT 檔 (translate.xsl)
比較結果如下所示：
| x, y | 結果 |
|---|---|
"1" , "2" |
-1 |
"2" , "2" |
0 |
"3" , "2" |
1 |