C_CG::File::SpecificationHeader 內容會指定要在規格檔案開頭產生的多行標頭。
在 C 中,SpecificationHeader 內容的預設內容如下:
/*******************************************************
Rational Rhapsody Developer for C : $Rational RhapsodyVersion
Login : $Login
Component : $ComponentName
Configuration : $ConfigurationName
Model Element : $FullModelElementName
//! Generated Date : $CodeGeneratedDate
File Path: $FullCodeGeneratedFileName
*******************************************************/
標頭格式字串可包含下列任意關鍵字:
- $ProjectName 是專案名稱。
- $ComponentName 是元件名稱(例如,HelloWorld)。
- $ConfigurationName 是配置名稱(例如,HelloWorld)。
- $ModelElementName 是對映至檔案的元素名稱。如果有多個元素,則此為第一個元素的名稱。
- $FullModelElementName 是對映至檔案的元素名稱(例如,Default),包括完整路徑。如果有多個元素,則此為第一個元素的名稱。
- $CodeGeneratedDate 是產生日期。
- $CodeGeneratedTime 是產生時間。
- $Rational RhapsodyVersion 是產生檔案的 IBM® Rational® Rhapsody® 版本(例如,7.5)。
- $Login 是產生檔案的使用者。
- $CodeGeneratedFileName 是產生檔案的名稱。
- $FullCodeGeneratedFileName 是完整檔名(例如,HelloWorld\Default.h)。
- $Tag 是所指定元素的標籤值。
- $Property 是具指定名稱的元素內容值。
若要避免冗餘編譯,Rational Rhapsody 會避免對字首為特殊字串(由 C_CG::File::DiffDelimiter 內容所定義)的特定幾行進行不必要的變更。
DiffDelimiter 預設值是 //!。
系統會以下列順序解析關鍵字:
- 預先定義的關鍵字(如 $Name)
- 內容關鍵字
- 標籤關鍵字
請注意下列事項:
- 可在括弧內寫入關鍵字名稱。例如:
$(Name)
- 如果某個關鍵字的值是多行,則每一個新行(除了第一行之外)都會以 C_CG::Configuration::DescriptionBeginLine 內容的值作為開頭;每一行會以 C_CG::Configuration::DescriptionEndLine 內容的值作為結尾。