共用方式為


內建函式

在 SAL 的運算式可以是 C ++. /C 運算式,而則是沒有邊效果 (例如, C++ 的運算式條件下,--和函式呼叫都具有副作用在此內容中。 不過, SAL 提供可用來 SAL 運算式的一些類似函式的物件和某些保留的符號。 這些稱為 內建函式。

一般目的。

下列 instrinsic 函式附註為 SAL 提供一般公用程式。

註釋

描述

_Curr_

目前標註物件的同義字。 當 _At_ 標記法是在使用中時, _Curr_ 與第一個參數為 _At_。 否則,就是參數或註解所比較的整個函式/傳回值。

_Inexpressible_(expr)

表示使用註釋運算式 (例如,緩衝區大小太複雜而無法表示的情況,,會透過掃描輸入資料集然後計數選取的成員計算時。

_Nullterm_length_(param)

param 是元素數目緩衝區的等號 (但不包含 null 結束字元)。 它也可以套用至非彙總,非 void 型別所有緩衝區。

_Old_(expr)

當它在前置條件來評估, _Old_ 會傳回輸入值 expr。 當它在後置條件中評估,則會傳回 expr 值,因為它在前置條件中評估。

_Param_(n)

函式的第 n參數計數,從 1 到 n和 n 是常值整數常數。 如果參數名稱為,這個附註與名稱存取參數相同。

注意事項注意事項
n 可能參考是以省略符號定義的位置參數,或者可以在不使用名稱的函式原型。

return

C/C++ 保留的關鍵字 return 可用於 SAL 運算式表示函式的傳回值。 值只能在張貼狀態;它是使用其語法錯誤會發生在之前的狀態。

特定字串

下列內建函式附註啟用資料的作業。 上述四種函式符合同一個目的:傳回型別的項目數 null 結束字元之前找到。 差異在於這種所參考的項目的資料。 請注意,如果您要指定由字元所組成 null 結尾緩衝區的長度,請使用本節中的 _Nullterm_length_(param) 標記法。

註釋

描述

_String_length_(param)

param是不包含null terminator的緩衝區的元件數目。 這個標記法為字串型別字元是保留的名稱。

strlen(param)

param是不包含null terminator的緩衝區的元件數目。 這個標記法是保留給字元陣列的使用和類似 C 執行階段函式 strlen()

wcslen(param)

param是不包含null terminator的緩衝區的元件數目。 這個標記法是保留給在寬字元陣列的使用和類似 C 執行階段函式 wcslen()

請參閱

參考

註釋函式參數和傳回值

註釋函式行為

註釋結構和類別

註釋鎖定行為

指定套用註釋的時機和位置

最佳作法和範例 (SAL)

概念

了解 SAL

其他資源

使用 SAL 註釋減少 C/C++ 程式碼的缺失