《从零开始学Swift》学习笔记(Day 59)——代码排版

简介:

  代码排版包括空行、空格、断行和缩进等内容。代码排版内容比较多工作量很多,但是非常重要。

空行

   空行将逻辑相关的代码段分隔开,以提高可读性。下列情况应该总是添加空行:

  • 类型声明之前。

  • import语句前后。

  • 两个方法或函数之间。

  • 块注释或单行注释之前。

  • 方法或函数内的两个逻辑段之间,用以提高可读性。

  • 一个源文件的两个片段之间。

 空格

    在代码中有些位置是需要有空格的,这个工作量也是很大的。下列是使用空格的规范:

    1.赋值符号“=”前后有一个空格。varlet与标识符之间有一个空格。所有的二元运算符,应该使用空格将之与操作数分开。一元操作符和操作数之间不因该加空格,如:++--等。示例如下。

1
2
3
var a =  10
var c =  10
a += c + d


    2. 小左括号“(”之后,小右括号“)”之前不要有空格。示例如下。

1
a = (a + b) / (c * d)


    3. 大左括号“{”之前有一个空格。示例如下。

1
2
3
while  a == d {
     n++
}


     4. 在方法或函数参数之前间有一个空格,参数冒号与数据类型之间有一个空格。

    推荐使用:

1
2
3
4
func tableView(tableView:UITableView,didSelectRowAtIndexPath indexPath:NSIndexPath) {
  
     ...
}


   不推荐使用:

1
2
3
func tableView(tableView:UITableView,didSelectRowAtIndexPath indexPath:NSIndexPath) {
     ...
}


 断行

    一行代码的长度尽量避免超过80个字符,为了便于查看是否一行代码超出80个字符,很多IDE开发工具都可以在编辑窗口设置显示80行竖线。在Xcode中设置过程是打开菜单Xcode→Preferences,选择Text Editing标签,选中Show→Page guideat column 

    由于有的代码比较长需要断行,可以依据如下一般规范断开:

  • 在一个逗号后面断开。

  • 在一个操作符前面断开,要选择较高级别运算符断开,而非较低级别运算符断开。

  • 新的一行应该与上一行缩进两个级别(8个空格)

 缩进

4个空格常被作为缩进排版的一个单位,在开发时候使用制表符进行缩进,虽然默认情况下一个制表符等于8个空格,但是在不同的IDE工具中可能设置的一个制表符与空格对应个数会有所不同。在Xcode中默认是一个制表符对应4个空格,我们可以在Xcode中打开菜单Xcode→Preferences,选择Text Editing→Indentation标签,可以在Tab width中进行设置。 

缩进可以依据如下一般规范:

  • 在函数、方法、闭包、控制语句、计算属性等包含大括号“{}”代码块中,代码块中的内容与首行缩进一个级(4个空格)。

  • 如果是if语句中条件表达式的断行,那么新的一行应该与上一行缩进两个级别(8个空格),再往后的断行要与第一次的断行对齐。

 


本文转自 tony关东升 51CTO博客,原文链接:http://blog.51cto.com/tonyguan/1748346,如需转载请自行联系原作者

相关文章
|
6月前
|
Swift 数据安全/隐私保护
40 Swift中代码访问权限控制
Swift中代码访问权限控制
41 0
|
存储 Swift
Swift - Cell自适应+代码约束(SnapKit)横竖屏支持平铺+根据URL获取图片size
Swift - Cell自适应+代码约束(SnapKit)横竖屏支持平铺+根据URL获取图片size
179 0
|
Swift
Swift学习笔记——页面跳转
创建一个single view app后,项目中有main.storyboard,里面是一个viewcontroller。 那么我们如何实现页面跳转 首先添加一个导航控制器Navigation Controller。点击右上的➕,然后选择控件拖到面板上即可
1150 0
|
前端开发 测试技术 Swift
Swift学习笔记——新建项目
在xcode菜单中选择 new -> project -> single view app 点击next在弹出窗中填写项目名称 这里languge有可以选择object-c或swift作为项目语言。这里我们学习swift,所以选择swift。 如果language选择swift,下面的user interface可以选择swiftUI和storyboard。 SwiftUI是2019 年 WWDC 大会上,苹果在压轴环节向大众宣布了基于 Swift 语言构建的全新 UI 框架,与flutter类似,是用代码编写页面,支持快速预览。
667 0
swift4.0 代码设置阴影
有的时候,项目中会用到阴影的效果,增加立体感。我们可以让设计师给出切图,用图片填充。我们还可以使用几句代码来实现简单的阴影效果。 实现效果图展示一: image.
1450 0
|
Swift iOS开发
Swift里的类继承,构造和析构代码
敲敲打打, 每天差不多一个小时来学这个, 相信到时候再用XCODE,感觉会熟悉很多。。
1310 0