From c40ac9b40e69d88bab969fd6f58f6ac4ab538a5b Mon Sep 17 00:00:00 2001 From: ryuka Date: Fri, 6 Jun 2014 18:35:23 +0800 Subject: [PATCH 1/4] add list --- source/chapter2/01_The_Basics.md | 17 +++++++++++++++++ 1 file changed, 17 insertions(+) diff --git a/source/chapter2/01_The_Basics.md b/source/chapter2/01_The_Basics.md index 781e4a18..565347aa 100644 --- a/source/chapter2/01_The_Basics.md +++ b/source/chapter2/01_The_Basics.md @@ -1,5 +1,21 @@ # 基础部分 +本页包含内容： + +- 常量与变量 +- 注释 +- 分号 +- 整数 +- 浮点数 +- 类型安全和类型推断 +- 数值类原始值 +- 数值类型转换 +- 类型别名 +- 布尔值 +- 元组 +- 可选项 +- 声明 + Swift 是 iOS 和 OS X 应用开发的一门新语言。然而，如果你有 C 或者 Objective-C 开发经验的话，你会发现 Swift 的很多内容都是你熟悉的。 Swift 的类型是在 C 和 Objective-C 的基础上提出的，`Int`是整型；`Double`和`Float`是浮点型；`Bool`是布尔型；`String`是字符串。Swift 还有两个有用的集合类型，`Array`和`Dictionary`，详情参见`集合类型(待添加链接)`。 @@ -129,3 +145,4 @@ Swift 中的注释与C 语言的注释非常相似。单行注释以双正斜杠 let cat = "🐱"; println(cat) // prints "🐱" + \ No newline at end of file From b895b697940e449b3f309aafd190c99bd493d5bd Mon Sep 17 00:00:00 2001 From: ryuka Date: Fri, 6 Jun 2014 18:35:23 +0800 Subject: [PATCH 2/4] add list --- source/chapter2/01_The_Basics.md | 18 ++++++++++++++++++ 1 file changed, 18 insertions(+) diff --git a/source/chapter2/01_The_Basics.md b/source/chapter2/01_The_Basics.md index 3eff63f3..94d641f5 100644 --- a/source/chapter2/01_The_Basics.md +++ b/source/chapter2/01_The_Basics.md @@ -1,5 +1,21 @@ # 基础部分 +本页包含内容： + +- 常量与变量 +- 注释 +- 分号 +- 整数 +- 浮点数 +- 类型安全和类型推断 +- 数值类原始值 +- 数值类型转换 +- 类型别名 +- 布尔值 +- 元组 +- 可选项 +- 声明 + Swift 是 iOS 和 OS X 应用开发的一门新语言。然而，如果你有 C 或者 Objective-C 开发经验的话，你会发现 Swift 的很多内容都是你熟悉的。 Swift 的类型是在 C 和 Objective-C 的基础上提出的，`Int`是整型；`Double`和`Float`是浮点型；`Bool`是布尔型；`String`是字符串。Swift 还有两个有用的集合类型，`Array`和`Dictionary`，详情参见`集合类型(待添加链接)`。 @@ -129,6 +145,7 @@ Swift 中的注释与C 语言的注释非常相似。单行注释以双正斜杠 let cat = "🐱"; println(cat) // prints "🐱" +<<<<<<< HEAD ## 整数 @@ -288,3 +305,4 @@ Swift 是类型安全的，会在编译你的代码时进行类型检查，如 > 注意：结合数字类常量和变量不同于结合数字类原始值。原始值`3`可以直接和原始值`0.14159`相加，因为数字原始值本身没有明确的类型。它们的类型只在编译器需要求值的时候被推测。 +======= \ No newline at end of file From e6ca8102de549eceeac0bc405cdf96cee853bfbc Mon Sep 17 00:00:00 2001 From: lyuka Date: Fri, 6 Jun 2014 20:29:32 +0800 Subject: [PATCH 3/4] add list, modify a to -3 --- source/chapter2/01_The_Basics.md | 172 +++++++++++++++++++++++++++++-- 1 file changed, 166 insertions(+), 6 deletions(-) diff --git a/source/chapter2/01_The_Basics.md b/source/chapter2/01_The_Basics.md index 565347aa..ccaac95e 100644 --- a/source/chapter2/01_The_Basics.md +++ b/source/chapter2/01_The_Basics.md @@ -96,14 +96,14 @@ Swift 是一个类型安全的语言，可选就是一个很好的例子。Swift let languageName = "Swift" languageName = "Swift++" // this is a compile-time error - languageName cannot be changed - + ### 输出常量和变量 你可以用`println`函数来输出当前常量或变量的值: println(friendlyWelcome) // prints "Bonjour!" - + `println`是一个用来输出的全局函数，输出的内容会在最后带换行。如果你用Xcode，`println`将会输出内容到“console”面板上。(另一种函数叫`print`，唯一区别是在输出内容最后不会加入换行。) `println`函数输出传入的`String`值： @@ -117,7 +117,7 @@ Swift用字符串插值（string interpolation）的方式把常量名或者变 println("The current value of friendlyWelcome is \(friendlyWelcome)") // prints "The current value of friendlyWelcome is Bonjour! - + > 注意：字符串插值所有可用的选项在 字符串插值 这章中讲述。 ### 注释 @@ -131,9 +131,9 @@ Swift 中的注释与C 语言的注释非常相似。单行注释以双正斜杠 /* this is also a comment, but written over multiple lines */ - + 与C 语言多行注释不同的是，Swift 的多行注释可以嵌套在其它的多行注释之中。你可以先生成一个多行注释块，然后在这个注释块之中再嵌套成第二个多行注释。终止注释时先插入第二个注释块的终止标记，然后再插入第一个注释块的终止标记： - + /* this is the start of the first multiline comment /* this is the second, nested multiline comment */ this is the end of the first multiline comment */ @@ -145,4 +145,164 @@ Swift 中的注释与C 语言的注释非常相似。单行注释以双正斜杠 let cat = "🐱"; println(cat) // prints "🐱" - \ No newline at end of file +<<<<<<< HEAD + + +## 整数 + +整数就是没有小数部分的数字，比如`42`和`-23`。整数可以是有符号（正、负、零）或者无符号（正、零）。 + +Swift 提供了8、16、32和64位的有符号和无符号整数类型。这些整数类型和 C 语言的命名方式很像，比如8位无符号整数类型是`UInt8`，32位有符号整数类型是`Int32`。就像 Swift 的其他类型一样，整数类型采用大写命名法。 + +### 整数范围 + +你可以访问不同整数类型的`min`和`max`属性来获取对应类型的最大值和最小值： + + let minValue = UInt8.min // minValue 为 0，是 UInt8 类型的最小值 + let maxValue = UInt8.max // maxValue 为 255，是 UInt8 类型的最大值 + +### Int + +一般来说，你不需要专门指定整数的长度。Swift 提供了一个特殊的整数类型`Int`，长度与当前平台的原生字长相同： + +* 在32位平台上，`Int`和`Int32`长度相同。 +* 在64位平台上，`Int`和`Int64`长度相同。 + +除非你需要特定长度的整数，一般来说使用`Int`就够了。这可以提高代码一致性和可复用性。即使是在32位平台上，`Int`可以存储的整数范围也可以达到`-2147483648`~`2147483647`，大多数时候这已经足够大了。 + +### UInt + +Swift 也提供了一个特殊的无符号类型`UInt`，长度与当前平台的原生字长相同： + +* 在32位平台上，`UInt`和`UInt32`长度相同。 +* 在64位平台上，`UInt`和`UInt64`长度相同。 + +> 注意：尽量不要使用`UInt`，除非你真的需要存储一个和当前平台原生字长相同的无符号整数。除了这种情况，最好使用`Int`，即使你要存储的值已知是非负的。统一使用`Int`可以提高代码的可复用性，避免不同类型数字之间的转换，并且匹配数字的类型推测，详情参见[类型安全和类型推测](## 类型安全和类型推测)。 + +## 浮点数 + +浮点数是有小数部分的数字，比如`3.14159`，`0.1`和`-273.15`。 + +浮点类型比整数类型表示的范围更大，可以存储比`Int`类型更大或者更小的数字。Swift 提供了两种有符号浮点数类型： + +* `Double`表示64位浮点数。当你需要存储很大或者很高精度的浮点数时请使用此类型。 +* `Float`表示32位浮点数。精度要求不高的话可以使用此类型。 + +> 注意：`Double`精确度很高，至少有15位数字，而`Float`最少只有6位数字。选择哪个类型取决于你的代码需要处理的数字大小。 + +## 类型安全和类型推测 + +Swift 是一个类型安全的语言。类型安全的语言可以让你清楚地知道代码要处理的值的类型。如果你的代码需要一个`String`，你绝对不可能不小心传进去一个`Int`。 + +Swift 是类型安全的，会在编译你的代码时进行类型检查，如果遇到不匹配的类型会报错。这可以让你在开发的时候尽早发现并修复错误。 + +当你要处理不同类型的值时，类型检查可以帮你避免错误。然而，这并不是说你每次声明常量和变量的时候都需要显式指定类型。如果你没有显式指定类型，Swift 会使用类型推测来选择合适的类型。有了类型推测，编译器可以在编译代码的时候自动推测出表达式的类型。原理很简单，判断你赋的值即可。 + +因为有类型推测，和 C 或者 Objc 比起来 Swift 很少需要声明类型。常量和变量虽然需要明确类型，但是大部分工作并不需要你自己来完成。 + +当你声明常量或者变量并赋初值的时候类型推测非常有用。当你在声明常量或者变量的时候赋给它们一个原始值即可触发类型推测。（原始值就是会直接出现在你代码中的值，比如`42`和`3.14159`。） + +举个例子，如果你给一个新常量赋值`42`并且没有标明类型，Swift 可以推测出常量类型是`Int`，因为你给它赋的初值看起来很像一个整数： + + let meaningOfLife = 42 + // meaningOfLife 会被推测为 Int 类型 + +同理，如果你没有给浮点原始值标明类型，Swift 会推测你想要的是`Double`： + + let pi = 3.14159 + // pi 会被推测为 Double 类型 + +当推测浮点数的类型时，Swift 总是会选择`Double`而不是`Float`。 + +如果表达式中同时出现了整数和浮点数，会被推测为`Double`类型： + + let anotherPi = 3 + 0.14159 + // anotherPi 会被推测为 Double 类型 + +原始值`3`没有显式声明类型，而表达式中出现了一个浮点原始值，所以表达式会被推测为`Double`类型。 + +## 数值类原始值 + +整数原始值可以被写作： + +* 一个十进制数，没有前缀 +* 一个二进制数，前缀是`0b` +* 一个八进制数，前缀是`0o` +* 一个十六进制数，前缀是`0x` + +下面的所有整数原始值的十进制值都是`17`: + + let decimalInteger = 17 + let binaryInteger = 0b10001 // 二进制的17 + let octalInteger = 0o21 // 八进制的17 + let hexadecimalInteger = 0x11 // 十六机制的17 + +浮点原始值可以是十进制（没有前缀）或者是十六进制（前缀是`0x`）。小数点两边必须有至少一个十进制数字（或者是十六进制的数字）。浮点原始值还有一个可选的指数，在十进制浮点数中通过大写或者小写的`e`来指定，在十六进制浮点数中通过大写或者小写的`p`来指定。 + +如果一个十进制数的指数为`exp`，那这个数相当于基数和10^exp的乘积： +* 1.25e2 表示 1.25 × 10^2，等于 125.0。 +* 1.25e-2 表示 1.25 × 10^-2，等于 0.0125。 + +如果一个十六进制数的指数为`exp`，那这个数相当于基数和2^exp的乘积： +* 0xFp2 表示 15 × 2^2，等于 60.0。 +* 0xFp-2 表示 15 × 2^-2，等于 3.75。 + +下面的这些浮点原始值都等于十进制的`12.1875`： + + let decimalDouble = 12.1875 + let exponentDouble = 1.21875e1 + let hexadecimalDouble = 0xC.3p0 + +数值类原始值可以包括额外的格式来增强可读性。整数和浮点数都可以添加额外的零并且包含下划线，并不会影响原始值： + + let paddedDouble = 000123.456 + let oneMillion = 1_000_000 + let justOverOneMillion = 1_000_000.000_000_1 + +## 数值类型转换 + +通常来讲，即使代码中的整数常量和变量已知非负，也请使用`Int`类型。总是使用默认的整数类型可以保证你的整数常量和变量可以直接被复用并且可以匹配整数类原始值的类型推测。 +只有在必要的时候才使用其他整数类型，比如要处理外部的长度明确的数据或者为了优化性能、内存占用等等。使用显式指定长度的类型可以及时发现值溢出并且可以暗示正在处理特殊数据。 + +### 整数转换 + +不同整数类型的变量和常量可以存储不同大小的数字。`Int8`类型的常量或者变量可以存储的数字范围是`-128`~`127`，`UInt8`类型的常量或者变量能存储的数字范围是`0`~`255`。如果数字超出了常量或者变量可存储的范围，编译的时候会报错： + + let cannotBeNegative: UInt8 = -1 + // UInt8 类型不能存储负数，所以会报错 + let tooBig: Int8 = Int8.max + 1 + // Int8 类型不能存储超过最大值的数，所以会报错 + +因为每一个整数类型都可以存储不同范围的值，你必须根据情况来选择不同的转换方法。不同的转换方法可以暴露出隐藏的转换错误并让你的代码更加清晰。 + +要将一种数字类型转换成另一种，你要用当前值来初始化一个新数字，这个数字的类型就是你的目标类型。在下面的例子中，常量`twoThousand`类型是`UInt16`，然而常量`one`类型是`Uint8`。它们不能直接相加，因为它们类型不同。所以要调用`UInt16(one)`来创建一个新的`UInt16`数字并用`one`的值来初始化，然后使用这个新数字来计算： + + let twoThousand: UInt16 = 2_000 + let one: UInt8 = 1 + let twoThousandAndOne = twoThousand + UInt16(one) + +现在两个数字的类型都是`UInt16`，可以进行相加。目标常量`twoThousandAndOne`的类型被推测为`UInt16`，因为它是两个`UInt16`值的合。 + +`SomeType(ofInitialValue)`是调用 Swift 构造器并传入一个初始值的默认方法。在语言内部，`UInt16`有一个构造器，可以接受一个`UInt8`类型的值，所以这个构造器可以用现有的`UInt8`来创建一个新的`UInt16`。注意，你并不能传入任意类型的值，只能传入`UInt16`内部有对应构造器的值。不过你可以扩展现有的类型来让它可以接收其他类型的值（包括自定义类型），详情参见`扩展(链接待添加)`. + +### 整数和浮点数转换 + +整数和浮点数的转换必须显式指定类型： + + let three = 3 + let pointOneFourOneFiveNine = 0.14159 + let pi = Double(three) + pointOneFourOneFiveNine + // pi 等于 3.14159，所以被推测为 Double 类型 + +这个例子中，常量`three`的值被用来创建一个`Double`类型的值，所以加号两边的数类型相同。如果不进行转换，两者无法相加。 + +浮点数转换为整数也一样，整数类型可以用`Double`或者`Float`类型来初始化： + + let integerPi = Int(pi) + // integerPi 等于 3，所以被推测为 Int 类型 + +当用这种方式来初始化一个新的整数值时，浮点值会被截断。也就是说`4.75`会变成`4`，`-3.9`会变成`-3`。 + +> 注意：结合数字类常量和变量不同于结合数字类原始值。原始值`3`可以直接和原始值`0.14159`相加，因为数字原始值本身没有明确的类型。它们的类型只在编译器需要求值的时候被推测。 + +======= \ No newline at end of file From e513b2f2ca03b32a5d7761272f60bccae1297679 Mon Sep 17 00:00:00 2001 From: lyuka Date: Fri, 6 Jun 2014 21:31:57 +0800 Subject: [PATCH 4/4] add list --- source/chapter2/03_Strings_and_Characters.md | 15 +++++++++++++++ source/chapter2/06_Functions.md | 8 ++++++++ source/chapter2/07_Closures.md | 7 +++++++ source/chapter2/09_Classes_and_Structures.md | 10 +++++++++- .../chapter2/16_Automatic_Reference_Counting.md | 9 +++++++++ source/chapter2/19_Nested_Types.md | 5 +++++ source/chapter2/22_Generics.md | 10 ++++++++++ 7 files changed, 63 insertions(+), 1 deletion(-) diff --git a/source/chapter2/03_Strings_and_Characters.md b/source/chapter2/03_Strings_and_Characters.md index bf1527f2..3f32ea8b 100644 --- a/source/chapter2/03_Strings_and_Characters.md +++ b/source/chapter2/03_Strings_and_Characters.md @@ -1,5 +1,19 @@ # 字符串和字符 (Strings and Characters) +本页包含内容： + +- 字符串字面量 +- 初始化空字符串 +- 字符串可变性 +- 字符串是值类型 +- 使用字符 +- 计算字符数量 +- 连接字符串和字符 +- 字符串插值 +- 比较字符串 +- 字符串大小写 +- Unicode + **String** 是一个有序的字符集合，例如 "hello, world", "albatross"。 Swift 字符串通过 **String** 类型来表示，也可以表示为 **Character** 类型值的集合。 @@ -374,3 +388,4 @@ for scalar in dogString.unicodeScalars { // 🐶 ``` + \ No newline at end of file diff --git a/source/chapter2/06_Functions.md b/source/chapter2/06_Functions.md index f78aceac..18b56160 100644 --- a/source/chapter2/06_Functions.md +++ b/source/chapter2/06_Functions.md @@ -1,5 +1,13 @@ # 函数（Functions） +本页包含内容： + +- 函数定义与调用 +- 函数参数与返回值 +- 函数参数名称 +- 函数类型 +- 函数嵌套 + 函数是用来完成特定任务的独立的代码块。你给一个函数起一个合适的名字，用来标示函数做什么，并且当函数需要执行的时候，这个名字会被“调用”。 Swift统一的函数语法足够灵活，可以用来表示任何函数，包括从最简单的没有参数名字的C风格函数，到复杂的带局部和外部参数名的Objective-C风格函数。参数可以提供默认值，以简化函数调用。参数也可以即当做传入参数，也当做传出参数，也就是说，一旦函数执行结束，传入的参数值可以被修改。 diff --git a/source/chapter2/07_Closures.md b/source/chapter2/07_Closures.md index b651e336..15658a18 100644 --- a/source/chapter2/07_Closures.md +++ b/source/chapter2/07_Closures.md @@ -1,5 +1,12 @@ # 闭包 +本页内容包含： + +- 闭包表达式 +- Trailing闭包 +- 值捕获 +- 闭包是引用类型 + 闭包是功能性自包含模块，可以在代码中被传递和使用。 Swift 中的闭包与 C 和 Objective-C 中的 `blocks` 以及其他一些编程语言中的 `lambdas` 比较相似。 diff --git a/source/chapter2/09_Classes_and_Structures.md b/source/chapter2/09_Classes_and_Structures.md index cd582e95..43ceaa7c 100644 --- a/source/chapter2/09_Classes_and_Structures.md +++ b/source/chapter2/09_Classes_and_Structures.md @@ -1 +1,9 @@ -### 类和结构体 \ No newline at end of file +### 类和结构体 + +本页包含内容： + +- 类和结构体对比 +- 结构体和枚举是值类型 +- 类是引用类型 +- 类和结构体的选择 +- 集合（collection）类型的赋值与复制行为 \ No newline at end of file diff --git a/source/chapter2/16_Automatic_Reference_Counting.md b/source/chapter2/16_Automatic_Reference_Counting.md index d2d6fd59..c938d683 100644 --- a/source/chapter2/16_Automatic_Reference_Counting.md +++ b/source/chapter2/16_Automatic_Reference_Counting.md @@ -1,5 +1,14 @@ # 自动引用计数 +本页包含内容： + +- 自动引用计数的工作机制 +- 自动引用计数实践 +- 类实例间的强引用环 +- 类实例间的强引用环分解 +- 闭包的强引用环 +- 闭包的强引用环分解 + Swift使用自动引用计数(ARC)这一机制来跟踪和管理你的应用程序的内存。通常情况下，Swift的内存管理机制会一直起着作用，你无须自己来考虑内存的管理。ARC会在类的实例不再被使用时，自动释放其占用的内存。 然而，在少数情况下，ARC为了能帮助你管理内存，需要更多的关于你的代码之间关系的信息。本章描述了这些情况，并且为你示范怎样启用ARC来管理你的应用程序的内存。 diff --git a/source/chapter2/19_Nested_Types.md b/source/chapter2/19_Nested_Types.md index 90626875..900bc940 100644 --- a/source/chapter2/19_Nested_Types.md +++ b/source/chapter2/19_Nested_Types.md @@ -1,5 +1,10 @@ #类型嵌套 +本页包含内容： + +- 类型嵌套实例 +- 类型嵌套的引用 + 枚举类型常被用于实现特定类或结构体的功能。也能够在有多种变量类型的环境中，方便地定义通用类或结构体来使用，为了实现这种功能，Swift允许你定义类型嵌套，可以在枚举类型、类和结构体中定义支持嵌套的类型。 要在一个类型中嵌套另一个类型，将需要嵌套的类型的定义写在被嵌套类型的区域{}内，而且可以根据需要定义多级嵌套。 diff --git a/source/chapter2/22_Generics.md b/source/chapter2/22_Generics.md index 787fc460..3b779aac 100644 --- a/source/chapter2/22_Generics.md +++ b/source/chapter2/22_Generics.md @@ -1,6 +1,16 @@ # 泛型 ------ +本页包含内容： + +- 泛型所解决的问题 +- 泛型函数 +- 类型参数 +- 命名类型参数 +- 泛型类型 +- 类型约束 +- 关联类型 +- Where语句 *泛型代码*可以确保你写出灵活的，可重用的函数和定义出任何你所确定好的需求的类型。你的可以写出避免重复的代码，并且用一种清晰的，抽象的方式表达出来。