string substring(string, number, number?)

備注

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

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

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

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

此函數(shù)區(qū)分大小寫。

示例

以下函數(shù)調用返回“234”：

substring("12345",2,3)

以下函數(shù)調用返回“2345”：

substring("12345",2)

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

下列示例闡釋異常情況。

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) 返回 ""