Template:Function

Revision as of 17:19, 30 January 2009 by imported>SnakeChomp (Omit return information if returnType is void)


This article is incomplete. You can help by filling in any blank descriptions.
Further information might be found in a section of the discussion page. Please remove this message when no longer necessary.

This is a WIP, feedback is appreciated. To retain readability a lot of HTML comments are used, they shouldn't impact the working of the template, but could add to the confusion a bit. Example in the Sandbox.

{{Function|
 CSWikiPage        = name of corresponding page on the TES CS Wiki
 origin            = whether the function came from the GECK itself or was added by FOSE.
                     valid values: GECK1 (GECK 1.1), FOSE0001 (FOSE v0001)
 summary           = description of the function
 name              = the name of the function, when omitted it's assumed this is the same as the pagename.
 shortname         = An abbreviated version of the function name that can be
                         used instead of the long name.
 returnVal         = what the function returns
 returnType        = the type of the returned value
 referenceType     = if appropriate, the type of reference that the function may be called on with the dot syntax
 arguments         = List of arguments specified using the Template:FunctionArgument template, or anything else really.
 arg0              = the first mandatory argument
                     (arg* parameters are optional, not all functions have mandatory arguments)
 arg1              = the second mandatory argument
 ...                 (the template supports 10 mandatory arguments, arg0 through arg9)
 optArg0           = the first optional argument
                     (this means it is optional for the scripter)
 optArg1           = second optional argument
 ...                 (the template also accepts 10 optional arguments, optArg0 through optArg9)
 example           = optionally, the function used as part of a script to serve as an example
 CategoryList      = the list of categories to which the page belongs
}}

Example

{{Function
|name = Test
|origin = GECK1
|shortname = tst
|summary = Does stuff
|returnType = void
|arguments = {{FunctionArgument
  |Name = Count
  |Type = int
}}{{FunctionArgument
  |Name = Target
  |Type = ref
  |Optional = y
}}
}}

Result

A function included in the GECK version 1.1.0.36.

Description

Does stuff

Syntax

Test(tst) Count:int Target:ref