Difference between revisions of "Template:Function"

From the Oblivion ConstructionSet Wiki
Jump to navigation Jump to search
imported>DragoonWraith
imported>DragoonWraith
(updating link)
 
(52 intermediate revisions by the same user not shown)
Line 1: Line 1:
<noinclude>
<noinclude>
__NOTOC__
__NOTOC__
{{Beta}}
This template is used to create correctly-formatted function documentation pages. Primarily for the sake of standardizing the syntax sections.
 
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.


  <nowiki>{{Function</nowiki>
  <nowiki>{{Function</nowiki>
  origin            = whether the function came from the CS itself or was added by OBSE.
  | origin            = whether the function came from the CS itself or was added by OBSE.
                      valid values: CS1 (TES CS 1.0), CS1.1 (TES CS 1.1), CS1.2 (TES CS 1.2), OBSE
                        valid values: CS1 (TES CS 1.0), CS1.1 (TES CS 1.1), CS1.2 (TES CS 1.2), OBSE
  summary          = description of the function
  | summary          = description of the function
  ''name''              = the name of the function. The page name is the default value.
  ''alias''            = An abbreviated version of the function name that can be
  | ''name''              = the name of the function. The page name is the default value.
                      used instead of the long name.
  | ''alias''            = An abbreviated version of the function name that can be
  ''altName''          = the name of an alternate version of a function (e.g. the "C" Magic Effect functions)
                        used instead of the long name.
  ''altAlias''          = the alias of the alternate function.
  | ''returnVal ''        = what the function returns.
  ''alt2Name''          = the name of a second alternate version of a function
  | ''returnType''        = the type of the returned value.
  ''alt2Alias''        = the alias of any second alternate version of a function
  | ''referenceType''    = if appropriate, the type of reference that the function may be called
  ''returnVal ''        = what the function returns.
                        on with the dot syntax
  ''returnType''        = the type of the returned value.
  | ''referenceOpt''      = if can take a reference, whether it ''must'' take a reference.
  ''referenceType''    = if appropriate, the type of reference that the function may be called
  | ''arguments''        = List of arguments specified using the {{[[:Template:FunctionArgument|FunctionArgument]]}} template,
                      on with the dot syntax
                        or any other wiki syntax.
  ''referenceOpt''      = if can take a reference, whether it ''must'' take a reference.
  ''arguments''        = List of arguments specified using the {{[[:Template:FunctionArgument|FunctionArgument]]}} template,
  | ''altName''          = the name of an alternate version of a function (e.g. the "C" Magic Effect functions)
                      or any other wiki syntax.
  | ''altAlias''          = the alias of the alternate function.
  ''altArgs''          = List of arguments for the alternate version of the function.
  | ''altRetVal''        = the return value of the alternate function, if different. Defaults to the same as the regular function.
  ''alt2Args''          = List of arguments for the alternate version of the function.
  | ''altRetType''        = the return type of the alternate function, if different. Defaults to the same as the regular function.
  ''example''          = optionally, the function used as part of a script to serve as an example
  | ''altRefType''        = if different from the regular function, the reference used by the alternate version.
  ''CategoryList''      = the list of categories to which the page belongs
  | ''altRefOpt''        = whether the alternate's reference is optional.
  | ''altArgs''          = List of arguments for the alternate version of the function.
  | ''alt2Name''          = the name of a second alternate version of a function
  | ''alt2Alias''        = the alias of any second alternate version of a function
  | ''alt2RetVal''        = the return value of the second alternate function, if different. Defaults to the same as the regular function.
  | ''alt2RetType''        = the return type of the second alternate function, if different. Defaults to the same as the regular function.
  | ''alt2RefType''        = if different from the regular function, the reference used by the second alternate version.
  | ''alt2RefOpt''        = whether the second alternate's reference is optional.
  | ''alt2Args''          = List of arguments for the second alternate version of the function.
  | ''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
  <nowiki>}}</nowiki>
  <nowiki>}}</nowiki>


