[Swift]编程语言：文档修订历史

时间 2019-11-24

原文原文链接

★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★
➤微信公众号：山青咏芝（shanqingyongzhi）
➤博客园地址：山青咏芝（https://www.cnblogs.com/strengthen/）
➤GitHub地址：https://github.com/strengthen/LeetCode
➤原文地址：http://www.javashuo.com/article/p-rdqonjjo-cr.html
➤若是连接不是山青咏芝的博客园地址，则多是爬取做者的文章。
➤原文已修改更新！强烈建议点击原文地址阅读！支持做者！支持原创！
★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★html

2019年6月3日git

针对Swift 5.1进行了更新。
添加了有关指定其返回值符合的协议的函数的信息，而不是向“ 不透明类型”一章提供特定的命名返回类型。
添加了带隐式返回和速记吸气器声明的功能部分，其中包含有关省略的功能的信息return。
添加了有关使用类型上的标信息类型下标部分。
更新了结构类型的成员初始化程序部分，如今成员初始化程序支持省略具备默认值的属性的参数。
添加了有关动态成员的信息，这些成员在运行时经过关键路径查找到dynamicMemberLookup部分。
更新了“ 自我类型”部分，如今Self可用于引用当前类，结构或枚举声明引入的类型。

2019年3月25日github

更新了Swift 5.0。
添加了“ 扩展字符串分隔符”部分，并使用有关扩展字符串分隔符的信息更新了“ 字符串文字”部分。
添加了dynamicCallable部分，其中包含有关使用该dynamicCallable属性动态调用实例做为函数的信息。
添加了unknown和Switching Over Future Enumeration Cases部分，其中包含有关使用unknownswitch case属性处理switch语句中的将来枚举状况的信息。
\.self向Key-Path Expression部分添加了有关身份密钥路径（）的信息。
添加了有关<在平台条件中使用小于（）运算符到条件编译块部分的信息。

2018年9月17日编程

针对Swift 4.2进行了更新。
添加了有关访问全部枚举案例的信息到“ 迭代枚举案例”部分。
添加了有关信息#error，并#warning在编译时诊断的声明部分。
添加了有关内联到和属性下的声明属性部分的信息。inlinableusableFromInline
添加了有关在运行时按名称查找属性下的“声明属性”部分的成员的信息dynamicMemberLookup。
添加了有关“声明属性”部分的属性requires_stored_property_inits和warn_unqualified_access属性的信息。
添加了有关如何根据用于条件编译块部分的Swift编译器版本有条件地编译代码的信息。
添加了有关信息#dsohandle的文字表达的部分。

2018年3月29日swift

更新了Swift 4.1。
向Equivalence Operators部分添加了有关等价运算符的综合实现的信息。
加入约有条件协议一致性的信息扩展声明所述的部分声明章，向有条件符合的协议的部分协议章。
在“关联类型的约束”部分中为“ 使用协议”添加了有关递归协议约束的信息。
添加了有关信息canImport()和targetEnvironment()平台的条件，条件编译块。

2017年12月4日api

更新了Swift 4.0.3。
如今，关键路径支持下标组件，更新了“ 关键路径表达式”部分。

2017年9月19日数组

针对Swift 4.0进行了更新。
在Memory Safety章节中添加了有关内存独占访问的信息。
添加了关联类型和通用子句部分，如今您可使用通用where子句来约束关联类型。
添加了有关多字符串文字的信息字符串文字的部分字符串和字符章节，并以字符串文字的第词法结构篇章。
更新了的讨论objc属性的声明属性，如今，这个属性是在更少的地方推断。
添加了通用下标部分，如今下标能够是通用的。
更新在讨论协议组合的的部分协议章节，而且在协议组合类型的的部分类型章，如今协议组合物类型可包含一个超类的要求。
如今更新了扩展声明中的协议扩展的讨论，这final是不容许的。
向断言和前提条件部分添加了有关前置条件和致命错误的信息。

2017年3月27日缓存

更新了Swift 3.1。
添加了带有Generic Where子句的扩展部分，其中包含有关包含要求的扩展的信息。
添加了一个范围迭代到For-In Loops部分的示例。
向Failable Initializers部分添加了可用数字转换的示例。
向声明属性部分添加了有关将available属性与Swift语言版本一块儿使用的信息。
更新了“ 函数类型”部分中的讨论，以注意在编写函数类型时不容许使用参数标签。
如今，在条件编译块部分更新了对Swift语言版本号的讨论，如今容许使用可选的补丁号。
更新了“ 函数类型”部分中的讨论，如今Swift区分了采用多个参数的函数和采用元组类型的单个参数的函数。
从表达式章节中删除了动态类型表达式部分，如今这type(of:)是一个Swift标准库函数。

