c++ - 我可以注释多行宏吗？

Question

我正在编写一些大型宏，并认为如果我可以向它们添加注释就好了，如下所示:

#define SOME_BIG_MACRO(input)\
  SOME_FUNCTION_CALL() \ // this does...
  SOME_OTHER_FUNCTION_CALL()

当我运行这个时，我得到:

prog.cpp:9:2: error: stray ‘\’ in program

有没有办法解决这个问题，或者只是无法注释多行宏？

Answer 1

除了宏的最后一行之外，无法在宏中使用//注释。

正如 Paul R 所建议的，/* comment */ 确实有效，并且似乎是唯一的选择:

#define SOME_BIG_MACRO(input)\
  SOME_FUNCTION_CALL()  /* this does... */ \
  SOME_OTHER_FUNCTION_CALL()

原因如下。 Standard for Programming Language C ++ (我只能访问此草案)指定源文件的物理行可以连接成编译器将看到的逻辑行，方法是使用 \ 后跟换行符:

Each instance of a backslash character () immediately followed by a new-line character is deleted, splicing physical source lines to form logical source lines. Only the last backslash on any physical source line shall be eligible for being part of such a splice.

这可以在预处理器输出中轻松检查:create file.cpp with

pri\
ntf ("Hell\
o world"\
);

然后

cpp file.cpp

给出

printf ("Hello world");

或

printf 
    ("Hello world");

这是编译器看到的内容(在 Ubuntu 上检查；您的情况可能会有所不同)。

现在，将此规则应用于多行宏，

#define SOME_BIG_MACRO(input)\
  SOME_FUNCTION_CALL() \
  SOME_OTHER_FUNCTION_CALL()

被预处理器理解为

#define SOME_BIG_MACRO(input)   SOME_FUNCTION_CALL()   SOME_OTHER_FUNCTION_CALL()

因为所有 \ 和下一个换行符都被忽略。

同样，

#define SOME_BIG_MACRO(input)\
  SOME_FUNCTION_CALL()  /* this does... */ \
  SOME_OTHER_FUNCTION_CALL()

被预处理器视为

#define SOME_BIG_MACRO(input)   SOME_FUNCTION_CALL()  /* this does... */   SOME_OTHER_FUNCTION_CALL()

但是，

#define SOME_BIG_MACRO(input)\
  SOME_FUNCTION_CALL()  \ // this does...
  SOME_OTHER_FUNCTION_CALL()

变成两行:

#define SOME_BIG_MACRO(input)   SOME_FUNCTION_CALL()  \ // this does...
  SOME_OTHER_FUNCTION_CALL()

因为第二个 \ 后面没有换行符，因此被保留，并且换行符前面没有 \ 。这会导致编译错误。

同时

#define SOME_BIG_MACRO(input)\
  SOME_FUNCTION_CALL()  // this does... \
  SOME_OTHER_FUNCTION_CALL()

变成一行:

#define SOME_BIG_MACRO(input)  SOME_FUNCTION_CALL()  // this does...   SOME_OTHER_FUNCTION_CALL()

语法上是正确的，但宏不完整。一些编译器将此报告为错误，因为这很可能不是程序员的意图。其他的，例如 Ubuntu cc，默默地应用标准定义的规则。

由于宏只能占用一个逻辑行(尽管有几行物理行，使用换行转义机制)，因此该行上的任何 //注释 都会导致其余所有行要忽略的宏。

结论: //comment 只能出现在(多行或单行)宏的末尾，而 /* comment */ 可以完美地出现在在宏内部使用。