Share via


alloc_text pragma

將指定函式定義放置所在的程式碼區段命名。 pragma必須在函式宣告子與具名函式的函式定義之間發生。

語法

#pragma alloc_text( text-section , function_1 [ , function_2 ... ])

備註

alloc_textpragma 不會處理 C++ 成員函式或多載函式。 它只適用于以 C 連結宣告的函式,也就是使用連結規格宣告的 extern "C" 函式。 如果您嘗試在具有 C++ 連結的函式上使用此功能 pragma ,則會產生編譯器錯誤。

由於不支援使用 __based 函式定址,因此指定區段位置需要使用 alloc_textpragma 。 text-section 指定的名稱應該以雙引號括住。

alloc_textpragma 必須出現在任何指定函式的宣告之後,以及這些函式的定義之前。

alloc_textpragma 參考的函式應該定義在與 相同的模組中 pragma 。 否則,如果未定義的函式稍後編譯成不同的文字區段,錯誤可能會或可能不會攔截。 雖然程式通常會正確執行,但函式不會在預定的區段中配置。

的其他限制 alloc_text 如下:

  • 無法在函式內使用。

  • 使用時機必須是在函式宣告之後,但是在函式定義之前。

另請參閱

Pragma 指示詞和 __pragma_Pragma 關鍵字