2016年10月27日微信

更新了Swift 3.0.1。
更新了“ 自动引用计数”一章中对弱引用和无引用引用的讨论。
添加了有关信息unowned，unowned(safe)以及unowned(unsafe)在声明修饰符的声明修饰语部分。
在Type Casting for Any和AnyObject部分添加了关于在Any指望type值时使用可选值的注释。
更新了“ 表达式”一章，以分隔对括号表达式和元组表达式的讨论。

2016年9月13日闭包

更新了Swift 3.0。
更新了函数章节和函数声明部分中函数的讨论，注意默认状况下全部参数都得到参数标签。
在Advanced Operators章节中更新了对运算符的讨论，如今您将它们实现为类型方法而不是全局函数。
添加了有关信息open和fileprivate访问级别修饰符的访问控制一章。
更新了inout“ 功能声明”部分中的讨论，注意它出如今参数类型的前面而不是参数名称的前面。
更新了对Escaping Closures和Autoclosures部分和属性章节中的属性@noescape和@autoclosure属性的讨论，由于它们是类型属性，而不是声明属性。
添加了有关运算符优先级组信息的优先级自定义中缀运算符中的部分高级操做员章，并以优先级组宣言中的部分声明篇章。
整个更新的讨论使用macOS而不是OS X，Error而不是ErrorProtocol和协议名称，ExpressibleByStringLiteral而不是StringLiteralConvertible。
更新在讨论WHERE子句通用的部分泛型的章节和通用参数和参数章，如今，通用where条款在声明的结尾写的。
更新了Escaping Closures部分中的讨论，如今默认状况下闭包是非脱节的。
更新的讨论在可选绑定一节的基础知识章和虽然声明中的部分陈述章，如今if，while和guard语句中使用的条件下不使用逗号分隔的列表where条款。
添加了有关具备多个模式的开关状况下的信息交换的部分控制流章和switch语句中的部分陈述章。
因为函数参数标签再也不是函数类型的一部分，所以更新了函数类型部分中函数类型的讨论。
更新协议组合物类型的讨论在协议组合的的部分协议章节和在协议组合类型的的部分类型章以使用新的语法。Protocol1 & Protocol2
更新了“动态类型表达式”部分中的讨论，以使用动态类型表达式的新type(of:)语法。
更新了对行控制语句的讨论，以使用#sourceLocation(file:line:)“ 行控制语句”部分中的语法。
更新了“ 永不返回的函数”中的讨论以使用新Never类型。
向Literal Expression部分添加了有关游乐场文字的信息。
更新了In-Out Parameters部分中的讨论，注意只有非转义闭包才能捕获输入输出参数。
在“ 默认参数值”部分更新了有关默认参数的讨论，如今它们没法在函数调用中从新排序。
更新了属性参数以在“ 属性”一章中使用冒号。
添加了有关将从新抛出函数的catch块内的错误抛出到Rethrowing Functions and Methods部分的信息。
添加了有关访问Objective-C属性的getter或setter 选择器到Selector Expression部分的信息。
向Type Alias Declaration部分添加了有关泛型类别别名和在协议内使用类型别名的信息。
更新了“ 函数类型”部分中函数类型的讨论，注意参数类型周围的括号是必需的。
更新了属性章节须要注意的是@IBAction，@IBOutlet和@NSManaged属性意味着@objc属性。
@GKInspectable在“声明属性”部分中添加了有关该属性的信息。
更新了“可选协议要求”部分中对可选协议要求的讨论，以阐明它们仅用于与Objective-C互操做的代码中。
删除了let在函数声明部分中明确使用函数参数的讨论。
如今该协议已从Swift标准库中删除，从语句章节中删除了对Boolean协议的讨论。
更正了“声明属性”部分中对@NSApplicationMain属性的讨论。

2016年3月21日

