炫意html5
最早CSS3和HTML5移动技术网站之一

Swift 基础教程 – Swift 注释

在本文中,您将了解Swift注释,为什么以及如何使用它们。

注释是程序源代码中程序员可读的解释或注释。编译代码时,编译器将忽略它。

注释是为了让阅读代码的人更好地理解程序的意图和功能。在团队中工作时,为其他团队成员澄清代码的目的可能会很有帮助,或者在单独工作时,它可以起到提醒自己的作用。

Swift 注释及其类型

Swift有两种类型的注释:

1.单行注释

在Swift中,任何以两个斜杠 // 开头的行都是单行注释,所有以两个斜杠 // 开头的行都会被编译器忽略。

您可以在 playground 的顶部找到一个简单的示例:

//: Playground - noun: a place where people can play

它以两个斜杠 // 开头,并对文件提供了有意义的解释,例如:“Playground – noun: a place where people can play”。

示例1:单行注释

//Sample program
//stores 3.14 in variable pi
let pi = 3.14159 
print(pi)

上面的示例包含两个单行注释:

// Sample program
// stores 3.14 in variable pi

2.多行注释

如果您的注释包含多行,则可以将其括在中/*…*/。

多行注释以正斜杠开头,后跟星号(/*) ,以星号结尾,后跟正斜杠(*/)。Swift 编译器会忽略/* 和 */之间的所有内容。

/* 这是一个多行注释。
在您编写多行注释后,添加*,后跟/以结束它
*/

示例2:多行注释

/* 硬编码的 pi 值可能不那么精确。
因此,您可以使用内置数据类型计算更准确的值
*/
let pi = Double.pi
print(pi)

上面的示例包含多行注释。

/* 硬编码的 pi 值可能不那么精确。
因此,您可以使用内置数据类型计算更准确的值
*/

要记住的事情

尽管注释对于更好地理解所编写代码的意图很有意义。但是需要注意的是:

  1. 不要在多行中将注释包含在//中,尽管它是有效的,并且编译器忽略这些行。相反,应该把它放在多行注释/* … */中
    例如:

    //This is a comment.
    //Use it when necessary and precisely

    以上写注释的方法是正确的,但不建议这样做,因为如果注释大于一行,则需要写多行注释。更好的书写方式是将多行注释用作:

    /* This is a comment.
    Use it when necessary and precisely
    */
  2. 单行注释可以写在单独的一行中,也可以与代码一起写在同一行中。但是,建议在单独的行中使用注释。
    例如:

    let pi = 3.14159 //stores 3.14 in variable pi

    这种编写注释的方法是有效的。但是最好把注释写在单独一行:

    //stores 3.14 in variable pi
    let pi = 3.14159
  3. 即使您是一个团队中的单个开发人员,并且您是唯一一个编写代码的人,如果代码没有注释,您也很难在程序中找到它的用途。所以,准确地使用它,并提供一个有意义的描述。

  4. 使注释非常简单和有意义。

  5. 不要在代码上写不必要的注释。

  6. 在大多数情况下,请使用注释来解释“为什么”而不是“如何”。

炫意HTML5 » Swift 基础教程 – Swift 注释

Java基础教程Android基础教程