Difference between revisions of "Macro"
| Line 1: | Line 1: | ||
'''Macro''' are sub-routines that allow to compact a sequence of instructions in a single command.<br/> | '''Macro''' are sub-routines that allow to compact a sequence of instructions in a single command.<br/> | ||
The macro command can be in the main program or in an external file.<br/> | The macro command can be in the main program or in an external file.<br/> | ||
| − | If the macro | + | |
| + | == == | ||
| + | If the macro description is inside the [[DMIS]] program, it should be written at the beginning of it but, in any case, prior to the execution of the Macro command itself.<br/> | ||
<code><span style="color: green; text-decoration: none;">$$ Example of a MACRO declaration</span><br/></code> | <code><span style="color: green; text-decoration: none;">$$ Example of a MACRO declaration</span><br/></code> | ||
| Line 31: | Line 33: | ||
== == | == == | ||
| − | + | If the macro is located in an external file (for example to make sure that the macro can be shared between more programs), then the macro file shall be inserted in the program using the procedure to [[Include an External Macro File]] at the beginning of the program using an ‘EXTFIL’ command. | |
| + | In this case the macros are recalled from the specified external file. | ||
<code><span style="color: green; text-decoration: none;">$$ Use of an external file containing macro declaration</span><br/></code> | <code><span style="color: green; text-decoration: none;">$$ Use of an external file containing macro declaration</span><br/></code> | ||
Revision as of 07:16, 29 August 2017
Macro are sub-routines that allow to compact a sequence of instructions in a single command.
The macro command can be in the main program or in an external file.
If the macro description is inside the DMIS program, it should be written at the beginning of it but, in any case, prior to the execution of the Macro command itself.
$$ Example of a MACRO declaration
M(foro)=MACRO/off_x,off_y,'nome_ci'DECL/LOCAL,DOUBLE,r_foro,z_misr_foro=ASSIGN/6.25z_mis=ASSIGN/-2.5F(@nome_ci) = FEAT/CIRCLE, INNER, CART, off_x, off_y, z_mis, 0, 0, 1, r_foro*2MEAS/CIRCLE, F(@nome_ci), 4GOTO/off_x, off_y, 7PTMEAS/CART, off_x+r_foro, off_y, z_mis, -1, 0, 0PTMEAS/CART, off_x, off_y+r_foro, z_mis, 0, -1, 0PTMEAS/CART, off_x-r_foro, off_y, z_mis, 1, 0, 0PTMEAS/CART, off_x, off_y-r_foro, z_mis, 0, 1, 0GOTO/off_x, off_y, 7ENDMES$$ End of Macro Declaration
ENDMAC
$$ instructions$$ instructions
$$ Recall to execute the macro
CALL/M(foro),12.5,12.5,(foro1)
$$ instructions$$ instructions
If the macro is located in an external file (for example to make sure that the macro can be shared between more programs), then the macro file shall be inserted in the program using the procedure to Include an External Macro File at the beginning of the program using an ‘EXTFIL’ command. In this case the macros are recalled from the specified external file.
$$ Use of an external file containing macro declaration
EXTFIL/DMIS,'c:\cim\MACRO.dmi'
The external macro file has “.DML” extension, begins with DMISMD/ and ends with ENDFIL/.
Inside of the file, the syntax is the same as a regular DMIS program.
$$ Declaration of different Macro in an external file
DMISMD/'module_name'
$$ First Macro declarationM(macro_1)=MACRO/passedtextTEXT/OPER,CONCAT('You passed the following text to the macro: ',passedtext)
ENDMAC$$ Second Macro declarationM(macro_2)=MACRO/num1,num2DECL/DOUBLE,sumressumres=ASSIGN/num1+num2EXT/OPER,CONCAT('The sum of the 2 numbers is: ',STR(sumres))
ENDMAC
ENDFIL
