C++N4741,2018(19)6.5 Program and linkage [basic.link]p47

# はじめに(Introduction)
C++N4741 Working Draft, Standard for Programming Language C++
http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2018/
http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2018/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にフィードバックするために用います。
また、CERT C++, MISRA C++等のコーディング標準のコード断片をコンパイルする際の参考にさせていただこうと考えています。CERT C++, MISRA C++が標準化の動きとの時間的なずれがあれば確認できれば幸いです。また、boostライブラリとの関連、Linux OS, TOPPERSカーネル、g++(GCC), clang++(LLVM）との関係も調査中です。
何か、抜け漏れ、耳より情報がありましたらおしらせくださると幸いです。

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

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

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

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

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

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

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

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

##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++-7 --version
g++-7 (Homebrew GCC 7.3.0_1) 7.3.0
Copyright (C) 2017 Free Software Foundation, Inc.
###cl(visual studio 2017)
Microsoft(R) C/C++ Optimizing Compiler Version 19.15.26726 for x64
Copyright (C) Microsoft Corporation.  All rights reserved.

https://docs.microsoft.com/ja-jp/cpp/what-s-new-for-visual-cpp-in-visual-studio
#(19)6.5 Program and linkage [basic.link]p47

C++N4606, 2016 (22)3.5 Program and linkage [basic.link]p61
https://qiita.com/kaizen_nagoya/items/157a0c31c86d1681f958

C++N3242, 2011 (22) 3.5 Program and linkage
https://researchmap.jp/jo29qh74d-1797580/#_1797580

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

```c++:p47.cpp
// C++N4741 Committee Draft, Standard for Programming Language C++
// http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2017/n741.pdf
#define msg "C++N4741(19)6.5 Program and linkage [basic.link]p47.cpp"
// Edited by Dr. Ogawa Kiyoshi. Compile procedure and results record.

#include <iostream>
#include <cstdlib>

using namespace std;

static void f();
static int i = 0; // #1
void g() {
  extern void f(); // internal linkage
  int i; // #2: i has no linkage
  {
    extern void f(); // internal linkage
    extern int i; // #3: external linkage, ill-formed
  }
}

namespace X {
void p() {
  q(); // error: q not yet declared
  extern void q(); // q is a member of namespace X
}
void middle() {
  q(); // error: q not yet declared
}
void q() { /* ... */ } // definition of X::q
}
void q() { /* ... */ } // some other, unrelated q

namespace Y {
template <class T> struct B {
  void g(T) { }
  void h(T);
  friend void i(B, T) { }
};
void f() {
  struct A {
    int x;
  }; // no linkage
  A a = { 1 };
  B<A> ba; // declares B<A>::g(A) and B<A>::h(A)
  ba.g(a); // OK
  ba.h(a); // error: B<A>::h(A) not defined; A cannot be named in another translation unit
  i(ba, a); // OK
}
}
int main() {
  X::p();
  q();
  f();
  g();
  cout<< msg << endl;
  return EXIT_SUCCESS;
}
```
###編纂・実行結果(compile and go)


```shell-session:clp.sh
$ ../cla.sh p47
$ clang++ p47.cpp -std=c++2a -Wall
p47.cpp:15:5: warning: unused variable 'i' [-Wunused-variable]
int i; // #2: i has no linkage
    ^
p47.cpp:24:1: error: use of undeclared identifier 'q'
q(); // error: q not yet declared
^
p47.cpp:28:1: error: use of undeclared identifier 'q'
q(); // error: q not yet declared
^
p47.cpp:46:2: error: called object type 'int' is not a function or function pointer
i(ba, a); // OK
~^
1 warning and 3 errors generated.
```

###Visual Studio 2017 
"cl *.cpp /EHsc /std:c++latest"

```
>cl p47.cpp /EHsc /std:c++latest
Microsoft(R) C/C++ Optimizing Compiler Version 19.15.26726 for x64
Copyright (C) Microsoft Corporation.  All rights reserved.

p47.cpp
p47.cpp(24): error C3861: 'q': 識別子が見つかりませんでした
p47.cpp(28): error C3861: 'q': 識別子が見つかりませんでした
```
##コンパイルエラー
を想定していた箇所のうち１箇所はコンパイルエラーにならず。コンパイルエラーにならない想定の箇所がコンパイルエラー。コンパイルエラーの箇所を註釈(///)に
###算譜(source code)

```c++:p47a.cpp
// C++N4741 Committee Draft, Standard for Programming Language C++
// http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2017/n741.pdf
#define msg "C++N4741(19)6.5 Program and linkage [basic.link]p47.cpp"
// Edited by Dr. Ogawa Kiyoshi. Compile procedure and results record.

#include <iostream>
#include <cstdlib>

using namespace std;

static void f();
static int i = 0; // #1
void g() {
  extern void f(); // internal linkage
  int i; // #2: i has no linkage
  {
    extern void f(); // internal linkage
    extern int i; // #3: external linkage, ill-formed
  }
}

namespace X {
void p() {
//q(); // error: q not yet declared
  extern void q(); // q is a member of namespace X
}
void middle() {
//q(); // error: q not yet declared
}
void q() { /* ... */ } // definition of X::q
}
void q() { /* ... */ } // some other, unrelated q

namespace Y {
template <class T> struct B {
  void g(T) { }
  void h(T);
  friend void i(B, T) { }
};
void f() {
  struct A {
    int x;
  }; // no linkage
  A a = { 1 };
  B<A> ba; // declares B<A>::g(A) and B<A>::h(A)
  ba.g(a); // OK
  ba.h(a); // error: B<A>::h(A) not defined; A cannot be named in another translation unit
//i(ba, a); // OK
}
}
int main() {
  X::p();
  q();
  f();
  g();
  cout<< msg << endl;
  return EXIT_SUCCESS;
}
```
###編纂・実行結果(compile and go)


```shell-session:cpla.sh
$ ../cla.sh p47a
$ clang++ p47a.cpp -std=c++2a -Wall
p47a.cpp:15:5: warning: unused variable 'i' [-Wunused-variable]
int i; // #2: i has no linkage
    ^
p47a.cpp:37:6: error: function 'Y::B<A>::h' is used but not defined in this translation unit, and cannot be
      defined in any other translation unit because its type does not have linkage
void h(T);
     ^
p47a.cpp:45:4: note: used here
ba.h(a); // error: B<A>::h(A) not defined; A cannot be named in another translation unit
   ^
p47a.cpp:11:13: warning: function 'f' has internal linkage but is not defined [-Wundefined-internal]
static void f();
            ^
p47a.cpp:52:3: note: used here
  f();
  ^
2 warnings and 1 error generated.
```
###Visual Studio 2017 
"cl *.cpp /EHsc /std:c++latest"

```
>cl p47a.cpp /EHsc /std:c++latest
Microsoft(R) C/C++ Optimizing Compiler Version 19.15.26726 for x64
Copyright (C) Microsoft Corporation.  All rights reserved.

p47a.cpp
p47a.cpp(57): error C2129: 静的関数 'void f(void)' が宣言されましたが定義されていません。
p47a.cpp(11): note: 'f' の宣言を確認してください
```
##コンパイルエラーを想定していた箇所が今度はコンパイルエラー。コンパイルエラーの箇所を註釈(///)に
###算譜(source code)

```c++:p47b.cpp
// C++N4741 Committee Draft, Standard for Programming Language C++
// http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2017/n741.pdf
#define msg "C++N4741(19)6.5 Program and linkage [basic.link]p47b.cpp"
// Edited by Dr. Ogawa Kiyoshi. Compile procedure and results record.

#include <iostream>
#include <cstdlib>

using namespace std;

static void f();
static int i = 0; // #1
void g() {
  extern void f(); // internal linkage
  int i; // #2: i has no linkage
  {
    extern void f(); // internal linkage
    extern int i; // #3: external linkage, ill-formed
  }
}

namespace X {
void p() {
//q(); // error: q not yet declared
  extern void q(); // q is a member of namespace X
}
void middle() {
//q(); // error: q not yet declared
}
void q() { /* ... */ } // definition of X::q
}
void q() { /* ... */ } // some other, unrelated q

namespace Y {
template <class T> struct B {
  void g(T) { }
  void h(T);
  friend void i(B, T) { }
};
void f() {
  struct A {
    int x;
  }; // no linkage
  A a = { 1 };
  B<A> ba; // declares B<A>::g(A) and B<A>::h(A)
  ba.g(a); // OK
//ba.h(a); // error: B<A>::h(A) not defined; A cannot be named in another translation unit
//i(ba, a); // OK
}
}
int main() {
  X::p();
  q();
  Y::f();
  g();
  cout<< msg << endl;
  return EXIT_SUCCESS;
}
```
###編纂・実行結果(compile and go)

```shell-session:cpla.sh
i$ ../cpla.sh p47b
$ clang++ p47b.cpp -std=c++03 -Wall
p47b.cpp:15:5: warning: unused variable 'i' [-Wunused-variable]
int i; // #2: i has no linkage
    ^
p47b.cpp:43:3: warning: template argument uses local type 'A' [-Wlocal-type-template-args]
B<A> ba; // declares B<A>::g(A) and B<A>::h(A)
  ^
p47b.cpp:11:13: warning: unused function 'f' [-Wunused-function]
static void f();
            ^
p47b.cpp:12:12: warning: unused variable 'i' [-Wunused-variable]
static int i = 0; // #1
           ^
4 warnings generated.
C++N4741(19)6.5 Program and linkage [basic.link]p47b.cpp
$ clang++ p47b.cpp -std=c++17 -Wall
p47b.cpp:15:5: warning: unused variable 'i' [-Wunused-variable]
int i; // #2: i has no linkage
    ^
p47b.cpp:11:13: warning: unused function 'f' [-Wunused-function]
static void f();
            ^
p47b.cpp:12:12: warning: unused variable 'i' [-Wunused-variable]
static int i = 0; // #1
           ^
3 warnings generated.
C++N4741(19)6.5 Program and linkage [basic.link]p47b.cpp
$ clang++ p47b.cpp -std=c++2a -Wall
p47b.cpp:15:5: warning: unused variable 'i' [-Wunused-variable]
int i; // #2: i has no linkage
    ^
p47b.cpp:11:13: warning: unused function 'f' [-Wunused-function]
static void f();
            ^
p47b.cpp:12:12: warning: unused variable 'i' [-Wunused-variable]
static int i = 0; // #1
           ^
3 warnings generated.
C++N4741(19)6.5 Program and linkage [basic.link]p47b.cpp

$ g++-7 p47b.cpp -std=c++03  -Wall
p47b.cpp: In function 'void g()':
p47b.cpp:18:12: warning: unused variable 'i' [-Wunused-variable]
 extern int i; // #3: external linkage, ill-formed
            ^
p47b.cpp:15:5: warning: unused variable 'i' [-Wunused-variable]
 int i; // #2: i has no linkage
     ^
p47b.cpp: In function 'void Y::f()':
p47b.cpp:43:4: error: template argument for 'template<class T> struct Y::B' uses local type 'Y::f()::A'
 B<A> ba; // declares B<A>::g(A) and B<A>::h(A)
    ^
p47b.cpp:43:4: error:   trying to instantiate 'template<class T> struct Y::B'
p47b.cpp:44:4: error: request for member 'g' in 'ba', which is of non-class type 'int'
 ba.g(a); // OK
    ^
p47b.cpp: At global scope:
p47b.cpp:11:13: warning: 'void f()' declared 'static' but never defined [-Wunused-function]
 static void f();
             ^
p47b.cpp:12:12: warning: 'i' defined but not used [-Wunused-variable]
 static int i = 0; // #1
            ^

$ g++-7 p47b.cpp -std=c++17  -Wall
p47b.cpp: In function 'void g()':
p47b.cpp:18:12: warning: unused variable 'i' [-Wunused-variable]
 extern int i; // #3: external linkage, ill-formed
            ^
p47b.cpp:15:5: warning: unused variable 'i' [-Wunused-variable]
 int i; // #2: i has no linkage
     ^
p47b.cpp: At global scope:
p47b.cpp:11:13: warning: 'void f()' declared 'static' but never defined [-Wunused-function]
 static void f();
             ^
p47b.cpp:12:12: warning: 'i' defined but not used [-Wunused-variable]
 static int i = 0; // #1
            ^
C++N4741(19)6.5 Program and linkage [basic.link]p47b.cpp
```

###Visual Studio 2017 
"cl *.cpp /EHsc /std:c++latest"

```
>cl p47b.cpp /EHsc /std:c++latest
Microsoft(R) C/C++ Optimizing Compiler Version 19.15.26726 for x64
Copyright (C) Microsoft Corporation.  All rights reserved.

p47b.cpp
p47b.cpp(57): error C2129: 静的関数 'void f(void)' が宣言されましたが定義されていません。
p47b.cpp(11): note: 'f' の宣言を確認してください
```

###修正
```c++:p47d.cpp
// C++N4741 Committee Draft, Standard for Programming Language C++
// http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2017/n741.pdf
#define msg "C++N4741(19)6.5 Program and linkage [basic.link]p47.cpp"
// Edited by Dr. Ogawa Kiyoshi. Compile procedure and results record.

#include <iostream>
#include <cstdlib>

using namespace std;

template <class T> struct B {
  void g(T) { }
  void h(T);
  friend void i(B, T) { }
};
void f() {
  struct A {
    int x;
  }; // no linkage
  A a = { 1 };
  B<A> ba; // declares B<A>::g(A) and B<A>::h(A)
  ba.g(a); // OK
//  ba.h(a); // error: B<A>::h(A) not defined; A cannot be named in another translation unit
  i(ba, a); // OK
}
int main() {
  f();
  cout<< msg << endl;
  return EXIT_SUCCESS;
}
```
###編纂・実行結果(compile and go)

```
$ clang++ p47d.cpp  -std=c++2a -Wall
C++N4741(19)6.5 Program and linkage [basic.link]p47.cpp
```
###Visual Studio 2017 
"cl *.cpp /EHsc /std:c++latest"

```


>cl p47d.cpp /EHsc /std:c++latest
Microsoft(R) C/C++ Optimizing Compiler Version 19.15.26726 for x64
Copyright (C) Microsoft Corporation.  All rights reserved.

p47d.cpp
Microsoft (R) Incremental Linker Version 14.15.26726.0
Copyright (C) Microsoft Corporation.  All rights reserved.

/out:p47d.exe
p47d.obj

C:\Users\Administrator\Downloads\N4741>p47d
C++N4741(19)6.5 Program and linkage [basic.link]p47.cpp
```
#検討事項(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 初稿 20180506
ver. 0.11 C++N4606, C++N3242 URL訂正 20180506
ver. 0.20 visual studio 2017 追記 20180918
### 最後までおよみいただきありがとうございました。
いいね　💚、フォローをお願いします。
####  Thank you very much for reading to the last sentence.
Please press the like icon 💚　and follow me for your happy life.