string substring(string, number, number?)

備注

該字符串中的每個字符都被認為具有數字位置：第一個字符的位置是 1，第二個字符的位置是 2，依此類推。

如果未指定第三個參數，將返回從第二個參數指定的位置開始直到字符串結尾的子字符串。

如果參數不是字符串類型，將先使用 string() 函數轉換為字符串，然后計算該轉換的結果。

警告
作為參數傳遞給此函數的節點集的字符串轉換可能會產生意外的結果。有關更多信息，請參見 string 函數。

此函數區分大小寫。

示例

以下函數調用返回“234”：

substring("12345",2,3)

以下函數調用返回“2345”：

substring("12345",2)

返回的子字符串包含如下字符：字符位置大于或等于第二個參數的舍入值，且如果指定了第三個參數，小于第二個和第三個參數的舍入值之和。上面使用的比較和加法遵循 IEEE 754 標準規則；如同調用 round() 函數一樣進行舍入。

下列示例闡釋異常情況。

substring("12345", 1.5, 2.6) 返回“234”

substring("12345", 0, 3) 返回“12”

substring("12345", 0 div 0, 3) 返回 ""

substring("12345", 1, 0 div 0) 返回 ""

substring("12345", -42, 1 div 0) 返回 "12345"

substring("12345", -1 div 0, 1 div 0) 返回 ""