// 这是一个单行注释
/* 这是一个注释
多行注释 */
/* 注释的开头
/*注释的内容部分 */
注释的结尾*/
// MARK: - 标记在函数前面
/*
* @func 定义一个查询学生成绩的接口
* @param name 学生姓名
* @param nums 序号
* @return 返回查询到的成绩
*/
/// The number of seconds from 1 January 1970 to the reference date, 1 January 2001.
public static let timeIntervalBetween1970AndReferenceDate: TimeInterval
/// 定义一个查询学生成绩的接口
///
/// let score = getScoreStudentName(name: "酷走天涯", nums: "111111111")
///
/// - Parameters:
/// - name: 学生姓名
/// - nums: 学号
/// - Returns: 返回学生成绩
func getScoreStudentName(name:String,nums:String)->Double{
return 0.0
}
好处:
按住option + 鼠标左键查看方法说明
让学习成为一种习惯
/**
定义一个查询学生成绩的接口
let score = getScoreStudentName(name: "酷走天涯", nums: "111111111")
- Parameters:
- name: 学生姓名
- nums: 学号
- Returns: 返回学生成绩
*/
// MARK: 定义一个查询学生成绩的接口
/// 定义一个查询学生成绩的接口
///
/// let score = getScoreStudentName(name: "酷走天涯", nums: "111111111")
///
/// - Parameters:
/// - name: 学生姓名
/// - nums: 学号
/// - Returns: 返回学生成绩
让学习成为一种习惯
让学习成为一种习惯
// MARK: 粗体标签
// WARNING: 警告提示
// TODO: 提示未完成的地方
// FIXME: 提示需要修改的地方
您觉得那种注释风格比较好,请求留言讨论