argCount: Difference between revisions

From RPTools Wiki
Jump to navigation Jump to search
(Initial write-up.)
 
m (Text replacement - "<source" to "<syntaxhighlight")
 
(7 intermediate revisions by 5 users not shown)
Line 1: Line 1:
{{stub}}
{{MacroFunction
{{MacroFunction
|name=argCount
|name=argCount
|version=1.3b51
|version=1.3b51
|description=
|description=
Returns the number of arguments passed to a defined function. Used within a defined function.
Is used to determine the number of arguments that have been passed to a user defined function.
User functions are defined with the {{code|defineFunction()}}, once you have defined the function you can call it is you would
call any of the existing functions. You can then use the {{code|argCount()}} function to determine how many arguments were passed
when it was called. 
 
Once the number of arguments have been determined you can use [[arg|{{code|arg()}}]] to retrieve them.
 


|usage=
|usage=
<source lang="mtmacro" line>
<syntaxhighlight lang="mtmacro" line>
argCount()
argCount()
</source>
</syntaxhighlight>
 
 
|example=
An example of a simple macro that would be defined as a user defined function. This function will add together
all of the arguments that are passed to it.
<syntaxhighlight lang="mtmacro" line>
[h: numArgs = argCount()]
[h: total = 0]
[h,count(numArgs): total = total + arg(roll.count)]
[r: total]
</syntaxhighlight>
 


|also=
|also=
[[defineFunction|defineFunction()]], [[isFunctionDefined|isFunctionDefined()]], [[arg|arg()]]
[[defineFunction|defineFunction()]], [[isFunctionDefined|isFunctionDefined()]], [[arg|arg()]]
}}
}}
[[Category:Miscellaneous Function]]
[[Category:User Defined Function]]

Latest revision as of 23:59, 14 March 2023

argCount() Function

Introduced in version 1.3b51
Is used to determine the number of arguments that have been passed to a user defined function.

User functions are defined with the defineFunction(), once you have defined the function you can call it is you would call any of the existing functions. You can then use the argCount() function to determine how many arguments were passed when it was called.

Once the number of arguments have been determined you can use arg() to retrieve them.

Usage

argCount()

Example

An example of a simple macro that would be defined as a user defined function. This function will add together

all of the arguments that are passed to it.

[h: numArgs = argCount()]
[h: total = 0]
[h,count(numArgs): total = total + arg(roll.count)]
[r: total]

See Also