Comments are a way of inserting text into UnrealScript code to remind yourself of what the code is doing, or to give a summary of the code file. Comments will be ignored by the compiler, so they can also be used to temporarily 'disable' a line of text.
UnrealScript supports two kind of comments a single comment and a multiple line comment.
single line comments are used like this
// The commented declaration would also make the compiler ignore the declaration therefor it can be useful to disable declarations // for various reasons such as testing and debugging. //var int TestVar;
and multiple line comments are used like this.
/** * NOTE: Never change the value of this variable to -1! the class functions always expect it to be a positive-only value!. */ var int TestVar;
Because the UnrealScript language commenting style is very similar to other programming languages commenting styles, the following link might be useful wp:Comment_(computer_programming).
Most of the core functionality is documented by Epic using the wp:Javadoc style of commenting files, you can however comment in any fashion you like, these are simply commenting guidelines which have become a standard that people use. It allows unified documentation of source across many languages, in this case c-type languages. As an example of an alternative one might use is C Sharp XML comments which is similar to javadocs but instead uses xml.
Acouple of notes is that multi line comments typically go as such:
/* anything in here is a comment
*/
with no following *'s
/** this is useful technical information
*/
is a common style used for function definition commentary.
/// single line useful information
The triple '/' is also used some in place of the double '/', in unrealscript however most of the useful single line commentary is documented using multi line comments as shown in the first example.
Declarations | Preprocessor • Classes • Interfaces • Cpptext • Constants • Enums • Structs • Variables (Metadata) • Replication block • Operators • Delegates • Functions • States • Defaultproperties (Subobjects) |
---|---|
Types | bool • byte • float • int • name • string • Object • Class • Enums • Structs (Vector ⋅ Rotator ⋅ Quat ⋅ Color) • Static arrays • Dynamic arrays • Delegates • Typecasting |
Literals | Boolean • Float • Integer • Names • Objects (None ⋅ Self) • Vectors • Rotators • Strings |
Flow | GoTo • If • Assert • Return • Stop • Switch • While • Do...Until • For • ForEach • Break • Continue |
Specifiers | Super • Global • Static • Default • Const |
UnrealScript | Syntax • .UC • .UCI • .UPKG • Comments • #directives • Native |