Swift - 注释



注释是程序中不会被编译器编译的特殊文本。注释的主要目的是向我们解释代码的特定行或整个程序中发生了什么。程序员通常会添加注释来解释程序中代码行的作用。

或者我们可以说注释是非可执行文本,它们就像给用户或程序员的笔记或提醒。在 Swift 中,我们可以通过三种不同的方式定义注释:

  • 单行注释

  • 多行注释

  • 嵌套多行注释

Swift 中的单行注释

单行注释用于在代码中添加只有一行的文本。单行注释以双斜杠 (//) 开头。编译器或解释器总是忽略它们,并且不会影响程序的执行。

语法

以下是单行注释的语法:

// Add your comment here

示例

添加单行注释的 Swift 程序。这里我们在程序中添加单行注释来解释 for-in 循环的工作原理。

import Foundation
let num = 7
let endNum = 10

// For loop to display a sequence of numbers
for x in num...endNum{
   print(x)
}

输出

7
8
9
10

Swift 中的多行注释

多行注释用于在程序中显示多行非可执行文本,以解释特定代码行的作用,或由开发人员添加警告、注释等。与其他编程语言一样,在 Swift 中,多行注释以斜杠后跟星号 (/*) 开头,以星号后跟斜杠 (*/) 结尾。

语法

以下是多行注释的语法:

/* Add your 
Mult-line comment here */

示例

添加多行注释的 Swift 程序。这里我们在程序中添加多行注释来解释如何添加两个长度相同的数组。

import Foundation

let arr1 = [1, 4, 6, 2]
let arr2 = [3, 5, 2, 4]

var result = [Int]()

/* Check the length of the array.
If they are equal then we add them using the + operator 
and store the sum in the result array */
if arr1.count == arr2.count {
   for i in 0..<arr1.count {
      let sum = arr1[i] + arr2[i]
      result.append(sum)
   }
   print(result)
} else {
   print("Arrays must of same length.")
}

输出

[4, 9, 8, 6]

Swift 中的嵌套多行注释

从 Swift 4 开始,多行注释中也包含一个新特性,即嵌套多行注释。现在允许您嵌套或在另一个多行注释中添加多行注释。即使代码块包含多行注释,它也可以轻松注释掉许多代码块。

语法

以下是嵌套多行注释的语法:

/* Add your multi-line comment.
/* Add your nested multi-line comment. */
End multi-line comment */

示例

添加嵌套多行注释的 Swift 程序。这里我们在程序中添加嵌套多行注释来添加添加两个数组的替代代码。

import Foundation
let arr1 = [1, 4, 6, 2]
let arr2 = [3, 5, 2, 4]

var result = [Int]()
/* Checks the length of the array.
If they are equal then we add them using the + operator 
and store the sum in the result array 
/*You can also use the following code to add two arrays:
if arr1.count == arr2.count {
   let result = zip(arr1, arr2).map(+)
   print(result)
*/
*/
if arr1.count == arr2.count {
   for i in 0..<arr1.count {
      let sum = arr1[i] + arr2[i]
      result.append(sum)
   }
   print(result)
} else {
   print("Arrays must of same length.")
}

输出

[4, 9, 8, 6]
广告