Visual C++ 别名包含的用法： #pragma include_alias

缘起：

 

用某些版本的DirectX SDK 来编译mpc时会遇到如下问题：

 

.....include/qedit.h(498) : fatal error C1083: Cannot open include file: 'dxtrans.h': No such file or directory

 

这是因为 dxtrans.h这个文件在某些版本的Microsoft DirectX SDK中由于某些未知原因在发布的根本就没有发布。

 

解决方法之一就是选择一个包含该文件的DirectX SDK来编译mpc。

解决方法之二是用如下补丁

 

 

--- src/apps/mplayerc/FakeFilterMapper2.cpp (revision 1164)

+++ src/apps/mplayerc/FakeFilterMapper2.cpp (working copy)

@@ -27,6 +27,11 @@

 #include "../../DSUtil/DSUtil.h"

 

 #include <initguid.h>

+#pragma include_alias( "dxtrans.h", "qedit.h" )

+#define __IDxtCompositor_INTERFACE_DEFINED__

+#define __IDxtAlphaSetter_INTERFACE_DEFINED__

+#define __IDxtJpeg_INTERFACE_DEFINED__

+#define __IDxtKey_INTERFACE_DEFINED__

 #include <qedit.h>

 

 

 

标准的include_alias使用语法为：

 

 

#pragma include_alias( "long_filename", "short_filename" )
#pragma include_alias( <long_filename>, <short_filename> )

意味着编译器在编译过程中会将严格匹配的头文件包含做如下替换

将所有 

#include "long_filename"

替换成

#include "short_filename"

同样将所有：

#include <long_filename>

替换成

#include <short_filename>

注意必须是完全匹配的情况才会被替换，因此下面的语法中的 "./mymath.h"和"sys/mymath.h"就不会被替换成math.h

#pragma include_alias("mymath.h", "math.h")
#include "./mymath.h"
#include "sys/mymath.h"

理论上可以用include_alias做如何文件名的替换，例如

#pragma include_alias( "api.h", "c:/version1.0/api.h" )
#pragma include_alias( <stdio.h>, <newstdio.h> )
#include "api.h"
#include <stdio.h>

"api.h"会被替换成"c:/version.0/api.h"

<stdio.h>会被替换成<newstdio.h>

但是如下语法则不会被替换：

#include <api.h>
#include "stdio.h"

一些例外情况参见：

http://msdn.microsoft.com/en-us/library/wbeh5h91.aspx