Define Macro - Revision history

Zinthose at 19:51, 12 October 2009

2009-10-12T19:51:23Z

â† Older revision		Revision as of 19:51, 12 October 2009
Line 1:		Line 1:
	[[Category:~~Functions &~~ Macros]]		[[Category:Compile-Time Macros]]
	{{PageAuthor\|Zinthose}}		{{PageAuthor\|Zinthose}}

Zinthose: /* Usage */ Added Command List

2009-09-30T19:19:16Z

Usage: Added Command List

â† Older revision		Revision as of 19:19, 30 September 2009
Line 8:		Line 8:
	* ReDefine macro to reassign a define easily.		* ReDefine macro to reassign a define easily.
	== Usage ==		== Usage ==
			=== Command List ===
			* ${Define} _Name _Value
			* ${ReDefine} _Name _Value
			* ${DefineOnce} _Name
			* ${ReDefineOnce} _Name

	=== Example ===		=== Example ===
	<highlight-nsis>		<highlight-nsis>

Zinthose: /* Example */ Added DefineOnce & ReDefineOnce Examples

2009-09-30T19:16:34Z

Example: Added DefineOnce & ReDefineOnce Examples

â† Older revision		Revision as of 19:16, 30 September 2009
Line 11:		Line 11:
	<highlight-nsis>		<highlight-nsis>
	## Recursive Define trick for one time value setting		## Recursive Define trick for one time value setting
	${~~Define~~} MSI_FilePath ~~`${Define} MSI_FilePath`~~		${DefineOnce} MSI_FilePath

	${MSI_FilePath} `$TEMP`		${MSI_FilePath} `$TEMP`
			DetailPrint `MSI_FilePath = "${MSI_FilePath}"`

			## Recursive ReDefine trick for one time value setting
			${ReDefineOnce} MSI_FilePath

			${MSI_FilePath} `$PROGRAMFILES`
	DetailPrint `MSI_FilePath = "${MSI_FilePath}"`		DetailPrint `MSI_FilePath = "${MSI_FilePath}"`

Zinthose: /* Macro Source */ Added DefineOnce and RedefineOnce Macros

2009-09-30T19:15:16Z

Macro Source: Added DefineOnce and RedefineOnce Macros

@@ Line 59: / Line 59: @@
          !macroend
      !endif
 !endif
 </highlight-nsis>

Zinthose: Initial Release

2009-09-30T18:19:09Z

Initial Release

New page

[[Category:Functions & Macros]]
{{PageAuthor|Zinthose}}

== Summary ==
Pure Pre-compiler macro that enhances the !define command.
* Once defined, value is locked and will not raise an error or be redefined. This is useful for assigning default values.
* Recursive define trick to allow a define to assign itself.
* ReDefine macro to reassign a define easily.
== Usage ==
=== Example ===
<highlight-nsis>
## Recursive Define trick for one time value setting
${Define} MSI_FilePath `${Define} MSI_FilePath`

${MSI_FilePath} `$TEMP`
DetailPrint `MSI_FilePath = "${MSI_FilePath}"`

## Standard Define
${Define} MSI_FileName `Install.msi`
DetailPrint `MSI_FileName = "${MSI_FileName}"`

## Redefine a previously defined value or create a new one
${ReDefine} MSI_FileName `Setup.msi`
DetailPrint `MSI_FileName = "${MSI_FileName}"`

${ReDefine} MSI_FileName `Deployment.msi`
DetailPrint `MSI_FileName = "${MSI_FileName}"`
</highlight-nsis>

== Macro Source ==
<highlight-nsis>
!ifmacrondef _Define
!ifndef Define
!define Define `!insertmacro _Define`
!macro _Define _Name _Value
!ifdef ${_Name}
!if `${${_Name}}` == ``
!undef ${_Name}
!define ${_Name} `${_Value}`
!else if `${${_Name}}` == `!insertmacro _Define ${_Name}`
!undef ${_Name}
!define ${_Name} `${_Value}`
!endif
!else
!define ${_Name} `${_Value}`
!endif
!macroend
!endif
!endif

!ifmacrondef _ReDefine
!ifndef ReDefine
!define ReDefine `!insertmacro _ReDefine`
!macro _ReDefine _Name _Value
!ifdef ${_Name}
!undef ${_Name}
!endif
!insertmacro _Define ${_Name} `${_Value}`
!macroend
!endif
!endif
</highlight-nsis>