Difference between revisions of "Template:Function"

From the Fallout3 GECK Wiki
Jump to navigation Jump to search
imported>SnakeChomp
(Whitespace fix when name is omitted. Documentation beautification.)
imported>SnakeChomp
m (Note on new arguments parameter. CategoryList is technically optional)
Line 18: Line 18:
                       on with the dot syntax
                       on with the dot syntax
   ''arguments''        = List of arguments specified using the [[Template:FunctionArgument]] template,
   ''arguments''        = List of arguments specified using the [[Template:FunctionArgument]] template,
                       or any other wiki syntax.
                       or any other wiki syntax. Use this or the arg0-arg9 parameters.
   ''arg0''              = the first '''mandatory''' argument
   ''arg0''              = the first '''mandatory''' argument
                       (''arg*'' parameters are optional, not all functions have mandatory arguments)
                       (''arg*'' parameters are optional, not all functions have mandatory arguments)
Line 28: Line 28:
   ...                (the template also accepts 10 optional arguments, optArg0 through optArg9)
   ...                (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
   ''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
   ''CategoryList''     = the list of categories to which the page belongs
  <nowiki>}}</nowiki>
  <nowiki>}}</nowiki>



Revision as of 18:46, 30 January 2009


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. The page name is the default value.
 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. Use void if there is no return 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 any other wiki syntax. Use this or the arg0-arg9 parameters.
 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