New (Journal constructor) - Revision history

JAL: /* Syntax terms */

2012-11-06T21:04:59Z

Syntax terms

← Older revision		Revision as of 21:04, 6 November 2012
Line 6:		Line 6:
	<tr><th>%journal</th>		<tr><th>%journal</th>
	<td>A reference to an instance of a <var>Journal</var> object. </td></tr>		<td>A reference to an instance of a <var>Journal</var> object. </td></tr>

	<tr><th><var>[%(Journal):]</var></th>		<tr><th><var>[%(Journal):]</var></th>
	<td>The optional class name in parentheses denotes a <var>[[Notation conventions for methods#Constructors\|Constructor]]</var>. See [[#Usage notes\|"Usage notes"]], below, for more information about invoking a <var>Journal</var> <var>Constructor</var>.</td></tr>		<td>The optional class name in parentheses denotes a <var>[[Notation conventions for methods#Constructors\|Constructor]]</var>. See [[#Usage notes\|"Usage notes"]], below, for more information about invoking a <var>Journal</var> <var>Constructor</var>.</td></tr>

	<tr><th>string</th>		<tr><th>string</th>
	<td>A string that is the DDname of the journal dataset or the name of the stream that is to be accessed.</td></tr>		<td>A string that is the DDname of the journal dataset, or the name of the stream, that is to be accessed.</td></tr>
	</table>		</table>

JALWiccan: 1 revision

2011-11-30T20:23:39Z

1 revision

← Older revision	Revision as of 20:23, 30 November 2011
(No difference)

JAL2: /* Syntax terms */

2011-11-30T20:23:38Z

Syntax terms

← Older revision		Revision as of 20:23, 30 November 2011
Line 6:		Line 6:
	<tr><th>%journal</th>		<tr><th>%journal</th>
	<td>A reference to an instance of a <var>Journal</var> object. </td></tr>		<td>A reference to an instance of a <var>Journal</var> object. </td></tr>
	<tr><th><var>[%(Journal)]</var></th>		<tr><th><var>[%(Journal):]</var></th>
	<td>The optional class name in parentheses denotes a <var>[[Notation conventions for methods#Constructors\|Constructor]]</var>. See [[#Usage notes\|"Usage notes"]], below, for more information about invoking a <var>Journal</var> <var>Constructor</var>.</td></tr>		<td>The optional class name in parentheses denotes a <var>[[Notation conventions for methods#Constructors\|Constructor]]</var>. See [[#Usage notes\|"Usage notes"]], below, for more information about invoking a <var>Journal</var> <var>Constructor</var>.</td></tr>
	<tr><th>string</th>		<tr><th>string</th>

JAL2: /* Syntax terms */

2011-08-23T00:50:06Z

Syntax terms

← Older revision		Revision as of 00:50, 23 August 2011
Line 6:		Line 6:
	<tr><th>%journal</th>		<tr><th>%journal</th>
	<td>A reference to an instance of a <var>Journal</var> object. </td></tr>		<td>A reference to an instance of a <var>Journal</var> object. </td></tr>
	<tr><th><var>%(Journal)</var></th>		<tr><th><var>[%(Journal)]</var></th>
	<td>The optional class name in parentheses denotes a <var>[[Notation conventions for methods#Constructors\|Constructor]]</var>. See [[#Usage notes\|"Usage notes"]], below, for more information about invoking a <var>Journal</var> <var>Constructor</var>.</td></tr>		<td>The optional class name in parentheses denotes a <var>[[Notation conventions for methods#Constructors\|Constructor]]</var>. See [[#Usage notes\|"Usage notes"]], below, for more information about invoking a <var>Journal</var> <var>Constructor</var>.</td></tr>
	<tr><th>string</th>		<tr><th>string</th>
	<td>A string that is the DDname of the journal dataset or the name of the stream that is to be accessed.</td></tr>		<td>A string that is the DDname of the journal dataset or the name of the stream that is to be accessed.</td></tr>
	</table>		</table>

	==Usage notes==		==Usage notes==
	<ul>		<ul>

JAL2: /* Usage notes */

2011-07-27T20:12:25Z

Usage notes

← Older revision		Revision as of 20:12, 27 July 2011
Line 13:		Line 13:
	==Usage notes==		==Usage notes==
	<ul>		<ul>
	<li>As described in [[Object variables#Using New or other Constructors\|"Using New or other Constructors"]], <var>New</var> can be invoked with no object, with an explicit class name, or with an object variable in the class, even if that object is <var>Null</var>:<p class="code">%journal = new		<li>As described in [[Object variables#Using New or other Constructors\|"Using New or other Constructors"]], <var>New</var> can be invoked with no object, with an explicit class name, or with an object variable in the class, even if that object is <var>Null</var>:<p class="code">%journal = new('MYJRNL')

	%journal = %(Journal):new		%journal = %(Journal):new('MYJRNL')

	%journal = %journal:new		%journal = %journal:new('MYJRNL')
	</p>		</p>
	<li>In <var class="product">Sirius Mods</var> version 7.7,		<li>In <var class="product">Sirius Mods</var> version 7.7,

JAL2: /* Usage notes */

2011-07-27T19:14:04Z

Usage notes

← Older revision		Revision as of 19:14, 27 July 2011
Line 20:		Line 20:
	</p>		</p>
	<li>In <var class="product">Sirius Mods</var> version 7.7,		<li>In <var class="product">Sirius Mods</var> version 7.7,
	the New method returns a Null object if the journal is not present or is not a		the <var>New</var> method returns a <var>Null</var> object if the journal is not present or is not a
	valid journal.		valid journal.
	In <var class="product">Sirius Mods</var> version 7.8 and later, New also throws a ~~BadJournal exception~~		In <var class="product">Sirius Mods</var> version 7.8 and later, <var>New</var> also throws a <var>[[BadJournal class\|BadJournal]]</var> exception on an error,
	([[??]] ~~refid=bdjrnl.)~~ on an error,		and it will not return a <var>Null</var> <var>Journal</var> object without throwing an exception.
	and it will not return a Null Journal object without throwing an exception.

	Consequently, invocations of New in <var class="product">Sirius Mods</var> version 7.7		Consequently, invocations of <var>New</var> in <var class="product">Sirius Mods</var> version 7.7
	need to include a test with an On Error unit and a test for a Null result.		need to include a test with an <var>On Error</var> unit and a test for a <var>Null</var> result.
	<li>In <var class="product">Sirius Mods</var> version 7.7,		<li>In <var class="product">Sirius Mods</var> version 7.7,
	New does not require the input journal to be from the same ''Model 204'' release as		<var>New</var> does not require the input journal to be from the same <var class="product">Model 204</var> release as
	the Online.		the Online.
	However, if the releases are different, an [[AppendJournalData (Stringlist function)\|AppendJournalData]] call		However, if the releases are different, an <var>[[AppendJournalData (Stringlist function)\|AppendJournalData]]</var> call
	that references this journal		that references this journal
	will silently fail to add any data to its output Stringlist.		will silently fail to add any data to its output <var>Stringlist</var>.
	As of <var class="product">Sirius Mods</var> version 7.8, an attempt to instantiate a journal object variable		As of <var class="product">Sirius Mods</var> version 7.8, an attempt to instantiate a journal object variable
	that references a journal from a different version than the Online produces		that references a journal from a different version than the Online produces
	a BadJournal exception.		a <var>BadJournal</var> exception.
	</ul>		</ul>

	==See also==		==See also==
	{{Template:Journal:New footer}}		{{Template:Journal:New footer}}

JAL2 at 19:08, 27 July 2011

2011-07-27T19:08:57Z

← Older revision		Revision as of 19:08, 27 July 2011
Line 6:		Line 6:
	<tr><th>%journal</th>		<tr><th>%journal</th>
	<td>A reference to an instance of a <var>Journal</var> object. </td></tr>		<td>A reference to an instance of a <var>Journal</var> object. </td></tr>
			<tr><th><var>%(Journal)</var></th>
			<td>The optional class name in parentheses denotes a <var>[[Notation conventions for methods#Constructors\|Constructor]]</var>. See [[#Usage notes\|"Usage notes"]], below, for more information about invoking a <var>Journal</var> <var>Constructor</var>.</td></tr>
	<tr><th>string</th>		<tr><th>string</th>
	<td>A string that is the DDname of the journal dataset or the name of the stream that is to be accessed.</td></tr>		<td>A string that is the DDname of the journal dataset or the name of the stream that is to be accessed.</td></tr>
Line 11:		Line 13:
	==Usage notes==		==Usage notes==
	<ul>		<ul>
			<li>As described in [[Object variables#Using New or other Constructors\|"Using New or other Constructors"]], <var>New</var> can be invoked with no object, with an explicit class name, or with an object variable in the class, even if that object is <var>Null</var>:<p class="code">%journal = new

			%journal = %(Journal):new

			%journal = %journal:new
			</p>
	<li>In <var class="product">Sirius Mods</var> version 7.7,		<li>In <var class="product">Sirius Mods</var> version 7.7,
	the New method returns a Null object if the journal is not present or is not a		the New method returns a Null object if the journal is not present or is not a

JALWiccan: 1 revision

2011-05-24T22:30:42Z

1 revision

New page

{{Template:Journal:New subtitle}}
==Syntax==
{{Template:Journal:New syntax}}
===Syntax terms===
<table class="syntaxTable">
<tr><th>%journal</th>
<td>A reference to an instance of a <var>Journal</var> object. </td></tr>
<tr><th>string</th>
<td>A string that is the DDname of the journal dataset or the name of the stream that is to be accessed.</td></tr>
</table>
==Usage notes==
<ul>
<li>In <var class="product">Sirius Mods</var> version 7.7,
the New method returns a Null object if the journal is not present or is not a
valid journal.
In <var class="product">Sirius Mods</var> version 7.8 and later, New also throws a BadJournal exception
([[??]] refid=bdjrnl.) on an error,
and it will not return a Null Journal object without throwing an exception.

Consequently, invocations of New in <var class="product">Sirius Mods</var> version 7.7
need to include a test with an On Error unit and a test for a Null result.
<li>In <var class="product">Sirius Mods</var> version 7.7,
New does not require the input journal to be from the same ''Model 204'' release as
the Online.
However, if the releases are different, an [[AppendJournalData (Stringlist function)|AppendJournalData]] call
that references this journal
will silently fail to add any data to its output Stringlist.
As of <var class="product">Sirius Mods</var> version 7.8, an attempt to instantiate a journal object variable
that references a journal from a different version than the Online produces
a BadJournal exception.
</ul>
==See also==
{{Template:Journal:New footer}}

DmeWiccan: 1 revision

2011-02-16T14:43:32Z

1 revision

← Older revision		Revision as of 14:43, 16 February 2011
Line 4:		Line 4:
	===Syntax terms===		===Syntax terms===
	<table class="syntaxTable">		<table class="syntaxTable">
	<tr><th~~><i~~>%jrnl~~</i>~~</th>		<tr><th>%jrnl</th>
	<td>A reference to an instance of a Journal object. </td></tr>		<td>A reference to an instance of a Journal object. </td></tr>
	<tr><th~~><i~~>name~~</i>~~</th>		<tr><th>name</th>
	<td>A string that is the DDname of the journal dataset or the name of the stream that is to be accessed.</td></tr>		<td>A string that is the DDname of the journal dataset or the name of the stream that is to be accessed.</td></tr>
	</table>		</table>

DmeWiccan: 1 revision

2011-02-16T14:43:21Z

1 revision

← Older revision	Revision as of 14:43, 16 February 2011
(No difference)