## 数据类型@data-type ### 布尔值（Boolean） 布尔是简单的基础类型，只有2个值分别是：`true` 和 `false`。 ```ts let a:boolean = true let b = false ``` ### 数字（Number） 在web中，数字不区分整型和浮点。但在kotlin和swift中，数字需要是一个确定类型，比如Int、Float，没有泛数字。 UTS 在iOS和Android平台上新增了 number，拉齐了web端的实现，方便开发者写全端兼容代码。 Number是一个泛数字类型，包括整数或浮点数，包括正数负数。例如： 正整数 `42` 或者 浮点数 `3.14159` 或者 负数 `-1` 。 ```ts // 以下都是number类型 let a:number = 42 let b:number = 3.14159 let c = 42 let d = 3.14159 ``` 注意：在UTS中，Number 是基本数据类型，是默认数字类型，开发者书写的字面量如果没有特别指定类型也自动识别为Number。 除了 number，UTS 在Android和iOS设备上，也可以使用kotlin和swift的专用数字类型： #### Kotlin 特有的数字类型 @Kotlin - Byte, UByte - Short, UShort - Int, UInt - Long, ULong - Float - Double #### Swift 特有的数字类型 @Swift - Int, UInt, Int8, UInt8, Int16, UInt16, Int32, UInt32, Int64, UInt64 - Float, Float16, Float32, Float64 - Double **特有数字类型的使用场景** 大多数场景下，开发者使用 字面量（即Number类型）就可以满足需要，但是也有需要特有数字类型的场景。 1. 在 kotlin 和 swift 中，有些系统API或三方SDK的传入和返回强制约定了这些平台特有数字类型，此时无法使用number。 2. number作为泛数字，性能还是弱于Int。在普通计算中无法体现出差异，但在千万次运算后，累计会产生毫秒级速度差异。 当需要特有数字类型时，UTS中可以直接定义 可以使用下面的方法，虽然可能会被编辑器报语法错误（后续HBuilderX会修复这类误报），但编译到 kotlin 和 swift 时是可用的。 - 声明特定的平台数字类型 > 目前这些特有数字类型，声明类型时，与 number 不同的是，均为首字母大写 ```ts let a:Int = 3 //注意 Int 是首字母大写 let b:Int = 4 let c:Double = a * 1.0 / b ``` * 注意这些特有数字类型不能在web端和小程序端使用，如工程需兼容非App端，要把这些代码放入条件编译； * iOS和Android都有的类型，比如Int，编译后可跨2个平台；但如果使用了某平台专有的数字类型，比如swift的Int8，则此代码不能编译到Android，工程如需支持Android，则把这些代码写在条件编译里。 - 在 kotlin(app-android) 下转换特定的平台数字类型 ```ts let a:Int = 3 a.toFloat() // 转换为 Float 类型，后续也将支持 new Float(a) 方式转换 a.toDouble() // 转换为 Double 类型，后续也将支持 new Double(a) 方式转换 ``` - 在 swift(app-ios) 下转换特定的平台数字类型 ```ts 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‌`。 * 编译至 Swift 平台时，最大值 9223372036854775807，最小值 -9223372036854775808，超出限制会报错：`integer literal overflows when stored into Int`。 #### 更多API number内置对象还有一些API，[详见](buildin-object-api/number.md) ### 字符串（String） @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 日期对象表示日期，包括年月日时分秒等各种日期。[详见](buildin-object-api/date.md) ### null 一个表明 null 值的特殊关键字。 有时需定义可为null的字符串，可以在类型描述中使用`|`操作符。 ```ts let user: string | null ``` > 注意：uts 编译为kotlin和swift时不支持 undefined。每个有类型的变量都需要初始化或赋值。 ### 数组（Array） Array，即数组，支持在单个变量名下存储多个元素，并具有执行常见数组操作的成员。 js的array是可变长的泛型array。 在kotlin中，array是不可变长的，length是固定的。只有arrayList是可变长的。 为了拉齐实现，UTS补充了UTSArray，它继承自arrayList，所以可以变长。 但为了接近web的写法，方便跨端，UTSArray在new的时候仍使用了`new Array` #### 创建一个数组对象 `UTS`中数组的创建有两种方式： 1 字面量创建 ``` let a = [1,2,3];//支持 let a = [1,'2',3];//支持 // 需要注意的是，字面量创建的数组，不支持出现空的缺省元素 let a = [1,,2,3];//不支持 ``` 2 创建数组对象 ``` let a = new Array(1,2,3);//支持 let a = new Array(1,'2',3);//支持 let a = Array(1,2,3);//支持 let a = Array(1,'2','3');//支持 ``` #### 遍历数组对象 在UTS语言中，推荐使用foreach来实现数组的遍历 ``` const array1: string[] = ['a', 'b', 'c']; array1.forEach((element:string, index:number) => { console.log(array1[index]) }); ``` #### kotlin 平台的Array 特性 在kotlin平台上，Array 会被编译为 UTSArray， UTSArray 同时具备原生/web平台 数组特性和方法，需要特别注意的是数组结构转换的场景，我们会在下面列出： ##### 1 我有一个UTSArray 我需要一个kotlin.collections.List ``` let utsArr= ["hello","world"] let kotlinList = utsArr.toKotlinList() ``` ##### 2 我有一个UTSArray 我需要一个java.util.Array ``` let utsArr= ["hello","world"] let kotlinList = utsArr.toArray() ``` ##### 3 我有一个kotlin.collections.List 我需要一个UTSArray ``` let utsArr= mutableListOf("hello","world") let kotlinList = utsArr.toUTSArray() ``` ##### 4 我有一个java.util.Array 我需要一个UTSArray ``` let utsArr= arrayOf("hello","world") let kotlinList = utsArr.toMutableList().toUTSArray() ``` ### Object类型 @object 对象（object）是指内存中的可以被标识符引用的一块区域，是一种引用类型。包括Array，Date，Map，Set，JSON等。 ### any类型 @any 如果定义变量时没有声明类型，也没有赋值。那么这个变量会被视为any类型。虽然可以使用，但uts中非常不建议这样使用。 ```ts let s; s = "123" console.log(s) // hello world ```