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