Notation conventions for methods: Difference between revisions

From m204wiki
Jump to navigation Jump to search
mNo edit summary
Line 8: Line 8:


* Some method arguments may be passed by name; they are specified with a following equal sign (=) in method syntax diagrams. For arguments described as "name allowed" (or "name required"), you may specify (or must specify) the argument name along with the argument value when you invoke the method. You specify such argument name and value pairs in the form:
* Some method arguments may be passed by name; they are specified with a following equal sign (=) in method syntax diagrams. For arguments described as "name allowed" (or "name required"), you may specify (or must specify) the argument name along with the argument value when you invoke the method. You specify such argument name and value pairs in the form:
*: <pre>methodname( argName=argValue )</pre>
*: <p class="syntax"><span class="literal">methodname</span><span class="literal">(</span> <span class="term">argName=</span><span class="term">argValue</span> <span class="literal">)</span></p>
: Whether an argument name is a "named parameter" is declared for the method within the class definition with the NameAllowed or NameRequired keyword.
: Whether an argument name is a "named parameter" is declared for the method within the class definition with the NameAllowed or NameRequired keyword.


* Many functions that return a result may also be invoked by the keyword <tt>Call</tt>. The descriptions of such functions say that they are "callable" and display a bracketed %variable and equality sign in syntax (for example, <tt>[%name = ]</tt>). For Subroutines, which are always callable, the Call keyword is optional.
* Many functions that return a result may also be invoked by the keyword <var>Call</var>. The descriptions of such functions say that they are "callable" and display a bracketed %variable and equality sign in syntax (for example, <code>[%name = ]</code>). The Call keyword is almost always optional so a callable method can usually be invoked via simply specifying the method object followed by colon (<code>:</code>) and the method name.


* Methods are non-shared unless otherwise identified. A shared method is recognizable by the %(classname): notation preceding the method name in the method syntax, which implies that the method need not operate on a particular object. Using the class name in this way denotes that the method is shared, and it models one way you can invoke the method. You can also invoke shared methods using the %objectVariable: notation used by non-shared, or instance, methods. In this case, %objectVariable is used to identify the class to which the method belongs, not that the method operates on %objectVariable (note that %objectVariable may be null for a shared method invocation).
* Methods are non-shared unless otherwise identified. A shared method is recognizable by the %(classname): notation preceding the method name in the method syntax, which implies that the method need not operate on a particular object. Using the class name in this way denotes that the method is shared, and it models one way you can invoke the method. You can also invoke shared methods using the %objectVariable: notation used by non-shared, or instance, methods. In this case, %objectVariable is used to identify the class to which the method belongs, not that the method operates on %objectVariable (note that %objectVariable may be null for a shared method invocation).

Revision as of 23:53, 7 February 2011

Notation conventions for methods

These conventions apply primarily to the syntax for method invocation and the argument descriptions in the reference sections for individual class methods.

  • Method names are in mixed case with initial and internal capital letters. User Language keywords and variable name references are also in mixed case. This mixed-case convention is adhered to in text and syntax; it is not strictly adhered to in code examples. For more information about mixed-case User Language, see Mixed-case User Language.
  • In syntax, method arguments are required unless otherwise stated. Omitting a mandatory argument results in a compilation error. Optional arguments are enclosed in brackets ([ ]) in syntax and are described with the word "optional."
  • Some method arguments may be passed by name; they are specified with a following equal sign (=) in method syntax diagrams. For arguments described as "name allowed" (or "name required"), you may specify (or must specify) the argument name along with the argument value when you invoke the method. You specify such argument name and value pairs in the form:

    methodname( argName=argValue )

Whether an argument name is a "named parameter" is declared for the method within the class definition with the NameAllowed or NameRequired keyword.
  • Many functions that return a result may also be invoked by the keyword Call. The descriptions of such functions say that they are "callable" and display a bracketed %variable and equality sign in syntax (for example, [%name = ]). The Call keyword is almost always optional so a callable method can usually be invoked via simply specifying the method object followed by colon (:) and the method name.
  • Methods are non-shared unless otherwise identified. A shared method is recognizable by the %(classname): notation preceding the method name in the method syntax, which implies that the method need not operate on a particular object. Using the class name in this way denotes that the method is shared, and it models one way you can invoke the method. You can also invoke shared methods using the %objectVariable: notation used by non-shared, or instance, methods. In this case, %objectVariable is used to identify the class to which the method belongs, not that the method operates on %objectVariable (note that %objectVariable may be null for a shared method invocation).