更新了Swift 2.2。
添加了有关如何根据用于条件编译块部分的Swift版本有条件地编译代码的信息。
添加了有关如何区分名称仅与Explicit Member Expression部分的参数名称不一样的方法或初始值设定项的信息。
#selector在“ 选择器表达式”部分添加了有关Objective-C选择器语法的信息。
更新了关联类型的讨论，以associatedtype在关联类型和协议关联类型声明部分中使用关键字。
更新了有关nil在Failable Initializers部分中彻底初始化实例以前返回的初始值设定项的信息。
添加了有关将元组与比较运算符部分进行比较的信息。
添加了有关将关键字用做关键字和标点符号部分的外部参数名称的信息。
更新了“声明属性”部分中对@objc属性的讨论，以指出枚举和枚举状况可使用此属性。
经过讨论包含点的自定义运算符更新了“ 运算符”部分。
在Rethrowing Functions and Methods部分添加了一个注释，从新抛出函数不能直接抛出错误。
向Property Observers部分添加了一个注释，说明在将属性做为输入输出参数传递时调用的属性观察者。
在A Swift Tour章节中添加了有关错误处理的部分。
更新了“ 弱参考”部分中的数字，以更清楚地显示从新分配过程。
删除了对C风格for循环，++前缀和后缀运算符以及--前缀和后缀运算符的讨论。
删除了对变量函数参数的讨论以及curried函数的特殊语法。

2015年10月20日

更新了Swift 2.1。
更新了字符串插值和字符串字面如今该字符串插值能够包含字符串文字部分。
添加了Escaping Closures部分，其中包含有关该@noescape属性的信息。
使用有关tvOS的信息更新了声明属性和条件编译块部分。
向In-Out Parameters部分添加了有关in-out参数行为的信息。
向Capture Lists部分添加了有关如何捕获闭包捕获列表中指定的值的信息。
经过可选连接更新了“ 访问属性”部分，以阐明经过可选连接进行的分配的行为方式。
改进了Autoclosures部分中对自动爆破的讨论。
添加了一个将??操做符用于A Swift Tour章节的示例。

2015年9月16日

针对Swift 2.0进行了更新。
向错误处理章节，Do语句部分，Throw Statement部分，Defer Statement部分和Try Operator部分添加了有关错误处理的信息。
如今全部类型都符合协议，更新了“ 表示和投掷错误”部分ErrorType。
try?向“ 将错误转换为可选值”部分添加了有关新关键字的信息。
在“ 枚举”一章的“ 递归枚举”部分和“声明”一章中的“ 任意类型的枚举的枚举”部分中添加了有关递归枚举的信息。
将有关API可用性检查的信息添加到“ 控制流”一章的“ 检查API可用性”部分和“ 语句”一章的“ 可用性条件”部分。
添加了有关新的信息guard语句将提早退出的部分控制流章和卫队声明中的部分陈述章。
添加了有关协议扩展到信息协议扩展了部分协议的篇章。
向访问控制章节的“ 单元测试目标的访问级别”部分添加了有关单元测试的访问控制的信息。
将有关新可选模式的信息添加到Patterns章节的Optional Pattern部分。
更新了Repeat-While部分，其中包含有关repeat- while循环的信息。
更新了字符串和字符章节，如今String再也不符合CollectionTypeSwift标准库中的协议。
print(_:separator:terminator)在“ 打印常量和变量”部分添加了有关新Swift标准库函数的信息。
在“ 枚举”一章String的“ 隐式分配的原始值”部分和“声明”一章的“ 包含原始值类型的案例的枚举”部分中添加了有关具备原始值的枚举个案行为的信息。
添加了有关@autoclosure属性（包括其@autoclosure(escaping)形式）的信息到Autoclosures部分。
使用有关和属性的信息更新了“声明属性”部分。@available@warn_unused_result
使用有关属性的信息更新了“ 类型属性”部分@convention。
添加了一个使用带有where子句的多个可选绑定到Optional Binding部分的示例。
向String Literals部分添加了有关如何+在编译时使用运算符链接字符串文字的信息。
向元类型类型部分添加了有关比较元类型值并使用它们构造具备初始化表达式的实例的信息。
在“ 使用断言调试”部分添加了关于什么时候禁用用户定义断言的注释。
如今，能够将属性应用于某些实例方法，更新了“声明属性”部分中对@NSManaged属性的讨论。
更新了Variadic Parameters部分，如今能够在函数参数列表的任何位置声明可变参数。
向Overriding a Failable Initializer部分添加了有关如何经过强制解包超类初始值设定项的结果，将不可用的初始化程序委托给可用的初始化程序的信息。
添加了有关将枚举案例用做“任何类型的案例的枚举”部分的函数的信息。
添加了有关将初始化程序显式引用到Initializer Expression部分的信息。
将有关构建配置和行控制语句的信息添加到“ 编译器控制语句”部分。
在元类型类型部分添加了一个关于从元类型值构造类实例的注释。
在弱引用部分添加了一个关于弱引用不适合缓存的注释。
更新了“ 类型属性”部分中的注释，以说起存储的类型属性已延迟初始化。
更新了捕获值部分，以阐明如何在闭包中捕获变量和常量。
更新了“声明属性”部分，以描述什么时候能够将@objc属性应用于类。
在处理错误部分添加了关于执行throw语句性能的注释。do在Do Statement部分添加了有关该语句的相似信息。
更新了“ 类型属性”部分，其中包含有关类，结构和枚举的存储和计算类型属性的信息。
使用有关标记的break语句的信息更新了Break Statement部分。
在更新后的一记地产观察家部分澄清的行为willSet和didSet观察员。
在“ 访问级别”部分添加了一个注释，其中包含有关private访问范围的信息。
在Weak References部分添加了一个注释，说明垃圾收集系统和ARC之间弱引用的差别。
使用更精确的Unicode标量定义更新了“ 字符串文字”中的“ 特殊字符”。

