本文将演示如何在方法列表中,对方法名称进行注释。
这样可以使程序,按功能分块,使方法清晰、易读并且方便定位。
在项目导航区,打开视图控制器的代码文件【ViewController.swift】
1 import UIKit 2 3 class ViewController: UIViewController { 4 5 //MARK:- 6 //MARK:viewDidLoad 7 8 //给当前方法添加编译器指令,MARK右侧的横线符号,表示将在方法列表中,显示一条分割线 9 //添加方法的注释文字:viewDidLoad 10 override func viewDidLoad() { 11 super.viewDidLoad() 12 // Do any additional setup after loading the view, typically from a nib. 13 14 //在视图完成加载的方法中调用下文方法 15 self.addImage() 16 } 17 18 //MARK:- 19 //MARK:Do the main thing 20 21 //使用上文相同的方式,给方法添加注释 22 //创建一个方法, 23 func addImage() 24 { 25 //从项目资源文件夹中载入一张图片素材 26 let image = UIImage(named: "Pic") 27 //初始化一个图像视图,并为图像视图设置需要显示的图片 28 let imageView = UIImageView(image: image) 29 //设置图像视图位于(40,80),尺寸为(240,360) 30 imageView.frame = CGRect(x: 40, y: 80, 240, height: 360) 31 //将图像视图,添加到当前视图控制器的根视图 32 self.view.addSubview(imageView) 33 } 34 35 //MARK:- 36 //MARK:didReceiveMemoryWarning 37 override func didReceiveMemoryWarning() { 38 super.didReceiveMemoryWarning() 39 // Dispose of any resources that can be recreated. 40 } 41 }
然后点击编辑器顶部导航条,弹出当前类的所有方法和函数列表。
然后在列表中,观察方法名称上方的注释文字。
当类文件中含有大量方法时,给类添加注释指令,可以对代码进行逻辑组织,并且提高工作效率。
点击某个方法,将快速定位到方法所在的位置。