C++N4741(240)19.3.5 Scope of macro definitions [cpp.scope]p405

#はじめに(Introduction)
C++N4741 Working Draft, Standard for Programming Language C++
http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2017/
http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2017/n4741.pdf

C++N4741は、ISO/IEC JTC1 SC22 WG21の作業原案(Working Draft)です。
公式のISO/IEC 14882原本ではありません。
ISO/IEC JTC1 SC22 WG21では、可能な限り作業文書を公開し、幅広い意見を求めています。
一連の記事はコード断片をコンパイルできる形にする方法を検討してコンパイル、リンク、実行して、規格案の原文と処理系(g++, Clang++)との違いを確認し、技術内容を検討し、ISO/IEC JTC1 SC22 WG21にフィードバックするために用います。
Linux OSなどのhosted環境, TOPPERSカーネルなどのfreestanding環境におけるC++の機能と役割を確認したり、system CによるCPUの記述のtemplateによる再利用を検討しています。
CERT C++, MISRA C++等のコーディング標準のコード断片をコンパイルする際の参考にさせていただこうと考えています。CERT C++, MISRA C++が標準化の動きとの時間的なずれがあれば確認できれば幸いです。また、boostライブラリとの関連、g++(GCC), clang++(LLVM）との関係も調査中です。
何か、抜け漏れ、耳より情報がありましたらおしらせくださると幸いです。

##背景(back ground)
C/C++でコンパイルエラーが出ると、途方にくれることがしばしばあります。
何回かに１回は、該当するエラーが検索できます。
ただ、条件が違っていて、そこでの修正方法では目的を達成しないこともしばしばです。いろいろな条件のコンパイルエラーとその対応方法について、広く記録することによって、いつか同じエラーに遭遇した時にやくに立つことを目指しています。

この半年の間で、三度、自分のネットでの記録に助けられたことがあります。
また過去に解決できなかった記録を１０種類以上、最近になって解決できたことがあります。それは、主に次の4つの情報に基づいています。

https://stackoverflow.com
https://cpprefjp.github.io
http://ja.cppreference.com/
https://teratail.com/

また
https://researchmap.jp/joub9b3my-1797580/#_1797580
に記載したサイトのお世話になっています。

##作業方針(sequence)
Clang++では-std=c++03, c++17, C++2aの３種類
g++では-std=c++03, c++17の２種類
でコンパイルし、

１）コンパイルエラーを収集する。
２）コンパイルエラーをなくす方法を検討する。
コンパイルエラーになる例を示すだけが目的のコードは、コンパイルエラーをなくすのではなく、コンパイルエラーの種類を収集するだけにする。
文法を示すのが目的のコード場合に、コンパイルエラーをなくすのに手間がかかる場合は、順次作業します。
３）リンクエラーをなくす方法を検討する。
文法を示すのが目的のコード場合に、リンクエラーをなくすのに手間がかかる場合は、順次作業します。
４）意味のある出力を作る。
コンパイル、リンクが通っても、意味のある出力を示そうとすると、コンパイル・リンクエラーが出て収拾できそうにない場合がある。順次作業します。

１）だけのものから４）まで進んだものと色々ある状態です。一歩でも前に進むご助言をお待ちしています。「検討事項」の欄に現状を記録するようにしています。

### コーディング標準対応
コーディング標準の検討の下準備のコードとして、
コーディング標準を守って初期化をしてある方がいいという
考え方があります。
ここでは、逆に、コンパイラの警告がどれくらいコーディング標準の検査に役立つかを確かめたいという目的があります。

何か特別なコンパイラを使っていても、将来の可搬性を考えて、
g++, clang++, visual C++の三種類のコンパイラでコンパイルできるか、
三種類のコンパイラの警告は役立たないかを確認したい。

###初期化をしない理由
しばしば変数は初期化していません。
初期化したとしても、なるべく0,1ではなく、それ以外の数を代入するようにしています。コンパイラが、どういう警告を出すか、あるいは場合によってはコンパイルエラーにするかなどを確かめるためです。
こういうコードを実際に書いて欲しいという例ではありません。

###実行する理由
実行する意味があまりなさそうなコードを実行しているのは、実行時のエラーを収集する目的です。コンパイル・リンクは通っても、実行時のエラーに何が発生する可能性があるかを収集します。
万が一、実行時にリンクする仕組みや、空間を確保するとしたら、実行しないと振る舞いがわからないことがあります。

初めての　CEDD(Compile Error Driven Design) ８回直してコンパイル。
https://qiita.com/kaizen_nagoya/items/9494236aa1753f3fd1e1

コンパイルエラーを記録するとよい理由7つ
https://qiita.com/kaizen_nagoya/items/85c0e92b206883140e89

##C++N4741, 2018 Standard Working Draft on ISO/IEC 14882 sample code compile list
https://qiita.com/kaizen_nagoya/items/3294c014044550896010

## C++N4606, 2016符号断片編纂一覧(example code compile list)
C++N4606, 2016 Working Draft 2016, ISO/IEC 14882, C++ standard(1) Example code compile list
https://qiita.com/kaizen_nagoya/items/df5d62c35bd6ed1c3d43/

##C++N3242, 2011 sample code compile list on clang++ and g++
https://qiita.com/kaizen_nagoya/items/685b5c1a2c17c1bf1318

## 編纂器(Compiler)
###clang++ --version
clang version 6.0.0 (tags/RELEASE_600/final)
Target: x86_64-apple-darwin17.4.0

###g++-8 --version
g++-8 (Homebrew GCC 8.1.0) 8.1.0
Copyright (C) 2018 Free Software Foundation, Inc.

#(240)19.3.5 Scope of macro definitions [cpp.scope]p405

C++N4606, 2016(216) 16.3.5 Scope of macro definitions [cpp.scope] p447
https://qiita.com/kaizen_nagoya/items/3b7af677cfd7b7d9b25b

C++N3242, 2011(189) 16.3.5 Scope of macro definitions
https://researchmap.jp/joxx8376w-1797580/#_1797580

##p405.cpp
###算譜(source code)

```c++:p405.cpp
// C++N4741 Committee Draft, Standard for Programming Language C++
// http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2017/n741.pdf
const char* msg= "C++N4741(240)19.3.5 Scope of macro definitions [cpp.scope]p405.cpp";
// Edited by Dr. Ogawa Kiyoshi. Compile procedure and results record.

#include <iostream>
#include <cstdlib>

using namespace std;

#define TABSIZE 100
int table[TABSIZE];

#define max(a, b) ((a) > (b) ? (a) : (b))

int f(int i) {
  return i;
}

int y;
int x;
int* z;
int t;
int x1;
int x2;

#define x 3
#define f(a) f(x * (a))
#undef x
#define x 2
#define g f
#define z z[0]
#define h g(~
#define m(a) a(w)
#define w 0,1
#define t(a) a
#define p() int
#define q(x) x
#define r(x,y) x ## y
#define str(x) # x

void h1() {
  f(y+1) + f(f(z)) % t(t(g)(0) + t)(1);
  g(x+(3,4)-w) | h 5) & m
  (f)^m(m);
  p() i[q()] = { q(1), r(2,3), r(4,), r(,5), r(,) };
  char c[2][6] = { str(hello), str() };
///results in
  f(2 * (y+1)) + f(2 * (f(2 * (z[0])))) % f(2 * (0)) + t(1);
  f(2 * (2+(3,4)-0,1)) | f(2 * (~ 5)) & f(2 * (0,1))^m(0,1);
  int i[] = { 1, 23, 4, 5, };
  char c[2][6] = { "hello", "" };
}

#define str(s) # s
#define xstr(s) str(s)
#define debug(s, t) printf("x" # s "= %d, x" # t "= %s", \
x ## s, x ## t)
#define INCFILE(n) vers ## n
#define glue(a, b) a ## b
#define xglue(a, b) glue(a, b)
#define HIGHLOW "hello"
#define LOW LOW ", world"

void h2() {

  debug(1, 2);

  fputs(str(strncmp("abc\0d", "abc", '\4') // this goes away== 0) str(: @\n), s);

}
}

#include xstr(INCFILE(2).h)

void h3() {
  glue(HIGH, LOW);
  xglue(HIGH, LOW)
///results in
  printf("x" "1" "= %d, x" "2" "= %s", x1, x2);
  fputs("strncmp(\"abc\\0d\", \"abc\", ’\\4’) == 0" ": @\n", s);
}

#include "vers2.h" //(after macro replacement, before file access)
void h4() {
  "hello";
  "hello" ", world";
///or, after concatenation of the character string literals,
  printf("x1= %d, x2= %s", x1, x2);
  fputs("strncmp(\"abc\\0d\", \"abc\", ’\\4’) == 0: @\n", s);
}

#include "vers2.h"i// (after macro replacement, before file access)
void h5() {
  "hello";
  "hello, world";
}

#define t(x,y,z) x ## y ## z
int j[] = { t(1,2,3), t(,4,5), t(6,,7), t(8,9,),t(10,,), t(,11,), t(,,12), t(,,) };
///results in
int j[] = { 123, 45, 67, 89,10, 11, 12, };

#define OBJ_LIKE (1-1)
#define OBJ_LIKE /* white space */ (1-1) /* other */
#define FUNC_LIKE(a) ( a )
#define FUNC_LIKE( a )( /* note the white space */ \
a /* other stuff on this line
*/ )
///But the following redefinitions are invalid:
#define OBJ_LIKE (0) // different token sequence
#define OBJ_LIKE (1 - 1) // different white space
#define FUNC_LIKE(b) ( a ) // different parameter usage
#define FUNC_LIKE(b) ( b ) // different parameter spelling

#define debug(...) fprintf(stderr, __VA_ARGS__)
#define showlist(...) puts(#__VA_ARGS__)
#define report(test, ...) ((test) ? puts(#test) : printf(__VA_ARGS__))

void h6() {
  debug("Flag");
  debug("X = %d\n", x);
  showlist(The first, second, and third items.);
  report(x>y, "x is %d but y is %d", x, y);
///results in
  fprintf(stderr, "Flag");
  fprintf(stderr, "X = %d\n", x);
  puts("The first, second, and third items.");
  ((x>y) ? puts("x>y") : printf("x is %d but y is %d", x, y));
}

int main() {
  h1();
  h2();
  h3();
  h4();
  h5();
  h6();
  cout << msg << endl;
  return EXIT_SUCCESS;
}
```
###編纂・実行結果(compile and go)

```shell-session:c1.sh
$ ../c1.sh p405
$ clang++ p405.cpp  -std=c++2a -Wall
p405.cpp:41:34: error: called object type 'int' is not a function or function pointer
f(y+1) + f(f(z)) % t(t(g)(0) + t)(1);
                               ~ ^
p405.cpp:42:6: warning: expression result unused [-Wunused-value]
g(x+(3,4)-w) | h 5) & m
     ^
p405.cpp:29:11: note: expanded from macro 'g'
#define g f
          ^
p405.cpp:26:21: note: expanded from macro 'f'
#define f(a) f(x * (a))
                    ^
p405.cpp:42:10: warning: expression result unused [-Wunused-value]
g(x+(3,4)-w) | h 5) & m
~~~~~~~~~^~~
p405.cpp:29:11: note: expanded from macro 'g'
#define g f
          ^
p405.cpp:26:21: note: expanded from macro 'f'
#define f(a) f(x * (a))
                    ^
p405.cpp:42:23: warning: expression result unused [-Wunused-value]
g(x+(3,4)-w) | h 5) & m
                      ^
p405.cpp:32:16: note: expanded from macro 'm'
#define m(a) a(w)
               ^
p405.cpp:33:11: note: expanded from macro 'w'
#define w 0,1
          ^
p405.cpp:26:21: note: expanded from macro 'f'
#define f(a) f(x * (a))
                    ^
p405.cpp:43:7: error: use of undeclared identifier 'm'
(f)^m(m);
      ^
p405.cpp:47:31: error: subscripted value is not an array, pointer, or vector
f(2 * (y+1)) + f(2 * (f(2 * (z[0])))) % f(2 * (0)) + t(1);
                             ~^~
p405.cpp:26:21: note: expanded from macro 'f'
#define f(a) f(x * (a))
                    ^
p405.cpp:26:21: note: expanded from macro 'f'
#define f(a) f(x * (a))
                    ^
p405.cpp:48:11: warning: expression result unused [-Wunused-value]
f(2 * (2+(3,4)-0,1)) | f(2 * (~ 5)) & f(2 * (0,1))^m(0,1);
          ^
p405.cpp:26:21: note: expanded from macro 'f'
#define f(a) f(x * (a))
                    ^
p405.cpp:48:15: warning: expression result unused [-Wunused-value]
f(2 * (2+(3,4)-0,1)) | f(2 * (~ 5)) & f(2 * (0,1))^m(0,1);
       ~~~~~~~^~
p405.cpp:26:21: note: expanded from macro 'f'
#define f(a) f(x * (a))
                    ^
p405.cpp:48:46: warning: expression result unused [-Wunused-value]
f(2 * (2+(3,4)-0,1)) | f(2 * (~ 5)) & f(2 * (0,1))^m(0,1);
                                             ^
p405.cpp:26:21: note: expanded from macro 'f'
#define f(a) f(x * (a))
                    ^
p405.cpp:48:56: error: too many arguments provided to function-like macro invocation
f(2 * (2+(3,4)-0,1)) | f(2 * (~ 5)) & f(2 * (0,1))^m(0,1);
                                                       ^
p405.cpp:32:9: note: macro 'm' defined here
#define m(a) a(w)
        ^
p405.cpp:48:37: warning: '&' within '^' [-Wbitwise-op-parentheses]
f(2 * (2+(3,4)-0,1)) | f(2 * (~ 5)) & f(2 * (0,1))^m(0,1);
                       ~~~~~~~~~~~~~^~~~~~~~~~~~~~~
p405.cpp:48:37: note: place parentheses around the '&' expression to silence this warning
f(2 * (2+(3,4)-0,1)) | f(2 * (~ 5)) & f(2 * (0,1))^m(0,1);
                       ~~~~~~~~~~~~~^~~~~~~~~~~~~~
p405.cpp:48:52: error: use of undeclared identifier 'm'
f(2 * (2+(3,4)-0,1)) | f(2 * (~ 5)) & f(2 * (0,1))^m(0,1);
                                                   ^
p405.cpp:49:5: error: redefinition of 'i'
int i[] = { 1, 23, 4, 5, };
    ^
p405.cpp:44:5: note: previous definition is here
p() i[q()] = { q(1), r(2,3), r(4,), r(,5), r(,) };
    ^
p405.cpp:50:6: error: redefinition of 'c'
char c[2][6] = { "hello", "" };
     ^
p405.cpp:45:6: note: previous definition is here
char c[2][6] = { str(hello), str() };
     ^
p405.cpp:53:9: warning: 'str' macro redefined [-Wmacro-redefined]
#define str(s) # s
        ^
p405.cpp:38:9: note: previous definition is here
#define str(x) # x
        ^
p405.cpp:65:1: warning: format specifies type 'char *' but the argument has type 'int'
      [-Wformat]
debug(1, 2);
^~~~~~~~~~~
p405.cpp:56:9: note: expanded from macro 'debug'
x ## s, x ## t)
        ^~~~~~
<scratch space>:309:1: note: expanded from here
x2
^~
p405.cpp:72:2: error: embedding a #include directive within macro arguments is not supported
#include xstr(INCFILE(2).h)
 ^
p405.cpp:82:2: error: embedding a #include directive within macro arguments is not supported
#include "vers2.h" //(after macro replacement, before file access)
 ^
p405.cpp:91:2: error: embedding a #include directive within macro arguments is not supported
#include "vers2.h"i// (after macro replacement, before file access)
 ^
p405.cpp:97:9: warning: 't' macro redefined [-Wmacro-redefined]
#define t(x,y,z) x ## y ## z
        ^
p405.cpp:34:9: note: previous definition is here
#define t(a) a
        ^
p405.cpp:109:9: warning: 'OBJ_LIKE' macro redefined [-Wmacro-redefined]
#define OBJ_LIKE (0) // different token sequence
        ^
p405.cpp:103:9: note: previous definition is here
#define OBJ_LIKE /* white space */ (1-1) /* other */
        ^
p405.cpp:110:9: warning: 'OBJ_LIKE' macro redefined [-Wmacro-redefined]
#define OBJ_LIKE (1 - 1) // different white space
        ^
p405.cpp:109:9: note: previous definition is here
#define OBJ_LIKE (0) // different token sequence
        ^
p405.cpp:111:9: warning: 'FUNC_LIKE' macro redefined [-Wmacro-redefined]
#define FUNC_LIKE(b) ( a ) // different parameter usage
        ^
p405.cpp:105:9: note: previous definition is here
#define FUNC_LIKE( a )( /* note the white space */ \
        ^
p405.cpp:112:9: warning: 'FUNC_LIKE' macro redefined [-Wmacro-redefined]
#define FUNC_LIKE(b) ( b ) // different parameter spelling
        ^
p405.cpp:111:9: note: previous definition is here
#define FUNC_LIKE(b) ( a ) // different parameter usage
        ^
p405.cpp:114:9: warning: 'debug' macro redefined [-Wmacro-redefined]
#define debug(...) fprintf(stderr, __VA_ARGS__)
        ^
p405.cpp:55:9: note: previous definition is here
#define debug(s, t) printf("x" # s "= %d, x" # t "= %s", \
        ^
p405.cpp:67:7: error: unterminated function-like macro invocation
fputs(str(strncmp("abc\0d", "abc", '\4') // this goes away== 0) str(: @\n), s);
      ^
p405.cpp:53:9: note: macro 'str' defined here
#define str(s) # s
        ^
p405.cpp:139:2: error: expected expression
}
 ^
p405.cpp:139:2: error: expected '}'
p405.cpp:63:10: note: to match this '{'
void h2(){
         ^
15 warnings and 13 errors generated.
```

#検討事項(agenda)
役に立つまたは意味のあるコンパイルエラーを取る方法
役に立つまたは意味のある警告を取る方法
役に立つまたは意味のある他の出力

#参考資料(reference)

docker gnu(gcc/g++) and llvm(clang/clang++)
https://qiita.com/drafts/059874ea39c4de64c0f7

[C][C++]の国際規格案の例題をコンパイルするときの課題７つ。
https://qiita.com/kaizen_nagoya/items/5f4b155030259497c4de

C++N4606 Working Draft 2016, ISO/IEC 14882, C++ standardのコード断片をコンパイルするためにしていること
https://qiita.com/kaizen_nagoya/items/a8d7ee2f2e29e76c19c1


コンパイル用shell script C版(clangとgcc)とC++版(clang++とg++)
https://qiita.com/kaizen_nagoya/items/74220c0577a512c2d7da

Clang/Clang++(LLVM) gcc/g++(GNU) コンパイラ警告等比較
https://qiita.com/kaizen_nagoya/items/9a82b958cc3aeef0403f

C++2003とC++2017でコンパイルエラーになるならない事例集
https://qiita.com/kaizen_nagoya/items/a13ea3823441c430edff

Qiitaに投稿するCのStyle例(暫定)
https://qiita.com/kaizen_nagoya/items/946df1528a6a1ef2bc0d

cpprefjpのdecltypeをコンパイル試験
https://qiita.com/kaizen_nagoya/items/090909af702f0d5d8a67

MISRA C++ 5-0-16
https://qiita.com/kaizen_nagoya/items/7df2d4e05db724752a74

C++ Templates Part1 BASICS Chapter 3. Class Templates 3.2 Use of Class Template Stack stack1test.cpp
https://qiita.com/kaizen_nagoya/items/cd5fc49106fad5a4e9ed

ISO/IEC TS 17961:2013 C Secure Coding Rules(1) All list(to be confirmed)
https://qiita.com/kaizen_nagoya/items/54e056195c4f11b850a1

C言語（C++)に対する誤解、曲解、無理解、爽快。
https://qiita.com/kaizen_nagoya/items/3f3992c9722c1cee2e3a

C Puzzle Bookの有り難み5つ、C言語規格及びCコンパイラの特性を認識
https://qiita.com/kaizen_nagoya/items/d89a48c1536a02ecdec9

'wchar.h' file not found で困った clang++ macOS
https://qiita.com/kaizen_nagoya/items/de15cd46d657517fac11

Open POSIX Test Suiteの使い方を調べはじめました
https://qiita.com/kaizen_nagoya/items/644d5e407f5faf96e6dc

MISRA-C 2012 Referenceに掲載している文献の入手可能性を確認
https://qiita.com/kaizen_nagoya/items/96dc8b125e462d5575bb

どうやって MISRA Example Suiteをコンパイルするか
https://qiita.com/kaizen_nagoya/items/fbdbff5ff696e2ca7f00

MISRA C まとめ #include <misra_c.h>
https://qiita.com/kaizen_nagoya/items/f1a79a7cbd281607c7c9

「C++完全理解ガイド」の同意できること上位10
https://qiita.com/kaizen_nagoya/items/aa5744e0c4a8618c7671

#文書履歴(document history)
ver. 0.10 初稿 20180603