SAL(微軟原始碼注釋語言)

SAL，全名Microsoft source code annotation language，是微軟VC++ 2010及後續版本開始推出的一種是用宏定義語言，用來注釋函式的參數和返回值，由於這些宏最終都被預處理器處理掉了，所以不會對原始碼有任何影響。

基本介紹

• 外文名：SAL
• 屬於：微軟原始碼注釋語言
• 可以：一方面讓使用者
• 用來注釋：函式的參數和返回值

這種注釋可以一方面讓使用者更加清楚API的使用方法，另一方面VS中的C++ 代碼分析器也會依靠這種宏注釋來分析代碼。

一般的函式：

void*memcpy(void*dest,constvoid*src,size_tcount);

使用SAL注釋後的函式：

void*memcpy(_Out_writes_bytes_all_(count)void*dest,_In_reads_bytes_(count)constvoid*src,size_tcount);

更多的 SAL 語法細節可以參考 MSDN 上的文檔。