注释

为了使代码便于理解，我们会在程序中加一些注释，java中的注释主要有三种：单行注释、多行注释、文档注释

单行注释

单行注释以//开头，一行中//后面的部分是注释部分，不会被编译，//前面的部分正常编译。
如下代码实现了输入一个整数，将其加1后输出。其中a=0被注释了，因此不会起作用。

1
2
3
4
5
6
7
8
9
public class Example01 {
    public static void main(String[] args) {
        int a;
        Scanner in = new Scanner(System.in);
        a=in.nextInt();
        a=a+1;//a=0;
        System.out.println(a);
    }
}

多行注释

多行注释以/*开头，*/结尾
示例如下,代码实现输入整数a，输出整数a，其中注释掉了定义String类型的m并输入的两行代码，试想一下，这样的注释方法好吗？这个问题留到注释风格处解答。

1
2
3
4
5
6
7
8
9
10
public class Example02 {
    public static void main(String[] args) {
        int a;
        Scanner in = new Scanner(System.in);
        a=in.nextInt();
        /*String m;
          in.next();*/
        System.out.println(a);
    }
}

文档注释

文档注释以/**开头*/结束，看似与多行注释类似，实际上还是有一定区别的。
实例代码中是一个实现输出九九乘法表的方法，我们在方法的上面使用 文档注释对代码的书写日期、功能、实现进行了注释。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
/**
 1.   日期：2020/7/26
 2.   功能：输出九九乘法表
 3.   实现：两重循环，外层循环保证输出9行，
 4.        内层循环中j<=i控制了每行输出的行数。
 */
public void printTable(){
    for(int i=1;i<=9;i++){
        for(int j=1;j<=i;j++){
            System.out.print(j+"*"+i+"="+j*i+" ");
        }
        System.out.println();
    }        
}

嵌套注释这个小问题

  1. /* */可以嵌套在//外面
    例如上面的Example01，已有注释//a=0，我们可以用/**/将其上下几行均注释。
1
2
3
4
5
6
7
8
9
10
11
 public class Example01 {
    public static void main(String[] args) {
        /*
        int a;
        Scanner in = new Scanner(System.in);
        a=in.nextInt();
        a=a+1;//a=0;
        System.out.println(a);
        */
    }
}
  1. /* */不能嵌套在/* */外面
    以上面的Example02为例，显然，我们最上方的/*和in.next()后方的*/匹配了，导致*/后面的注释失效。
1
2
3
4
5
6
7
8
9
10
11
12
public class Example02 {
    public static void main(String[] args) {
        /*
        int a;
        Scanner in = new Scanner(System.in);
        a=in.nextInt();
        /*String m;
          in.next();*/
        System.out.println(a);
        */
    }
}

注释进阶，你该知道的

规范化注释

前段时间红警开源吹来了一阵风，很多人借此追忆当年，不过我们不妨看一段它的代码

在这里插入图片描述
我们自然看不懂它具体写的是什么逻辑，但依然可以看出注释比代码多、且十分整洁，整洁的原因是什么？
很容易发现，注释符号全部保证了列对齐，且和下面的语句也对齐，这样看起来注释就不会有突兀的感觉，起止的位置也十分清晰。
此外，如果根据注释的对象而言，我们可以分为几种：文档级注释、类级注释、方法级注释、行级注释，在写完代码后，我们可以按照这几级来查看是否有添加必要的注释。

自定义文件模板

在新建一个类时，多数IDE默认会为你生成类名、package包的代码，自定义文件模板就是设置在新建文件时自动生成的文件内容，方便我们快速开展工作。
在这里插入图片描述
如果我们想要在类创建时就自动为我们添加好上面2~7行的注释，应该怎么做？
这里介绍下IntelliJ IDEA中的做法，如果使用其他IDE的朋友自行搜索下。
在这里插入图片描述
在这里插入图片描述
掌握了类模板的自定义方法，其他的文件的操作方法也是类似的，不再赘述了。

javadoc导出注释

如果我们想把注释导出该怎么做？
例如下面这个程序

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
 /*
 **    Title:Person类
 **    Date: 2020/7/26
 **    Time: 11:35
 **    Func:通过Person类说明文档注释
 **    @author:ZhangSan
 **    @version:1.0
 */
 public class Person {
    public String name;
    /**
     * 这是Person类的构造方法
     * @param name ZhangSan
     */
    public Person(String name) {
        //执行语句;
    }
     /*
     **这是read()方法的说明
     ** @param bookName 读的书的名字
     ** @param time 读书需要的时间
     ** @return 读书数量
     */
     public int read(String bookName,int time){
         //执行语句
         return 0;
     }
}

我们可以进入程序所在的目录，使用javadoc的命令来生成和注释相关的html文档，如图所示
在这里插入图片描述
具体怎样操作？
由于不清楚看教程同学的基础，这里以最简单的方式来讲，如果有基础的同学相信能自行变通。

1. 在桌面建立一个文件夹，命名为FILE
2. 复制你的Person.java类到FILE文件夹中

这题有两种做法，一是DFS，二是利用STL的next_permutation函数，第二种比较简单，分析一下第一种做法。以N=3为例，结果为：1 2 31 3 22 1 32 3 13 1 23 2 1先上一下搜索结果示意图： 从图中我们可以看到，如果要用深度优先搜索来解决这个问题，当遇到相同的元素时应当避开（题目要求所产生的任一数字序列中不允许出现重复数字。） 因此，我们需要用一个chosen[i]来表示i这个值是否已经被选过。chosen[i]=1时已经被选过，chosen[i]=0时未选过。此外，对于每一层选中的元素，需要一个order[k]来表示第k层选中元素的值。下面上代码，读者可以看看代码中的注释并以N=3为例来模拟一下这个过程。 123456789101112131415161718192021222324252627282930313233343536373839#include <iostream>using namespace std;//order[K]表示...