title | description | ms.date | author | ms.author | f1_keywords | helpviewer_keywords | ||||
---|---|---|---|---|---|---|---|---|---|---|
/ifcOutput |
Specify output file or directory for `.ifc` files. |
11/21/2022 |
tylermsft |
twhitney |
|
|
This switch tells the compiler where to output built .ifc
files. If the destination is a directory, then the compiler generates the name of each .ifc
file based on the interface name or the header unit name.
/ifcOutput
filename
/ifcOutput
directory\
By default, the compiler derives the name for each generated .ifc
file from the module interface name. For example, given a module name MyModule
, the generated .ifc
will be named MyModule.ifc
, unless you override the name with the /ifcOutput
switch.
Use this switch to specify an alternative .ifc
filename or directory. If you want to use the default built .ifc
filenames, but specify a directory where they should be built, ensure that you add a trailing backslash (\
) to the directory name.
When you're building multiple .ifc
files, only use the directory form of the /ifcOutput
switch. If you provide multiple /ifcOutput
switches, the compiler only uses the last one.
If you build with the /MP
(Build with multiple processes) switch, we recommend that you use the directory form of the /ifcOutput
switch if you have multiple input module files.
In the following example, the .ifc
file for module m
defined in m.ixx
is built as c:\example\m.ifc
.
cl ... /c /std:c++latest m.ixx /ifcOutput c:\example\
In the following example, the built .ifc
file for module m
defined in m.ixx
* is built as c:\example\MyModule.ifc
:
cl ... /c /std:c++latest m.ixx /ifcOutput c:\example\MyModule.ifc
-
To apply the
/ifcOutput
option to one file in the IDE, select the file in Solution Explorer. Right-click to open the context menu and select Properties to open the Property Pages dialog. -
Set the Configuration dropdown to All Configurations. Set the Platform dropdown to All Platforms.
-
Open the Configuration Properties > C/C++ > Output Files property page.
-
Use the dropdown control to modify the Module Output File Name property to a directory name (ending in
\
) or an alternate file name. Or you can specify a directory + file name, for example,c:\example\mymodule.ifc
. Choose OK or Apply to save your changes.
Alternatively, you can specify the /ifcOutput
switch with a right-click on the project name in the Solution Explorer > Configuration Properties > C/C++ > Command Line.
Overview of modules in C++
Using C++ Modules in MSVC from the Command Line