2015-04-09

针对Swift 1.2进行了更新。
Swift如今有一个本机Set集合类型。有关更多信息，请参阅集。
@autoclosure如今是参数声明的属性，而不是其类型。还有一个新的@noescape参数声明属性。有关更多信息，请参阅声明属性。
类型方法和属性如今使用static关键字做为声明修饰符。欲了解更多信息，请参阅类型变量属性。
斯威夫特如今包括as?和as!failable沮丧的运营商。有关更多信息，请参阅检查协议一致性。
添加了有关字符串索引的新指南部分。
从溢出运算符中删除溢出除法（&/）和溢出余数（&%）运算符。
更新了常量和常量属性声明和初始化的规则。有关更多信息，请参阅常量声明。
更新了字符串文字中Unicode标量的定义。请参阅字符串文字中的特殊字符。
更新范围运算符以注意具备相同开始和结束索引的半开范围将为空。
更新的闭包是参考类型，以阐明变量的捕获规则。
更新值溢出以阐明有符号和无符号整数的溢出行为
更新协议声明以阐明协议声明范围和成员。
更新定义捕获列表以阐明闭包捕获列表中弱和无主引用的语法。
更新的运算符以明确说起自定义运算符支持的字符的示例，例如数学运算符，杂项符号和标志Unicode块中的字符。
如今能够声明常量而不在本地函数范围中初始化。首次使用前，它们必须具备设定值。有关更多信息，请参阅常量声明。
在初始化程序中，常量属性如今只能分配一次值。有关更多信息，请参阅初始化期间分配常量属性。
如今，多个可选绑定能够if做为逗号分隔的赋值表达式列表出如今单个语句中。有关更多信息，请参阅可选绑定。
一个可选的链式表达必须后缀表达式中出现。
协议强制转换再也不局限于@objc协议。
如今能够在运行时失败的类型转换使用as?or as!运算符，而且使用运算符键入保证不会失败的转换as。有关更多信息，请参阅类型转换运算符。

2014年10月16日

更新了Swift 1.1。
添加了Failable Initializers的完整指南。
添加了协议的Failable Initializer要求的说明。
类型的常量和变量Any如今能够包含函数实例。更新了Type Casting for Any和AnyObject中的示例，以显示如何检查并转换为switch语句中的函数类型。
具备原始值的枚举如今具备rawValue属性而不是toRaw()方法，而且具备rawValue参数而不是fromRaw()方法的可用初始化程序。有关更多信息，请参阅具备原始值类型的案例的原始值和枚举。
添加了一个关于Failable Initializers的新参考部分，它能够触发初始化失败。
自定义运算符如今能够包含该?字符。更新了运算符参考以描述修订的规则。从Custom Operators中删除了有效运算符字符集的重复描述。

2014年8月18日

