diff --git a/docs/tutorial/syntax-uts.md b/docs/tutorial/syntax-uts.md index 02167dcb3fdba36eba2538b830dd49bec329deed..a4fc09e9af45ab02285273de4fcc5d9f21dc0820 100644 --- a/docs/tutorial/syntax-uts.md +++ b/docs/tutorial/syntax-uts.md @@ -234,17 +234,24 @@ a.toDouble() // 转换为 Double 类型,后续也将支持 new Double(a) 方 let a:Int = 3 let b = new Double(a) // 将整型变量 a 转换为 Double 类型 ``` -注意事项: +边界情况说明: - 在不同平台上,数值的范围限制不同,超出限制会导致相应的错误或异常 - * 编译至 JavaScript 平台时,最大值为 1.7976931348623157e+308,最小值为 -1.7976931348623157e+308,超出限制会返回 Infinity 或 -Infinity。 - * 编译至 Kotlin 平台时,最大值为 9223372036854775807,最小值为 -9223372036854775808,超出限制会报错:`The value is out of range‌`。 + * 编译至 JavaScript 平台时,最大值为 1.7976931348623157e+308,最小值为 -1.7976931348623157e+308,超出限制会返回 `Infinity` 或 `-Infinity`。 + * 编译至 Kotlin 平台时,最大值为 9223372036854775807,最小值为 -9223372036854775808,超出限制会报错:`The value is out of range‌`。 * 编译至 Swift 平台时,最大值 9223372036854775807,最小值 -9223372036854775808,超出限制会报错:`integer literal overflows when stored into Int`。 ### 字符串(String) 字符串是一串表示文本值的字符序列,例如:`"hello world"`。 +边界情况说明: + +- 在不同平台上,字符串的长度限制不同,超出限制会导致相应的错误或异常 + * 编译至 JavaScript 平台时,最大长度取决于 JavaScript 引擎,例如在 V8 中,最大长度为 2^30 - 25,超出限制会报错:`Invalid string length`;在 JSCore 中,最大长度为 2^31 - 1,超出限制会报错:`Out of memory __ERROR`。 + * 编译至 Kotlin 平台时,最大长度受系统内存的限制,超出限制会报错:`java.lang.OutOfMemoryError: char[] of length xxx would overflow`。 + * 编译至 Swift 平台时,最大长度也受系统内存的限制,超出限制目前没有返回信息。 + ### 日期(Date) 日期对象表示日期,包括年月日时分秒等各种日期。详[见下](#Date) @@ -1291,11 +1298,11 @@ console.log(clothing.length); // expected output: 4 ``` -注意事项: +边界情况说明: - 在不同平台上,数组的长度限制不同,超出限制会导致相应的错误或异常 - * 编译至 JavaScript 平台时,最大长度为 2^32 - 1,超出限制会报错:`Invalid array length`。 - * 编译至 Kotlin 平台时,最大长度受系统内存的限制,超出限制报错:`java.lang.OutOfMemoryError: Failed to allocate a allocation until OOM`。 + * 编译至 JavaScript 平台时,最大长度为 2^32 - 1,超出限制会报错:`Invalid array length`。 + * 编译至 Kotlin 平台时,最大长度受系统内存的限制,超出限制报错:`java.lang.OutOfMemoryError: Failed to allocate a allocation until OOM`。 * 编译至 Swift 平台时,最大长度也受系统内存的限制,目前超出限制没有返回信息。 #### 实例方法 @@ -3145,13 +3152,6 @@ console.log("The empty string is has a length of " + empty.length); /* "The empty string is has a length of 0" */ ``` -注意事项: - -- 在不同平台上,字符串的长度限制不同,超出限制会导致相应的错误或异常 - * 编译至 JavaScript 平台时,最大长度取决于 JavaScript 引擎,例如在 V8 中,最大长度为 2^30 - 25,超出限制会报错:`Invalid string length`。 - * 编译至 Kotlin 平台时,最大长度受系统内存的限制,超出限制会报错:`java.lang.OutOfMemoryError: char[] of length xxx would overflow`。 - * 编译至 Swift 平台时,最大长度也受系统内存的限制,超出限制目前没有返回信息。 - #### 实例方法 #### at @@ -3635,7 +3635,9 @@ clearInterval(timer) - `>>=` * 右移赋值运算符 (>>=) 将变量向右移动指定数量的位,并将结果赋值给变量。 - `===` + * 当两边操作数指向同一个对象时,引用相等 (===) 运算符返回true。对于运行时表示为原生类型的值(例如 Int),引用相等 (===)等价于相等(==)。 - `!==` + * 当两边操作数不指向同一个对象时,引用不等 (!==) 运算符返回true。 - `-` - `-=` - `>>>`