View source for Passing Variables And Features To A Macro

When a [[Macro]] is created, it can receive from the [[DMIS]] program both '''[[Variables]] and Features''' as argument.<br />

== Passing Variable to A Macro ==

In order to '''pass a [[variable]] to a [[Macro]]''' it is necessary to define in the [[macro]] declaration that the argument is a [[variable]]:<br />
<br />
<code><span style="color: green; text-decoration: none;">$$ Example of a MACRO Used with Variable</span><br/></code>
<code>M(PASSING_A_VARIABLE)=MACRO/MYVARIABLE<br /></code>
::<code>	DECL/LOCAL,CHAR,128,tmpString<br /></code>
::<code>	tmpString=ASSIGN/CONCAT('The Variable Passed is: ',STR(MYVARIABLE))<br /></code>
::<code>	TEXT/OPER,tmpString<br /></code>
<code>ENDMAC<br /></code>
<br />
<code>DECL/DOUBLE,PASSED_TO_MACRO<br /></code>
<code>PASSED_TO_MACRO=ASSIGN/100<br /></code>
<br />
<code>CALL/M(PASSING_A_VARIABLE),100<br /></code>
<code>CALL/M(PASSING_A_VARIABLE),PASSED_TO_MACRO<br /></code>


== Passing Feature to A Macro ==

In order to pass '''a featureto a [[Macro]]''' it is necessary to define in the [[macro]] declaration that the argument is a feature '''using the "'" in the declaration''' and, when calling the [[Macro]], '''use the "(" and ")"''' to inform that the feature has been passed.<br />
In the [[Macro]] the feature '''is passed as object''', so it can be access directly.
<br />
<code><span style="color: green; text-decoration: none;">$$ Example of a MACRO Used with Feature passed directly</span><br/></code>
<code>F(P1)=FEAT/POINT,CART,0,0,0,0,0,1</code>

<code>M(PASSING_A_FEATURE)=MACRO/'FEATURE'</code>
::<code>	DECL/LOCAL,DOUBLE, XX</code>
::<code>	XX=OBTAIN/F(FEATURE),3</code>
::<code>	tmpString=ASSIGN/CONCAT('The X VALUE OF THE PASSED POINT IS: ',STR(XX))</code>
::<code>	TEXT/OPER,tmpString</code>
<code>ENDMAC</code>

<code>CALL/M(PASSING_A_FEATURE),(P1)</code>

== Passing Feature to A Macro Using a Variable==

In order to pass a '''feature to a [[Macro]] using a [[Variable]]''' it is necessary to define in the [[macro]] declaration that the argument is a [[Variable]] (see above) and, when using the [[Macro]], '''use the "@" to access to the feature''' as [[variable]]:<br />
<br />
<code><span style="color: green; text-decoration: none;">$$ Example of a MACRO Used with Feature passed as Varible</span><br/></code>

<code>F(P1)=FEAT/POINT,CART,0,0,0,0,0,1</code>

<code>M(PASSING_A_FEATURE)=MACRO/FEATURE</code>
::<code>	DECL/LOCAL,DOUBLE, XX</code>
::<code>	XX=OBTAIN/F(@FEATURE),3</code>
::<code>	tmpString=ASSIGN/CONCAT('The X VALUE OF THE PASSED POINT IS: ',STR(XX))</code>
::<code>	TEXT/OPER,tmpString</code>
<code>ENDMAC</code>

<code>CALL/M(PASSING_A_FEATURE),'P1'</code>

== Passing Features and Variables to A Macro Using a Variable==

A [[macro]] can '''receive as arguments both features and Variables'''.<br />

In this case it is necessary to define in the [[macro]] declaration that the argument is a [[Variable]] or a Feature (see above) and, when using the [[Macro]], '''use the "@" or "(" and ")" to access to the feature or [[variable]]''':<br />
<br />
<code><span style="color: green; text-decoration: none;">$$ Example of a MACRO Used with Feature passed as Varible</span><br/></code>

<code>F(P1)=FEAT/POINT,CART,0,0,0,0,0,1<br /></code>
<code>F(P2)=FEAT/POINT,CART,1,0,0,0,0,1<br /></code>

<code>M(PASSING_A_FEATURE_AND_A_VARIABLE)=MACRO/'FEATURE_DIRECT',FEATURE_AS_VARIABLE,MYVARIABLE</code>
::<code>	DECL/LOCAL,DOUBLE, XX</code>
::<code>	DECL/LOCAL,DOUBLE, XX1</code>
::<code>	XX=OBTAIN/F(FEATURE_DIRECT),3</code>
::<code>	XX1=OBTAIN/F(@FEATURE_AS_VARIABLE),3</code>

::<code>	tmpString=[[Assign|ASSIGN]]/CONCAT('The X VALUE OF THE POINT PASSED DIRECTLY IS: ',STR(XX))
::<code>	TEXT/OPER,tmpString</code>
::<code>	tmpString=ASSIGN/CONCAT('The X VALUE OF THE POINT PASSED WITH VARIABLE IS: ',STR(XX1))</code>
::<code>	TEXT/OPER,tmpString</code>
::<code>	tmpString=ASSIGN/CONCAT('The Variable Passed is: ',STR(MYVARIABLE))<br /></code>
::<code>	TEXT/OPER,tmpString</code>
<code>ENDMAC</code>

<code>CALL/M(PASSING_A_FEATURE),(P1),'P2',100</code>


[[it:Passaggio di variabili e funzionalità a una macro]]
[[zh-cn:将变量和特征传递给宏]]
[[pt:Passando variáveis e recursos para uma macro]]
[[de:Übergeben von Variablen und Features an ein Makro]]
[[es:Pasar variables y características a una macro]]
[[en:Passing Variables And Features To A Macro]]

[[Category:Dmis_Tutorial]]