Swift3.0 - 注釋

Swift3.0 - 真的很簡單
Swift3.0 - 數據類型
Swift3.0 - Array
Swift3.0 - 字典
Swift3.0 - 可選值
Swift3.0 - 集合
Swift3.0 - 流控制
Swift3.0 - 對象和類
Swift3.0 - 屬性
Swift3.0 - 函數和閉包
Swift3.0 - 初始化和釋放
Swift3.0 - 協議protocol
Swift3.0 - 類和結構體的區別
Swift3.0 - 枚舉
Swift3.0 - 擴展
Swift3.0 - 下標
Swift3.0 - 泛型
Swift3.0 - 異常錯誤
Swift3.0 - 斷言
Swift3.0 - 自動引用計數(strong,weak,unowned)
Swift3.0 - 檢測API
Swift3.0 - 對象的標識
Swift3.0 - 注釋
Swift3.0 - 元類型
Swift3.0 - 空間命名
Swift3.0 - 對象判等
Swift3.0 - 探究Self的用途
Swift3.0 - 類簇
Swift3.0 - 動態調用對象(實例)方法
Swift3.0 - 文本輸出
Swift3.0 - 黑魔法swizzle
Swift3.0 - 鏡像
Swift3.0 - 遇到的坑

  • 第一種 單行注釋
// 這是一個單行注釋
  • 第二種 多行數組
/* 這是一個注釋
多行注釋 */
  • 第三種 有頭和尾的多行注釋
 /* 注釋的開頭
 /*注釋的內容部分 */
 注釋的結尾*/
  • 第四種 標記函數
// MARK: - 標記在函數前面
  • 第五種 Java 風格注釋
/*
 * @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: 提示需要修改的地方

您覺得那種注釋風格比較好,請求留言討論

最后編輯于
?著作權歸作者所有,轉載或內容合作請聯系作者
平臺聲明:文章內容(如有圖片或視頻亦包括在內)由作者上傳并發布,文章內容僅代表作者本人觀點,簡書系信息發布平臺,僅提供信息存儲服務。

推薦閱讀更多精彩內容