描述Swift 1.0的新文档，这是Apple用于构建iOS和OS X应用程序的新编程语言。
在协议中添加了有关初始化程序要求的新部分。
添加了有关仅使用类的协议的新部分。
断言和前置条件如今可使用字符串插值。删除了相反的说明。
更新了“ 链接字符串和字符”部分，以反映这样的事实：值String和Character值不能再与加法运算符（+）或加法赋值运算符（+=）组合。这些运算符如今仅用于String值。使用Stringtype的append(_:)方法将单个Character值附加到字符串的末尾。
availability在“声明属性”部分中添加了有关该属性的信息。
Optionals再也不隐含地评估true它们什么时候具备值以及false什么时候不具备值，以免在使用可选Bool值时出现混淆。相反，nil使用==或!=运算符进行显式检查，以肯定可选项是否包含值。
Swift如今有一个Nil-Coalescing Operator（），若是它存在，它会解包一个可选的值，若是是可选的，则返回一个默认值。a ?? bnil
更新并扩展了“ 比较字符串”部分，以反映和演示字符串和字符比较以及前缀/后缀比较如今基于扩展字形集群的Unicode规范等效性。
您如今能够尝试设置属性的值，分配给下标，或经过Optional Chaining调用变异方法或运算符。有关经过可选连接访问属性的信息已相应更新，而且已扩展了经过可选连接调用方法检查方法调用成功的示例，以显示如何检查属性设置是否成功。
添加了有关经过可选连接访问可选类型的下标的新部分。
更新了“ 访问和修改阵列”部分，注意您不能再使用+=运算符将单个项目附加到数组。而是使用该append(_:)方法，或者使用+=运算符附加单项数组。
添加了一条说明该初始值a的范围运营商 a...b和a..<b不得超过终值越大b。
重写了继承章节，删除了对初始化程序覆盖的介绍性介绍。本章如今更多地关注在子类中添加新功能，以及使用覆盖修改现有功能。本章的Overriding Property Getters和Setters示例已被重写，以显示如何覆盖description属性。（在子类初始化程序中修改继承属性的默认值的示例已移至“ 初始化”一章。）
更新了“ 初始化程序继承和覆盖”部分，注意如今必须使用override修饰符标记指定初始值设定项的覆盖。
更新了Required Initializers部分，注意required如今在所需初始化程序的每一个子类实现以前编写修饰符，而且如今能够经过自动继承的初始化程序知足所需初始化程序的要求。
中缀运算符方法再也不须要该@infix属性。
前缀和后缀运算符的@prefix和@postfix属性已被和声明修饰符替换。prefixpostfix
添加了有关在该命令的说明前缀和后缀运算当两个前缀和后缀运算符应用于同一操做应用。
复合赋值运算符的运算符函数@assignment在定义函数时再也不使用该属性。
定义自定义运算符时指定修饰符的顺序已更改。你如今写，而不是，例如。prefix operatoroperator prefix
添加了有关dynamic声明修饰符中的声明修饰符的信息。
添加了有关类型推断如何与Literals一块儿使用的信息。
添加了有关curried函数的更多信息。
添加了有关访问控制的新章节。
更新了字符串和字符章节，以反映Swift的Character类型如今表明单个Unicode扩展字形集群的事实。包括有关Extended Grapheme Clusters的新部分以及有关Unicode标量值和比较字符串的更多信息。
更新了“ 字符串文字”部分，注意字符串文字中的Unicode标量如今写为\u{n}，其中n是0到10FFFF之间的十六进制数，即Unicode代码空间的范围。
该NSString length属性如今映射到Swift的本机String类型utf16Count，而不是utf16count。
斯威夫特的原生String类型将再也不有一个uppercaseString或lowercaseString财产。已删除字符串和字符中的相应部分，而且已更新各类代码示例。
添加了有关没有参数标签的初始化参数的新部分。
添加了有关必需初始化程序的新部分。
添加了有关可选元组返回类型的新部分。
更新了“ 类型注释”部分，注意能够在一行中使用一种类型注释定义多个相关变量。
在@optional，@lazy，@final，和@required属性如今是optional，lazy，final，和required 的声明修饰语。
更新了整本书，将其..<称为半开放式操做员（而不是“半封闭式操做员”）。
更新了“ 访问和修改字典”部分以注意Dictionary如今具备布尔isEmpty属性。
澄清了定义自定义运算符时可使用的完整字符列表。
nil和布尔人true，false如今是文学。
Swift的Array类型如今具备完整的值语义。更新了有关集合和数组可变性的信息，以反映新方法。还澄清了字符串数组和字典的赋值和复制行为。
数组类型速记语法如今编写为[SomeType]而不是SomeType[]。
添加了一个关于字典类型速记语法的新部分，编写为。[KeyType: ValueType]
添加了有关集类型的哈希值的新部分。
Closure Expressions的示例如今使用全局sorted(_:_:)函数而不是全局sort(_:_:)函数来反映新的数组值语义。
更新了有关结构类型的成员初始化程序的信息，以阐明即便结构的存储属性没有默认值，成员结构初始化程序也可用。
已更新为..<，而不是..对半开区间操做。
添加了扩展通用类型的示例。