User Tools

Site Tools


pf:vars_and_functions

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Next revision
Previous revision
pf:vars_and_functions [2016/06/23 13:09] – created virgilwpf:vars_and_functions [2016/06/23 16:49] (current) – removed virgilw
Line 1: Line 1:
-[code] 
-=CMD 
-=COMMAND $VARNAME:DEF_VAL 
-=DESC  
-Defines an input variable. Input variables are created at script start and assigned either the default value, or a value specified in the editor. Input variables must start with a $ sign 
-=ENDDESC 
-=EX  
-$enemy:1 
-$particleType:0 
  
-CreateParticle(CurrentCoords 0 0 <-particleType <-enemy) 
-=ENDEX 
-=ENDCMD 
- 
-=CMD 
-=COMMAND ClearLocals 
-=DESC  
-Clears all local variables. Local variables persist across script invocations. 
-=ENDDESC 
-=EX  
-1 ->temp 
-trace(<-temp) #prints out 1 to the tracelog 
-ClearLocals 
-trace(<-temp) #prints out 0 to the tracelog 
-=ENDEX 
-=ENDCMD 
- 
-=CMD 
-=COMMAND --VARNAME 
-=DESC  
-Deletes VARNAME from the heap. It is now unassigned. 
-=ENDDESC 
-=EX  
-42 ->TheAnswer 
-trace(<-TheAnswer) #prints out 42 
---TheAnswer 
-trace(<-TheAnswer) #prints out 0 
-=ENDEX 
-=ENDCMD 
- 
-=CMD 
-=COMMAND <-VARNAME value 
-=DESC  
-Reads the contents of the local variable VARNAME and pushes it to the stack. If VARNAME does not exist, 0 is pushed to the stack. 
-=ENDDESC 
-=EX  
-#Increment a variable named 'i' by 1 and store the result back in 'i'  
-<-i add(1) ->i 
-=ENDEX 
-=ENDCMD 
- 
-=CMD 
-=COMMAND ->VARNAME (value) 
-=DESC 
-value ARG1: The value to pop from the stack and store in the heap at VARNAME.<p/>  
-Pops an item from the stack and stores it in the local variable named VARNAME. 
-=ENDDESC 
-=EX  
-# Store coordinate points in local variables.  
-# The points are defined once and assigned to local variables.  
-once  
- 10 ->x1  
- 20 ->y1  
- 40 ->x2  
- 50 ->y2  
-endonce 
-=ENDEX 
-=ENDCMD 
- 
-=CMD 
-=COMMAND -?VARNAME bool 
-=DESC  
-Checks to see if VARNAME exists (has been assigned). If so, 1 is pushed to the stack else 0. 
-=ENDDESC 
-=EX  
-if (not(-?unit)) 
- CreateUnit(10 20 "AmpGem") ->unit 
-endif 
-=ENDEX 
-=ENDCMD 
- 
-=CMD 
-=COMMAND <-! (string) value 
-=DESC  
-string ARG1: The string name of the heap variable to read.<p/> 
-Reads the contents of the local variable and pushes it to the stack. This allows dynamic reading of variables. 
-=ENDDESC 
-=EX  
-42 ->someVar 
-trace( <-!("someVar") ) 
-=ENDEX 
-=ENDCMD 
- 
-=CMD 
-=COMMAND ->! (value string) 
-=DESC  
-value ARG1: The value to store.<br/> 
-string ARG2: The string name of the heap variable to write to.<p/> 
-Pops a name of a variable and an item from the stack and stores the item in the variable. 
-=ENDDESC 
-=EX  
-->!(42 "someVar") 
-trace(<-someVar) 
-=ENDEX 
-=ENDCMD 
- 
-=CMD 
-=COMMAND -?! (string) bool 
-=DESC  
-string ARG1: The string name of the heap variable to check.<p/> 
-Takes a string from the stack and uses it as a variable name. Checks to see if the variable exists (has been assigned). If so, 1 is pushed to the stack else 0. 
-=ENDDESC 
-=EX  
-42 ->somevar 
-trace(-?!("somevar")) 
-=ENDEX 
-=ENDCMD 
- 
-=CMD 
-=COMMAND --? 
-=DESC  
-string ARG1: The string name of the heap variable to delete.<p/> 
-Finds a local variable by string name and deletes it. 
-=ENDDESC 
-=EX  
-42 ->theAnswer 
---?("theAnswer") 
-trace(<-theAnswer) 
-=ENDEX 
-=ENDCMD 
- 
-=CMD 
-=COMMAND @FUNC_NAME 
-=DESC  
-Invokes a function. Execution passes to the function that is named and returns to the statement after the call when the function is complete. Arguments can be passed to and received from functions via the stack. 
-=ENDDESC 
-=EX  
-if (@GetAnswer(true) eq(42)) 
- trace("The Answer") 
-endif 
- 
-:GetAnswer 
- ->really 
- if (really) 
- 42 
- else 
- 0 
- endif  
-=ENDEX 
-=ENDCMD 
- 
-=CMD 
-=COMMAND :FUNC_NAME 
-=DESC  
-Defines the beginning of a function block. Choose a unique name for the function. Statements after a function block only execute if called by invoking the function with an '@FUNC_NAME' call. The end of a function block is either the end of the script or the beginning of another function, whichever comes first. 
-=ENDDESC 
-=EX  
-if (@GetAnswer(true) eq(42)) 
- trace("The Answer") 
-endif 
- 
-:GetAnswer 
- ->really 
- if (really) 
- 42 
- else 
- 0 
- endif  
-=ENDEX 
-=ENDCMD 
- 
-=CMD 
-=COMMAND # 
-=DESC  
-Turns the rest of the line into a comment. Comments are not code: They do nothing. 
-=ENDDESC 
-=EX  
-#This is a comment, it does nothing. 
-=ENDEX 
-=ENDCMD 
- 
-[/code] 
pf/vars_and_functions.1466687357.txt.gz · Last modified: 2025/02/14 14:56 (external edit)