Line 102: Line 112:
| CS1.2  = A function included in the [[The Elder Scrolls Construction Set|TES CS v1.2]].
| CS1.2  = A function included in the [[The Elder Scrolls Construction Set|TES CS v1.2]].
| OBSE = A function added by the [[:Category:Oblivion Script Extender|Oblivion Script Extender]].
| OBSE = A function added by the [[:Category:Oblivion Script Extender|Oblivion Script Extender]].
| #default = {{Error|missing function origin info}}
| #default = A function added by {{{origin | {{Error|missing function origin info}} }}}
}}
}}


<!-- syntax starts here: -->
<!-- syntax starts here: -->
'''Syntax:'''
'''Syntax:'''
<!-- return value:
<!--
--> {{ #ifeq: {{{returnType|void}}} | void | {{{returnVal|void}}}&nbsp; |({{ #if: {{{returnVal|}}} | {{{returnVal}}}<nowiki>:</nowiki> |}}<!--
 
return type (short, float, base object, ref, something else?):
-->{{{returnType}}})&nbsp; }}<!--
 
optional reference type (actor, activator, door, etc.):
-->{{ #if: {{{referenceType|}}} | {{ #if: {{{referenceOpt|}}} | ''{{{referenceType}}}.'' | {{{referenceType}}}. }} |<!-- no Reference Type -->}}<!--
 
the actual function:
-->{{{name|{{PAGENAME}}}}}<!--
 
arguments
-->{{ #if: {{{arguments|}}} | {{{arguments}}} |<!-- no Arguments -->}}<!--
 
FOR ALIAS: return value:
-->{{ #if: {{{alias|}}} |<br/><!--
 
return value:
--> {{ #ifeq: {{{returnType|void}}} | void | {{{returnVal|void}}}&nbsp; |({{ #if: {{{returnVal|}}} | {{{returnVal}}}<nowiki>:</nowiki> |}}<!--
 
return type (short, float, base object, ref, something else?):
-->{{{returnType}}})&nbsp; }}<!--
 
optional reference type (actor, activator, door, etc.):
-->{{ #if: {{{referenceType|}}} | {{ #if: {{{referenceOpt|}}} | ''{{{referenceType}}}.'' | {{{referenceType}}}. }} |<!-- no Reference Type -->}}<!--
 
alias:
-->{{{alias}}}<!--
 
arguments
-->{{ #if: {{{arguments|}}} | {{{arguments}}} |<!-- no Arguments -->}}|<!-- no Alias -->}}<!--
 
FOR ALTERNATE:
-->{{ #if: {{{altName|}}} |&nbsp;<!--
 
return value:
--> {{ #ifeq: {{{returnType|void}}} | void | {{{returnVal|void}}}&nbsp; |({{ #if: {{{returnVal|}}} | {{{returnVal}}}<nowiki>:</nowiki> |}}<!--
 
return type (short, float, base object, ref, something else?):
-->{{{returnType}}})&nbsp; }}<!--
 
optional reference type (actor, activator, door, etc.):
-->{{ #if: {{{referenceType|}}} | {{ #if: {{{referenceOpt|}}} | ''{{{referenceType}}}.'' | {{{referenceType}}}. }} |<!-- no Reference Type -->}}<!--
 
the actual function:
-->{{{altName}}}<!--
 
arguments
-->{{ #if: {{{altArgs|}}} | {{{altArgs}}} |<!-- no Arguments -->}}<!--
 
FOR ALTERNATE ALIAS: return value:
-->{{ #if: {{{altAlias|}}} |<br/><!--
 
return value:
--> {{ #ifeq: {{{returnType|void}}} | void | {{{returnVal|void}}}&nbsp; |({{ #if: {{{returnVal|}}} | {{{returnVal}}}<nowiki>:</nowiki> |}}<!--
 
return type (short, float, base object, ref, something else?):
-->{{{returnType}}})&nbsp; }}<!--
 
optional reference type (actor, activator, door, etc.):
-->{{ #if: {{{referenceType|}}} | {{ #if: {{{referenceOpt|}}} | ''{{{referenceType}}}.'' | {{{referenceType}}}. }} |<!-- no Reference Type -->}}<!--
 
alias:
-->{{{altAlias}}}<!--
 
arguments
-->{{ #if: {{{altArgs|}}} | {{{altArgs}}} |<!-- no Arguments -->}}|<!-- no Alias -->}}|<!-- no Alternate -->}}<!--
 
FOR 2nd ALTERNATE:
-->{{ #if: {{{alt2Name|}}} |&nbsp;<!--
 
return value:
--> {{ #ifeq: {{{returnType|void}}} | void | {{{returnVal|void}}}&nbsp; |({{ #if: {{{returnVal|}}} | {{{returnVal}}}<nowiki>:</nowiki> |}}<!--
 
return type (short, float, base object, ref, something else?):
-->{{{returnType}}})&nbsp; }}<!--


optional reference type (actor, activator, door, etc.):
Function syntax description link -->
-->{{ #if: {{{referenceType|}}} | {{ #if: {{{referenceOpt|}}} | ''{{{referenceType}}}.'' | {{{referenceType}}}. }} |<!-- no Reference Type -->}}<!--
<div id="catlinks" style="font-size: 75%; float: left; margin: -0.7em 1%; padding: 0 0.1em;">[[Help:Function syntax|What is this?]]</div>
<!--


the actual function:
Main:
-->{{{alt2Name}}}<!--
-->{{FunctionSyntax | name = {{{name|{{PAGENAME}}}}} | returnType = {{{returnType|void}}} | returnVal = {{{returnVal|}}} | referenceType = {{{referenceType|}}} | referenceOpt = {{{referenceOpt|}}} | arguments = {{{arguments|}}} }}<!--


arguments
Alias:
-->{{ #if: {{{alt2Args|}}} | {{{alt2Args}}} |<!-- no Arguments -->}}<!--
-->{{ #if: {{{alias|}}} | &nbsp;
{{FunctionSyntax | name = {{{alias}}} | returnType = {{{returnType|void}}} | returnVal = {{{returnVal|}}} | referenceType = {{{referenceType|}}} | referenceOpt = {{{referenceOpt|}}} | arguments = {{{arguments|}}} }} | <!--no alias--> }}<!--


FOR 2nd ALTERNATE ALIAS: return value:
Alternate:
-->{{ #if: {{{alt2Alias|}}} |<br/><!--
-->{{ #if: {{{alt|{{{altName|}}}}}} | &nbsp;


return value:
{{FunctionSyntax | name = {{{alt|{{{altName|}}}}}} | returnType = {{{altRetType|{{{returnType|void}}} }}} | returnVal = {{{altRetVal|{{{returnVal|}}} }}} | referenceType = {{{altRefType|{{{referenceType|}}} }}} | referenceOpt = {{{altRefOpt|{{{referenceOpt|}}} }}} | arguments = {{{altArgs|}}} }}<!--
--> {{ #ifeq: {{{returnType|void}}} | void | {{{returnVal|void}}}&nbsp; |({{ #if: {{{returnVal|}}} | {{{returnVal}}}<nowiki>:</nowiki> |}}<!--


return type (short, float, base object, ref, something else?):
Alternate Alias:
-->{{{returnType}}})&nbsp; }}<!--
-->{{ #if: {{{altAlias|}}} | &nbsp;
{{FunctionSyntax | name = {{{altAlias}}} | returnType = {{{altRetType|{{{returnType|void}}} }}} | returnVal = {{{altRetVal|{{{returnVal|}}} }}} | referenceType = {{{altRefType|{{{referenceType|}}} }}} | referenceOpt = {{{altRefOpt|{{{referenceOpt|}}} }}} | arguments = {{{alt2Args|}}} }} | <!--no alt alias--> }} | <!--no alt--> }}<!--


optional reference type (actor, activator, door, etc.):
Second Alternate:
-->{{ #if: {{{referenceType|}}} | {{ #if: {{{referenceOpt|}}} | ''{{{referenceType}}}.'' | {{{referenceType}}}. }} |<!-- no Reference Type -->}}<!--
-->{{ #if: {{{alt2|{{{alt2Name|}}}}}} | &nbsp;


alias:
{{FunctionSyntax | name = {{{alt2|{{{alt2Name|}}}}}} | returnType = {{{alt2RetType|{{{returnType|void}}} }}} | returnVal = {{{alt2RetVal|{{{returnVal|}}} }}} | referenceType = {{{alt2RefType|{{{referenceType|}}} }}} | referenceOpt = {{{alt2RefOpt|{{{referenceOpt|}}} }}} | arguments = {{{alt2Args|}}} }}<!--
-->{{{alt2Alias}}}<!--


arguments
Second Alternate Alias:
-->{{ #if: {{{alt2Args|}}} | {{{alt2Args}}} |<!-- no Arguments -->}}|<!-- no Alias -->}}|<!-- no 2nd Alternate -->}}<!--
-->{{ #if: {{{alt2Alias|}}} | &nbsp;
{{FunctionSyntax | name = {{{alt2Alias}}} | returnType = {{{alt2RetType|{{{returnType|void}}} }}} | returnVal = {{{alt2RetVal|{{{returnVal|}}} }}} | referenceType = {{{alt2RefType|{{{referenceType|}}} }}} | referenceOpt = {{{alt2RefOpt|{{{referenceOpt|}}} }}} | arguments = {{{alt2Args|}}} }} | <!--no alt alias--> }} | <!--no alt--> }}<!--


short summary of the function: -->
short summary of the function: -->

Latest revision as of 00:21, 5 January 2012


This template is used to create correctly-formatted function documentation pages. Primarily for the sake of standardizing the syntax sections. 

{{Function
  | origin            = whether the function came from the CS itself or was added by OBSE.
                        valid values: CS1 (TES CS 1.0), CS1.1 (TES CS 1.1), CS1.2 (TES CS 1.2), OBSE
  | summary           = description of the function

  | name              = the name of the function. The page name is the default value.
  | alias             = 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
  | referenceOpt      = if can take a reference, whether it must take a reference.
  | arguments         = List of arguments specified using the {{FunctionArgument}} template,
                        or any other wiki syntax.

  | altName           = the name of an alternate version of a function (e.g. the "C" Magic Effect functions)
  | altAlias          = the alias of the alternate function.
  | altRetVal         = the return value of the alternate function, if different. Defaults to the same as the regular function.
  | altRetType        = the return type of the alternate function, if different. Defaults to the same as the regular function.
  | altRefType        = if different from the regular function, the reference used by the alternate version.
  | altRefOpt         = whether the alternate's reference is optional.
  | altArgs           = List of arguments for the alternate version of the function.

  | alt2Name          = the name of a second alternate version of a function
  | alt2Alias         = the alias of any second alternate version of a function
  | alt2RetVal         = the return value of the second alternate function, if different. Defaults to the same as the regular function.
  | alt2RetType        = the return type of the second alternate function, if different. Defaults to the same as the regular function.
  | alt2RefType        = if different from the regular function, the reference used by the second alternate version.
  | alt2RefOpt         = whether the second alternate's reference is optional.
  | alt2Args          = List of arguments for the second alternate version of the function.

  | 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
 |origin = OBSE
 |summary = Sets the constant effect barter factor of the magic effect.
 |name = SetMagicEffectBarterFactor
 |alias = SetMEBarterFactor
 |altName = SetMagicEffectBarterFactorC
 |altAlias = SetMEBarterFactorC
 |returnVal = nothing
 |returnType = void
 |arguments = 
  {{FunctionArgument
   |Name = newBarterFactor
   |Type = float
  }}{{FunctionArgument
   |Name = effect
   |Type = chars
  }}
 |altArgs = 
  {{FunctionArgument
   |Name = newBarterFactor
   |Type = float
  }}{{FunctionArgument
   |Name = effectCode
   |Type = long
  }}
 |example = SetMagicEffectBarterFactor 5 FIDG
 SetMEBarterFactorC 1.5 1397247044 ; code for SHLD
}}

Result

A function added by the Oblivion Script Extender.

Syntax: 

(nothing) SetMagicEffectBarterFactor   
(nothing) SetMEBarterFactor   

(nothing) SetMagicEffectBarterFactorC   
(nothing) SetMEBarterFactorC

Sets the constant effect barter factor of the magic effect.

Example

SetMagicEffectBarterFactor 5 FIDG
SetMEBarterFactorC 1.5 1397247044 ; code for SHLD
Retrieved from "https://cs.uesp.net/w/index.php?title=Template:Function&oldid=356"