为了方便大家阅读本书，本节介绍一下书中案例代码和图示的相关约定。 1.3.1 案例代码约定 作为一本编程方面的书，书中有很多案例代码，我们可以从图灵网站（www.ituring.com.cn）本书主页免费注册下载或者从智捷课堂提供的本书服务网站（www.51work6.com/ios1.php）下载，解压后会看到如图1-4所示的目录结构。 图1-4 源代码文件目录 ch2～ch24代表第2章到第24章的案例代码或一些资源文件，其中工程或工作空间的命名有如下几种形式。 二级目录标号，如“3.4”说明是3.4节中使用的工程（或工作空间）案例。 三级目录标号，如“3.8.3”说明是3.8.3节中使用的工程（或工作空间）案例。 有～的情况，如“3.8.1~3.8.2”说明是3.8.1节到3.8.2节共同使用的工程（或工作空间）案例。 对于没有标号的情况，由其所在的父目录说明是哪个章节的案例工程（或工作空间），如“RioOlympics2016”说明是在第24章中使用的。 此外，一般情况下会有ObjC和Swift两个目录，ObjC目录中是Objective-C版本的工程，Swift目录中是Swift版本的工程。 书中出现的代码如果有Objective-C和Swift两个版本，会以左右两栏的形式显示，左栏为Swift代码，右栏为Objective-C代码。 1.3.2 图示的约定 为了更形象有效地说明知识点或描述操作，本书添加了很多图示，下面简要说明图示中一些符号的含义。 图中的圈框。有时读者会看到如图1-5所示的圈框，其中的内容是选中的内容或重点要说明的内容。 图1-5 图中圈框 图中的箭头。如图1-6和图1-7所示，箭头用于说明用户的动作，一般箭尾是动作开始的地方，箭头指向动作结束的地方。图1-7所示的虚线箭头在书中用得比较多，常用来描述设置控件的属性等操作，箭头指向代表打开XXX检测器。 图1-6 图中箭头1 图1-7 图中箭头2 图中手势。为了描述操作，我们在图中放置了 等手势符号，这说明点击了该处的按钮。如图1-8所示，屏幕下方的“更多…”按钮上面就有这个手势，说明用户点击了“更多…”按钮。 图1-8 图中手势 1.3.3 方法命名约定 苹果在官方文档中采用Objective-C多重参数描述API，它将方法名按照参数的个数分成几个部分。 提示 关于Objective-C多重参数，下面的代码用于在一个集合中按照索引插入元素： -（void）insertObject:(id)anObject atIndex:(NSInteger)index 图1-9所示说明了Objective-C多重参数方法的定义，第一个参数是anObject，参数类型是id类型，第二个参数是index，参数类型是NSUInteger，这叫做多重参数。它的返回类型是void，方法签名是insertObject:atIndex:。方法类型标识符中的-代表方法是实例方法，+代表方法是类方法。关于实例方法和类方法，我们将在后面的内容中讨论。如果上面的方法变成C或C++形式，则是下面的样子： void insertObjectAtIndex(id anObject,NSUInteger index) 图1-9 Objective-C多重参数方法的定义 苹果公司在推出Swift语言后，仍然采用多重参数描述API。图1-10所示为苹果API文档。 图1-10 苹果API文档 在图1-10中，我们描述了UITableView类的-numberOfRowsInSection:方法：其中-表示实例方法，+表示静态方法，:表示有参数。 该方法表示成为Swift语言，则是如下方法： func numberOfRowsInSection(_ section: Int) -> Int 该方法表示成为Objective-C语言，则是如下方法： - (NSInteger)numberOfRowsInSection:(NSInteger)section 为了统一命名，我们也采用苹果官方的提法，即在本书中提到Swift方法时，也采用-numberOfRowsInSection:表示多重参数形式特殊情况下我们会加以说明。 1.3.4 构造器命名约定 构造器是特殊的方法，它也采用Objective-C多重参数描述API，但是更为特殊，例如UITableView的构造器是-initWithFrame:style:，如图1-11所示。 该构造器表示成为Swift语言的形式如下： init(frame frame: CGRect, style style: UITableViewStyle) 该构造器表示成为Objective-C语言的形式如下： - (instancetype)initWithFrame:(CGRect)frame style:(UITableViewStyle)style 为了统一命名，我们也采用苹果官方的提法，即在本书中提到Swift构造器时也采用-initWithFrame:style:多重参数形式，特殊情况下我们会加以说明。 图1-11 苹果构造器API