Classes and Objects - Revision history

Dme: /* Aliases for class names */

2019-06-18T04:50:22Z

Aliases for class names

← Older revision		Revision as of 04:50, 18 June 2019
Line 150:		Line 150:
	While this might seem potentially confusing, aliases are intended primarily for migrating class names, so any confusion will be limited to this migration period. In addition, only the owner of a class can declare an alias, so aliases are not likely to proliferate in your site's code.		While this might seem potentially confusing, aliases are intended primarily for migrating class names, so any confusion will be limited to this migration period. In addition, only the owner of a class can declare an alias, so aliases are not likely to proliferate in your site's code.

	Multiple aliases in the alias list are separated by the keyword <var>And</var>.		Multiple aliases in the alias list are separated by the keyword <var>And</var>.<!--SOUL.DME.278.QA has an example of multiple aliases, probably don't need to belabor it here in the doc-->

	==Declaration blocks==		==Declaration blocks==

Dme at 04:30, 18 June 2019

2019-06-18T04:30:36Z

← Older revision		Revision as of 04:30, 18 June 2019
Line 79:		Line 79:
	<td>Indicates that the class is '''abstract''', that is, no instance of the class can be created unless it is an instance of a non-abstract extension class.</td></tr>		<td>Indicates that the class is '''abstract''', that is, no instance of the class can be created unless it is an instance of a non-abstract extension class.</td></tr>

	<tr><th><var>Alias=</var>aliasList</th>		<tr id="aliasList"><th><var>Alias=</var>aliasList</th>
	<td>A list of aliases for the class, with each alias separated by the word <var>And</var>. See [[#Aliases for class names\|Aliases for class names]].</td></tr>		<td>A list of aliases for the class, with each alias separated by the word <var>And</var>. See [[#Aliases for class names\|Aliases for class names]].</td></tr>

Line 128:		Line 128:

	===Aliases for class names===		===Aliases for class names===
	As of <var class="product">Sirius Mods</var> Version 7.8, you can define an alias ~~name~~ for an existing user class.		As of <var class="product">Sirius Mods</var> Version 7.8, you can define one or more alias names for an existing user class.
	You do so by specifying an <var>Alias</var> ~~parameter setting on~~ the ~~existing~~ class declaration. For example,		You do so by specifying an <var>[[#aliasList\|Alias]]</var> list in the class declaration. For example,
	you are changing a naming convention for some code, and you want to refer to user-defined class <code>Blue</code> by another name, say <code>Indigo</code>. Your class declaration would be:		you are changing a naming convention for some code, and you want to refer to user-defined class <code>Blue</code> by another name, say <code>Indigo</code>. Your class declaration would be:
	<p class="code">class blue alias indigo		<p class="code">class blue alias indigo
Line 149:		Line 149:
	</p>		</p>
	While this might seem potentially confusing, aliases are intended primarily for migrating class names, so any confusion will be limited to this migration period. In addition, only the owner of a class can declare an alias, so aliases are not likely to proliferate in your site's code.		While this might seem potentially confusing, aliases are intended primarily for migrating class names, so any confusion will be limited to this migration period. In addition, only the owner of a class can declare an alias, so aliases are not likely to proliferate in your site's code.

			Multiple aliases in the alias list are separated by the keyword <var>And</var>.

	==Declaration blocks==		==Declaration blocks==

Dme: /* Classes */

2018-10-22T23:06:18Z

Classes

← Older revision		Revision as of 23:06, 22 October 2018
Line 46:		Line 46:
	%chevy:paint('Teal')		%chevy:paint('Teal')
	</p>		</p>
	Subroutine <code>Paint</code> can only be defined '''after''' it has been declared inside a [[#Declaration blocks\|declaration block]] for class <code>Car</code>. If a class is broken up in such a way that some methods are in their own procedures, it is likely that the class's declaration blocks would all be contained in another procedure, called something like <code>CLASS.CAR</code> in this example. It would be necessary to <var>~~include~~</var> that procedure '''before''' the procedure that defines the <code>Paint</code> method:		Subroutine <code>Paint</code> can only be defined '''after''' it has been declared inside a [[#Declaration blocks\|declaration block]] for class <code>Car</code>. If a class is broken up in such a way that some methods are in their own procedures, it is likely that the class's declaration blocks would all be contained in another procedure, called something like <code>CLASS.CAR</code> in this example. It would be necessary to <var>Include</var> that procedure '''before''' the procedure that defines the <code>Paint</code> method:
	<p class="code">include class.car		<p class="code">include class.car
	include class.car.paint		include class.car.paint

ELowell at 15:05, 22 October 2018

2018-10-22T15:05:50Z

← Older revision		Revision as of 15:05, 22 October 2018
Line 46:		Line 46:
	%chevy:paint('Teal')		%chevy:paint('Teal')
	</p>		</p>
	Subroutine <code>Paint</code> can only be defined '''after''' it has been declared inside a [[#Declaration blocks\|declaration block]] for class <code>Car</code>. If a class is broken up in such a way that some methods are in their own procedures, it is likely that the class's declaration blocks would all be contained in another procedure, called something like <code>CLASS.CAR</code> in this example. ~~And it~~ would be necessary to <var>include</var> that procedure '''before''' the procedure that defines the <code>Paint</code> method:		Subroutine <code>Paint</code> can only be defined '''after''' it has been declared inside a [[#Declaration blocks\|declaration block]] for class <code>Car</code>. If a class is broken up in such a way that some methods are in their own procedures, it is likely that the class's declaration blocks would all be contained in another procedure, called something like <code>CLASS.CAR</code> in this example. It would be necessary to <var>include</var> that procedure '''before''' the procedure that defines the <code>Paint</code> method:
	<p class="code">include class.car		<p class="code">include class.car
	include class.car.paint		include class.car.paint

ELowell: /* Classes */

2018-10-22T14:48:37Z

Classes

← Older revision		Revision as of 14:48, 22 October 2018
Line 46:		Line 46:
	%chevy:paint('Teal')		%chevy:paint('Teal')
	</p>		</p>
	Subroutine <code>Paint</code> can only be defined '''after''' it has been declared inside a [[#Declaration blocks\|declaration block]] for class <code>Car</code>. If a class is broken up in such a way that some methods are in their own procedures, it is likely that the class's declaration blocks would all be contained in another procedure, called something like <code>CLASS.CAR</code> in this example. And ~~that procedure~~ would ~~have~~ to be <var>~~Included~~</var>~~'ed~~ '''before''' the procedure that defines the <code>Paint</code> method:		Subroutine <code>Paint</code> can only be defined '''after''' it has been declared inside a [[#Declaration blocks\|declaration block]] for class <code>Car</code>. If a class is broken up in such a way that some methods are in their own procedures, it is likely that the class's declaration blocks would all be contained in another procedure, called something like <code>CLASS.CAR</code> in this example. And it would be necessary to <var>include</var> that procedure '''before''' the procedure that defines the <code>Paint</code> method:
	<p class="code">include class.car		<p class="code">include class.car
	include class.car.paint		include class.car.paint

JAL: minor formatting

2018-06-21T17:22:17Z

minor formatting

← Older revision		Revision as of 17:22, 21 June 2018
Line 347:		Line 347:

	===Variable declarations===		===Variable declarations===
	Variable declarations in a class declaration block must begin with <var>Variable</var> followed by the variable name (without a percent sign). This is followed by any standard <var class="product">~~User Language~~</var> variable declaration, with the exception that:		Variable declarations in a class declaration block must begin with <var>Variable</var> followed by the variable name (without a percent sign). This is followed by any standard <var class="product">SOUL</var> variable declaration, with the exception that:
	<ul>		<ul>
	<li><var>Static</var> is not valid in a non-Shared block.		<li><var>Static</var> is not valid in a non-Shared block. </li>
	<li><var>Global</var> is not valid in a non-Shared block and requires the global name in a Shared block.
	<li><var>Common</var> is not allowed.		<li><var>Global</var> is not valid in a non-Shared block and requires the global name in a Shared block. </li>
	<li>The keywords to indicate "publicity" (<var>Private</var>, <var>Private Shared</var>, <var>Public</var>, and <var>Public Shared</var>) are allowed. If specified, they must match the publicity of the enclosing declaration block.
	<li><var>Auto</var> followed by <var>New</var> or an enumeration value is allowed.		<li><var>Common</var> is not allowed. </li>
	<li><var>ReadOnly</var> and <var>Protected</var> ~~are allowed in Sirius Mods 7.2 and later.~~
	~~Like~~ standard <var class="product">Model 204</var> variable declarations, the keyword <var>Is</var> immediately after the variable name on variable declarations is optional.		<li>The keywords to indicate "publicity" (<var>Private</var>, <var>Private Shared</var>, <var>Public</var>, and <var>Public Shared</var>) are allowed. If specified, they must match the publicity of the enclosing declaration block. </li>

			<li><var>Auto</var> followed by <var>New</var> or an enumeration value is allowed. </li>

			<li>For <var>ReadOnly</var> and <var>Protected</var> variable declarations, like standard <var class="product">Model 204</var> variable declarations, the keyword <var>Is</var> immediately after the variable name on variable declarations is optional. </li>
	</ul>		</ul>

			====Variable declaration examples====
			<p>
	An example follows of a class block with some variable declarations:		An example follows of a class block with some variable declarations:
			</p>
	<p class="code">class car		<p class="code">class car
	public		public
Line 366:		Line 374:
	end class		end class
	</p>		</p>
	Class variables can be referenced ~~via~~ an instance of that class, that is,
	~~via~~ an ''object variable'', like <code>%gremlin</code> below:		====Variable declaration references====
			Class variables can be referenced with an instance of that class, that is,
			with an ''object variable,'' like <code>%gremlin</code> below:
	<p class="code">%gremlin is object car		<p class="code">%gremlin is object car
	...		...
	printText The price is {%gremlin:price}		printText The price is {%gremlin:price}
	</p>		</p>
	The colon (<~~code~~>:</~~code~~>) that separates the object variable <code>%gremlin</code>		The colon (<tt>:</tt>) that separates the object variable <code>%gremlin</code> and the class member variable <code>price</code>, above, may alternatively be specified with a one or more blanks before and/or after it.
	and the class member variable <code>price</code>, above, may alternatively be
	specified with a one or more blanks before and/or after it.

	It is possible to to declare a variable		====ReadOnly and Protected variables====
	as <var>ReadOnly</var> or <var>Protected</var>.		It is possible to to declare a variable as <var>ReadOnly</var> or <var>Protected</var>.
	A <var>ReadOnly</var> variable can be examined by code outside the class, but it can only		A <var>ReadOnly</var> variable can be examined by code outside the class, but it can only
	be updated inside the class.		be updated inside the class.
Line 392:		Line 400:
	Now, suppose this class wants to allow extension classes to set a different <code>PartNumber</code>, probably in their constructors.		Now, suppose this class wants to allow extension classes to set a different <code>PartNumber</code>, probably in their constructors.
	One approach would be to make <code>PartNumber</code> an <var>Overridable</var> <var>ReadOnly</var> property.		One approach would be to make <code>PartNumber</code> an <var>Overridable</var> <var>ReadOnly</var> property.
	But this is a somewhat heavyweight approach, as it requires a bit of code (the property <var>Get</var> method) for each extension class, and this code has to be run every time PartNumber is retrieved.		But this is a somewhat heavyweight approach, as it requires a bit of code (the property <var>Get</var> method) for each extension class, and this code has to be run every time <code>PartNumber</code> is retrieved.
	Instead, <code>PartNumber</code> could be made a <var>Protected</var> variable, and an extension class's constructor could simply set it after calling the base class constructor.		Instead, <code>PartNumber</code> could be made a <var>Protected</var> variable, and an extension class's constructor could simply set it after calling the base class constructor.
	This allows the extension classes to override the base class's <code>PartNumber</code> using little extra code and using a very efficient access path for the value.		This allows the extension classes to override the base class's <code>PartNumber</code> using little extra code and using a very efficient access path for the value.

Dme: /* Method declaration syntax */

2017-01-30T18:55:01Z

Method declaration syntax

← Older revision		Revision as of 18:55, 30 January 2017
Line 417:		Line 417:

	====Method declaration syntax====		====Method declaration syntax====
	The declarations for ~~these~~ methods are very similar:		The declarations for the four types of methods are very similar:
	<p class="syntax">Function <span class="term">name</span> -		<p class="syntax">Function <span class="term">name</span> -
	[(<span class="term">parameters</span>)] [Is] <span class="term">datatype</span> -		[(<span class="term">parameters</span>)] [Is] <span class="term">datatype</span> -

JAL: /* Syntax terms */ misc formatting

2015-09-25T21:36:33Z

Syntax terms: misc formatting

← Older revision		Revision as of 21:36, 25 September 2015
Line 71:		Line 71:
	<table class="syntaxTable">		<table class="syntaxTable">
	<tr><th><var>Local</var></th>		<tr><th><var>Local</var></th>
	<td>Indicates that the class can only be referenced inside the containing [[scope]]. A class declared inside a method or complex subroutine '''must''' be <var>Local</var>. A class in the outermost (<var>Begin</var>/<var>End</var>) scope can be either ''local'', in which case it cannot be referenced in other scopes such as methods or complex subroutines, or not local, in which case it can be referenced anywhere in the request.</td></tr>		<td>Indicates that the class can only be referenced inside the containing [[scope]]. A class declared inside a method or complex subroutine ''must'' be <var>Local</var>. A class in the outermost (<var>Begin</var>/<var>End</var>) scope can be either '''local''', in which case it cannot be referenced in other scopes such as methods or complex subroutines, or not local, in which case it can be referenced anywhere in the request.</td></tr>

	<tr><th>className</th>		<tr><th>className</th>
Line 77:		Line 77:

	<tr><th><var>Abstract</var></th>		<tr><th><var>Abstract</var></th>
	<td>Indicates that the class is ''abstract'', that is, no instance of the class can be created unless it is an instance of a non-abstract extension class.</td></tr>		<td>Indicates that the class is '''abstract''', that is, no instance of the class can be created unless it is an instance of a non-abstract extension class.</td></tr>

	<tr><th><var>Alias=</var>aliasList</th>		<tr><th><var>Alias=</var>aliasList</th>
Line 83:		Line 83:

	<tr><th><var>Exception</var></th>		<tr><th><var>Exception</var></th>
	<td>Indicates that the class is an ''exception'' class, that is an instance it can be [[Exceptions#Throwing exceptions\|thrown]].</td></tr>		<td>Indicates that the class is an '''exception''' class, that is an instance it can be [[Exceptions#Throwing exceptions\|thrown]].</td></tr>

	<tr><th><var>Extends=</var>extendList</th>		<tr><th><var>Extends=</var>extendList</th>
Line 89:		Line 89:

	<tr><th><var>Private</var></th>		<tr><th><var>Private</var></th>
	<td>Indicates that the class is a ''private'' class, meaning that only the class itself and friends can reference class members. <var>Private</var> is only available in Model 204 7.6 and later. See [[#Friend declarations\|Friend declarations]].</td></tr>		<td>Indicates that the class is a '''private''' class, meaning that only the class itself and friends can reference class members. <var>Private</var> is only available in Model 204 7.6 and later. See [[#Friend declarations\|Friend declarations]].</td></tr>

	<tr><th><var>RequiredSuffix=</var>suffix</th>		<tr><th><var>RequiredSuffix=</var>suffix</th>

JAL: /* Syntax terms */ misc formatting

2015-09-25T21:27:41Z

Syntax terms: misc formatting

JAL: /* Classes */ misc cleanup

2015-09-25T20:32:33Z

Classes: misc cleanup

← Older revision		Revision as of 20:32, 25 September 2015
Line 59:		Line 59:
	<p class="syntax"><span class="squareb">[</span>Local<span class="squareb">]</span> Class <span class="term">className</span> <span class="squareb">[</span>Abstract<span class="squareb">]</span> -		<p class="syntax"><span class="squareb">[</span>Local<span class="squareb">]</span> Class <span class="term">className</span> <span class="squareb">[</span>Abstract<span class="squareb">]</span> -
	<span class="squareb">[</span>Alias=<span class="term">aliasList</span><span class="squareb">]</span> -		<span class="squareb">[</span>Alias=<span class="term">aliasList</span><span class="squareb">]</span> -
	<span class="squareb">[</span>Exception<span class="squareb">]</span> -		<span class="squareb">[</span>Exception<span class="squareb">]</span> -
	<span class="squareb">[</span>Extends=<span class="term">extendList</span><span class="squareb">]</span> -		<span class="squareb">[</span>Extends=<span class="term">extendList</span><span class="squareb">]</span> -
	<span class="squareb">[</span>Private<span class="squareb">]</span> -		<span class="squareb">[</span>Private<span class="squareb">]</span> -
	<span class="squareb">[</span>RequiredSuffix=<span class="term">suffix</span><span class="squareb">]</span>		<span class="squareb">[</span>RequiredSuffix=<span class="term">suffix</span><span class="squareb">]</span>
	<span class="squareb">[</span><span class="term">declaration blocks</span><span class="squareb">]</span>		<span class="squareb">[</span><span class="term">declaration blocks</span><span class="squareb">]</span>
Line 70:		Line 70:
	===Syntax terms===		===Syntax terms===
	<table class="syntaxTable">		<table class="syntaxTable">
	<tr><th><var>Local</var></th><td>Indicates that the class can only be referenced inside the containing [[scope]]. A class declared inside a method or complex subroutine '''must''' be <var>Local</var>. A class in the outermost (<var>Begin</var>/<var>End</var>) scope can be either ''local'', in which case it cannot be referenced in other scopes such as methods or complex subroutines, or not local, in which case it can be referenced anywhere in the request.</td></tr>		<tr><th><var>Local</var></th>
			<td>Indicates that the class can only be referenced inside the containing [[scope]]. A class declared inside a method or complex subroutine '''must''' be <var>Local</var>. A class in the outermost (<var>Begin</var>/<var>End</var>) scope can be either ''local'', in which case it cannot be referenced in other scopes such as methods or complex subroutines, or not local, in which case it can be referenced anywhere in the request.</td></tr>

	<tr><th>className</th><td>Consists of any valid alphanumeric and other non-separator characters.		<tr><th>className</th>
			<td>Consists of any valid alphanumeric and other non-separator characters.

	<tr><th><var>Abstract</var></th><td>Indicates that the class is ''abstract'', that is, no instance of the class can be created unless it is an instance of a non-abstract extension class.</td></tr>		<tr><th><var>Abstract</var></th>
			<td>Indicates that the class is ''abstract'', that is, no instance of the class can be created unless it is an instance of a non-abstract extension class.</td></tr>

	<tr><th><var>Alias=</var>aliasList</th><td>A list of aliases for the class, with each alias separated by the word <var>And</var>. See [[#Aliases for class names\|"Aliases for class names"]].</td></tr>		<tr><th><var>Alias=</var>aliasList</th>
			<td>A list of aliases for the class, with each alias separated by the word <var>And</var>. See [[#Aliases for class names\|Aliases for class names]].</td></tr>

	<tr><th><var>Exception</var></th><td>Indicates that the class is an ''exception'' class, that is an instance it can be [[Exceptions#Throwing exceptions\|thrown]].</td></tr>		<tr><th><var>Exception</var></th>
			<td>Indicates that the class is an ''exception'' class, that is an instance it can be [[Exceptions#Throwing exceptions\|thrown]].</td></tr>

	<tr><th><var>Extends=</var>extendList</th><td>A list of classes that this class extends.</td></tr>		<tr><th><var>Extends=</var>extendList</th>
			<td>A list of classes that this class extends.</td></tr>

	<tr><th><var>Private</var></th><td>Indicates that the class is ''private'' class meaning that only the class itself and friends can reference class members. Private is only available in Model 204 7.6 and later. See [[#Friend declarations\|"Friend declarations"]].</td></tr>		<tr><th><var>Private</var></th>
			<td>Indicates that the class is a ''private'' class, meaning that only the class itself and friends can reference class members. <var>Private</var> is only available in Model 204 7.6 and later. See [[#Friend declarations\|Friend declarations]].</td></tr>

	<tr><th><var>RequiredSuffix=</var>suffix</th><td>A non-quoted string of characters that must end the name of any object variable being declared for the class; provides a way of enforcing naming standards for class variable names. </td></tr>		<tr><th><var>RequiredSuffix=</var>suffix</th>
			<td>A non-quoted string of characters that must end the name of any object variable being declared for the class; provides a way of enforcing naming standards for class variable names. </td></tr>

	<tr><th>declaration blocks</th>		<tr><th>declaration blocks</th>
	<td>Declarations for all variables and methods in a class. See [[#Declaration blocks\|"Declaration blocks"]]. </td></tr>		<td>Declarations for all variables and methods in a class. See [[#Declaration blocks\|Declaration blocks]]. </td></tr>

	<tr><th>method definitions</th>		<tr><th>method definitions</th>
	<td>The definitions of the methods in the class. See [[Methods#Method definition syntax\|"Method definition syntax"]]. </td></tr>		<td>The definitions of the methods in the class. See [[Methods#Method definition syntax\|Method definition syntax]]. </td></tr>
	</table>		</table>

Line 106:		Line 115:

	===Colons in class names===		===Colons in class names===
	The colon character (<tt>:</tt>) is allowed in <var class="product">~~User Language~~</var> class names.		The colon character (<tt>:</tt>) is allowed in <var class="product">SOUL</var> class names.
	The following, for example, is a valid class declaration:		The following, for example, is a valid class declaration:
	<p class="code">class customer:order		<p class="code">class customer:order

← Older revision		Revision as of 21:27, 25 September 2015
Line 187:		Line 187:
	===Syntax terms===		===Syntax terms===
	<table class="syntaxTable">		<table class="syntaxTable">
	<tr><th><var>Public \| Private</var></th><td>Indicates whether the block describes members that can be referenced outside the class (<var>Public</var>) or members that can only be referenced inside the class (<var>Private</var>) or by ''friend'' classes.</td></tr>		<tr><th><var>Public \| Private</var></th><td>Indicates whether the block describes members that can be referenced outside the class (<var>Public</var>) or members that can only be referenced inside the class (<var>Private</var>) or by '''friend''' classes.</td></tr>

	<tr><th>Allow clauses</th><td>Indicate special operations allowed by the class. They can only be specified in a <var>Public</var> (non-shared) block, and consist of the <var>Allow</var> keyword followed by <var>Auto</var>, <var>Copy</var>, <var>DeepCopy</var>, or <var>Narrow</var>. See [[#Allow clause\|"Allow clause"]], below.		<tr><th>Allow clauses</th><td>Indicate special operations allowed by the class. They can only be specified in a <var>Public</var> (non-shared) block, and consist of the <var>Allow</var> keyword followed by <var>Auto</var>, <var>Copy</var>, <var>DeepCopy</var>, or <var>Narrow</var>. See [[#Allow clause\|Allow clause]], below.
	<p>		<p>
	There can be multiple <var>Allow</var> clauses in a declaration block. </p>		There can be multiple <var>Allow</var> clauses in a declaration block. </p>
	<var>Allow</var> clauses are optional and can be interspersed with <var>Disallow</var> clauses, <var>Friend</var> declarations, and member declarations.</td></tr>		<var>Allow</var> clauses are optional and can be interspersed with <var>Disallow</var> clauses, <var>Friend</var> declarations, and member declarations.</td></tr>

	<tr><th>Disallow clauses</th><td>Indicate operations not allowed by the class. They can only be specified in a <var>Public</var> (non-shared) block, and consist of the <var>Disallow</var> keyword followed by <var>Discard</var>, or <var>New</var>. See [[#Disallow clause\|"Disallow clause"]], below.		<tr><th>Disallow clauses</th><td>Indicate operations not allowed by the class. They can only be specified in a <var>Public</var> (non-shared) block, and consist of the <var>Disallow</var> keyword followed by <var>Discard</var>, or <var>New</var>. See [[#Disallow clause\|Disallow clause]], below.
	<p>		<p>
	There can be multiple <var>Disallow</var> clauses in a declaration block. </p>		There can be multiple <var>Disallow</var> clauses in a declaration block. </p>
	<var>Disallow</var> clauses are optional and can be interspersed with <var>Allow</var> clauses, <var>Friend</var> declarations, and member declarations.</td></tr>		<var>Disallow</var> clauses are optional and can be interspersed with <var>Allow</var> clauses, <var>Friend</var> declarations, and member declarations.</td></tr>

	<tr><th>Friend declarations</th><td>Indicate ''friends'' of a class. Friends of a class are other classes that can access private members of the class or, in the case of a ''public friend'', access public members of a private class. They can only be specified in a <var>Private Shared</var> block or the <var>Public Shared</var> block of a private class. In the latter case, a friend declared in a <var>Public Shared</var> block is called a ''public friend''. Friend declarations consist of the <var>Friend</var> keyword followed by the name of another class. Note that these friend classes do not have to have been declared nor do they ever have to be declared inside a request. Friend declarations are available in Model 204 7.6 and later.		<tr><th>Friend declarations</th><td>Indicate '''friends''' of a class. Friends of a class are other classes that can access private members of the class or, in the case of a '''public friend''', access public members of a private class. They can only be specified in a <var>Private Shared</var> block or the <var>Public Shared</var> block of a private class. In the latter case, a friend declared in a <var>Public Shared</var> block is called a '''public friend'''.
	<p>		<p>
	There can be multiple <var>Friend</var> declarations in a declaration block. ~~</p>~~		Friend declarations consist of the <var>Friend</var> keyword followed by the name of another class. There can be multiple <var>Friend</var> declarations in a declaration block. <var>Friend</var> clauses are optional and can be interspersed with <var>Allow</var> clauses, <var>Disallow</var> clauses, and member declarations.</p>
	<var>Friend</var> clauses are optional and can be interspersed with <var>Allow</var> clauses, <var>Disallow</var> clauses, and member declarations.</td></tr>		<p class="note"><b>Note:</b> Friend classes do not have to have been declared, nor do they ever have to be declared inside a request. </p>
			<p>
			Friend declarations are available in Model 204 7.6 and later.</p></td></tr>

	<tr><th nowrap>member declarations</th><td>Declare variables or methods in the class. These are described in [[#Variable declarations\|"Variable declarations"]] and [[#Method declarations and method types\|"Method declarations and method types"]], below.		<tr><th nowrap>member declarations</th><td>Declare variables or methods in the class. These are described in [[#Variable declarations\|Variable declarations]] and [[#Method declarations and method types\|Method declarations and method types]], below.
	While member declarations are optional, they tend to appear in almost all declarations blocks; and a class without member declarations in ''some'' declaration blocks would be pretty much useless.		While member declarations are optional, they tend to appear in almost all declarations blocks; and a class without member declarations in ''some'' declaration blocks would be pretty much useless.
	Member declaration clauses can be interspersed with <var>Allow</var> clauses, <var>Disallow</var> clauses, and <var>Friend</var> declarations.</td></tr>		Member declaration clauses can be interspersed with <var>Allow</var> clauses, <var>Disallow</var> clauses, and <var>Friend</var> declarations.</td></tr>