字串化運算子 (#)

數字符號或「字串化」運算元 （#） 會將巨集參數轉換成字串常值，而不展開參數定義。 它只會與接受自變數的巨集搭配使用。 如果出現在巨集定義的型式參數之前，巨集引動過程傳入的實質引數會以引號括住並且將視為字串常值。 然後字串常值會取代巨集定義中每個字串化運算子和型式參數的組合。

注意

ANSI C 標準的 Microsoft C (6.0 版和之前版本) 擴充功能之前會展開字串常值和字元常數中的巨集型式引數，但目前已不再支援此功能。 依賴此延伸模組的程式代碼應該使用字串化 （#） 運算符重寫。

在第一個標記之前，並遵循實際自變數的最後一個標記，則會忽略空格符。 在實際引數中語彙基元之間的任何空白字元，在產生的字串常值中皆會縮短為單一空白字元。 因此，如果在實際自變數中的兩個標記之間發生批註，則會縮減為單一空格符。 產生的字串常值會自動與只以空格符分隔的任何相鄰字串常值串連。

此外，如果在字串常值中使用時，自變數中包含的字元通常需要逸出序列，例如引號 （"） 或反斜杠 （\） 字元，則必要的逸出反斜杠會自動插入字元之前。

Microsoft C++字串化運算符與包含逸出序列的字串搭配使用時，不會正確運作。 在此情況下，編譯程式會產生 編譯程序錯誤 C2017。

範例

下列範例顯示包含字串化運算子的巨集定義，以及叫用巨集的主要函式：

// stringizer.cpp
#include <stdio.h>
#define stringer( x ) printf_s( #x "\n" )
int main() {
   stringer( In quotes in the printf function call );
   stringer( "In quotes when printed to the screen" );
   stringer( "This: \"  prints an escaped double quote" );
}

stringer巨集會在前置處理期間展開，併產生下列程序代碼：

int main() {
   printf_s( "In quotes in the printf function call" "\n" );
   printf_s( "\"In quotes when printed to the screen\"" "\n" );
   printf_s( "\"This: \\\" prints an escaped double quote\"" "\n" );
}

In quotes in the printf function call
"In quotes when printed to the screen"
"This: \"  prints an escaped double quote"

下列範例示範如何展開巨集參數：

// stringizer_2.cpp
// compile with: /E
#define F abc
#define B def
#define FB(arg) #arg
#define FB1(arg) FB(arg)
FB(F B)
FB1(F B)

另請參閱

預處理器運算元