/Zc:inline (unreferenzierte COMDAT entfernen)
Entfernt unreferenzierte Funktionen oder Daten, die COMDATs sind oder nur eine interne Bindung haben. Wenn /Zc:inline angegeben wird, erfordert der Compiler, dass Übersetzungseinheiten, die Inlinedaten oder Inlinefunktionen verwenden, auch die Definitionen für die Daten oder Funktionen enthalten müssen.
/Zc:inline[-]
Hinweise
Wenn /Zc:inline angegeben wird, gibt der Compiler keine Symbolinformationen für unreferenzierte COMDAT-Funktionen oder -Daten oder für Funktionen oder Daten, die nur eine interne Bindung haben, zurück. Diese Option ist standardmäßig deaktiviert (/Zc:inline-). Diese Optimierung vereinfacht einen Teil der Arbeit, die vom Linker in Releasebuilds oder wenn die Linkeroption /OPT:REF angegeben ist, durchgeführt wird. Wenn der Compiler diese Optimierung durchführt, kann er die Größe der .obj-Datei deutlich verringern und Linkergeschwindigkeiten verbessern. Diese Compileroption ist nicht aktiviert, wenn Optimierungen deaktiviert sind (/Od) oder /GL (Optimierung des ganzen Programms) angegeben wird.
Wenn /Zc:inline angegeben wird, erzwingt der Compiler die C++11-Anforderung, dass alle Funktionen, die als inline deklariert sind, über eine Definition in derselben Übersetzungseinheit verfügen müssen, wenn sie verwendet werden. Wenn die Option nicht angegeben wird, lässt Visual C++ nicht konformen Code zu, der Funktionen aufruft, die als inline deklariert sind, selbst wenn keine Definition sichtbar ist. Weitere Informationen finden Sie unter „C++11-Standard“ in den Abschnitten 3.2 und 7.1.2. Diese Compileroption wurde in Visual Studio 2013 Update 2 eingeführt.
Aktualisieren Sie nicht konformen Code, um die Option /Zc:inline zu verwenden. Dieses Beispiel zeigt, wie die nicht konforme Verwendung einer Inlinefunktionsdeklaration ohne Definition trotzdem kompiliert und verknüpft wird, wenn die Standardoption /Zc:inline- verwendet wird:
// example.h
// Compile by using: cl /W4 /EHsc /O2 zcinline.cpp example.cpp
#pragma once
class Example {
public:
inline void inline_call(); // declared but not defined inline
void normal_call();
Example() {};
};
// example.cpp
// Compile by using: cl /W4 /EHsc /O2 zcinline.cpp example.cpp
#include <stdio.h>
#include "example.h"
void Example::inline_call() {
printf("inline_call was called.\n");
}
void Example::normal_call() {
printf("normal_call was called.\n");
inline_call(); // with /Zc:inline-, inline_call forced into .obj file
}
// zcinline.cpp
// Compile by using: cl /W4 /EHsc /O2 zcinline.cpp example.cpp
#include "example.h"
void main() {
Example example;
example.inline_call(); // normal call when definition unavailable
}
Wenn /Zc:inline aktiviert wird, verursacht derselbe Code einen LNK2019-Fehler, weil der Compiler keinen Nicht-Inlinecodetext für Example::inline_call in example.obj ausgibt. Das führt dazu, dass der Nicht-Inlineaufruf in main ein nicht definiertes externe Symbol referenziert.
Zur Fehlerbehebung können Sie das Schlüsselwort inline aus der Deklaration von Example::inline_call entfernen, die Definition von Example::inline_call in die Headerdatei verschieben oder die Implementierung von Example in main.cpp verschieben. Im nächsten Beispiel wird die Definition in die Headerdatei verschoben, in der sie für jeden Aufrufer sichtbar ist, der den Header enthält.
// example2.h
// Compile by using: cl /W4 /EHsc /O2 zcinline2.cpp example2.cpp
#pragma once
#include <stdio.h>
class Example2 {
public:
inline void inline_call() {
printf("inline_call was called.\n");
}
void normal_call();
Example2() {};
};
// example2.cpp
// Compile by using: cl /W4 /EHsc /O2 zcinline2.cpp example2.cpp
#include "example2.h"
void Example2::normal_call() {
printf("normal_call was called.\n");
inline_call();
}
// zcinline2.cpp
// Compile by using: cl /W4 /EHsc /O2 zcinline2.cpp example2.cpp
#include "example2.h"
void main() {
Example2 example2;
example2.inline_call(); // normal call when definition unavailable
}
Weitere Informationen über Konformitätsprobleme in Visual C++ finden Sie unter Nicht dem Standard entsprechendes Verhalten.
So legen Sie diese Compileroption in der Visual Studio-Entwicklungsumgebung fest
Öffnen Sie das Dialogfeld Eigenschaftenseiten des Projekts. Ausführliche Informationen finden Sie unter Arbeiten mit Projekteigenschaften.
Wählen Sie den Ordner C/C++ aus.
Wählen Sie die Eigenschaftenseite Befehlszeile aus.
Ändern Sie die Eigenschaft Zusätzliche Optionen, damit sie /Zc:inline einschließt, und wählen Sie dann OK aus.