Playground环境搭建
可以新建多个页面(New Playground Page),一个页面就是一个playground。
单行和多行注释
当我们新建一个Playground 的时候,Xcode 默认为我们生成了如下代码:
//: [Previous](@previous)
import Foundation
var str = "Hello, playground"
//: [Next](@next)
其中,第一行即是注释。当 Swift 编译器在编译代码的时候会忽略掉你的注释。
Swift 中的注释和 C 的注释以及Java的注释基本相同。如下:
// 这是单号注释
/**
这是多行注释
这是多行注释
*/
/* 我是多行注释start
// 我是嵌套的单行注释
/*
我是嵌套的多行注释
我是嵌套的多行注释*/
我是多行注释end */
注意,和其他语言不同的是,Swift的注释,支持多行注释中嵌套注释。
markup注释
支持markup语法,即markdown语法
//: ## 单行注释开启markup注释
/*:
# 一级标题
## 无序列表
- 第一项
- 第二项
## 有序列表
1. 第一项
2. 第二项
## 笔记
> This is a note
---
## 链接
[阳光沙滩](https://mp.sunofbeach.net)
*/
/** **函数描述**
## 函数注释,开启markup,建议使用多行
- 支持单行注释
- 支持多行注释
- 支持嵌套注释
- 支持markdown语法
*/
func showComments(){
}
showComments()
即:
单行注释 以 //: 开启
多行注释以 /*: 开启,而且要换一行开始写注释
函数注释以多行/** 开启
如果要查看Markup 的注释效果,可以使用菜单,“Editor-> Show Rendered Markup” 看到效果,如下:
如果要查看函数的markdown注释效果,可以在光标选择函数名,按住command键,显示函数的帮助信息如下: