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