AppendProcedureList (Stringlist function) - Revision history

JAL: add usage note and See also link

2016-01-25T23:37:28Z

add usage note and See also link

← Older revision		Revision as of 23:37, 25 January 2016
Line 5:		Line 5:
	==Syntax==		==Syntax==
	{{Template:Stringlist:AppendProcedureList syntax}}		{{Template:Stringlist:AppendProcedureList syntax}}

	===Syntax terms===		===Syntax terms===
	<table class="syntaxTable">		<table class="syntaxTable">
Line 12:		Line 13:
	<tr><th><var>-1</var></th>		<tr><th><var>-1</var></th>
	<td>File/group not found</td></tr>		<td>File/group not found</td></tr>

	<tr><th><var>-2</var></th>		<tr><th><var>-2</var></th>
	<td>No procedures match search criteria</td></tr>		<td>No procedures match search criteria</td></tr>
Line 17:		Line 19:
	All other errors result in request cancellation.		All other errors result in request cancellation.
	<tr><th>sl</th>		<tr><th>sl</th>

	<td>A <var>Stringlist</var> object.</td></tr>		<td>A <var>Stringlist</var> object.</td></tr>
	<tr><th>file</th>		<tr><th>file</th>
	<td>The name of the file or group for which information is to be returned. This is an optional argument, and it defaults to the default file/group at <b><i>compile</i></b> time.</td></tr>		<td>The name of the file or group for which information is to be returned. This is an optional argument, and it defaults to the default file/group at <b><i>compile</i></b> time.</td></tr>

	<tr><th>pname</th>		<tr><th>pname</th>
	<td>The procedure name that is to be selected. The procedure name may contain asterisk (*) characters to indicate wildcard matches. This is an optional parameter, and it defaults to all procedures.</td></tr>		<td>The procedure name that is to be selected. The procedure name may contain asterisk (*) characters to indicate wildcard matches. This is an optional parameter, and it defaults to all procedures.</td></tr>

	<tr><th>accnt</th>		<tr><th>accnt</th>
	<td>The account ID of the last modifying user for the procedures to be selected. The account ID may contain asterisk (*) characters to indicate wildcard matches. This is an optional parameter, and it defaults to all account IDs.</td></tr>		<td>The account ID of the last modifying user for the procedures to be selected. The account ID may contain asterisk (*) characters to indicate wildcard matches. This is an optional parameter, and it defaults to all account IDs.</td></tr>

	<tr><th>date</th>		<tr><th>date</th>
	<td>A string indicating the last modification date for the procedures to be selected. If specified, this parameter must be six bytes long and begin with an equals sign (<code>=</code>), a less-than sign (<code><</code>), or a greater-than sign (<code>></code>) to indicate whether the date should be equal to, less than, or greater than, respectively, the Julian date that follows, which is the last five characters. For example: the value <code>>03200</code> selects procedures last modified after day 200 of 2003.		<td>A string indicating the last modification date for the procedures to be selected. If specified, this parameter must be six bytes long and begin with an equals sign (<code>=</code>), a less-than sign (<code><</code>), or a greater-than sign (<code>></code>) to indicate whether the date should be equal to, less than, or greater than, respectively, the Julian date that follows, which is the last five characters. For example: the value <code>>03200</code> selects procedures last modified after day 200 of 2003.
Line 31:		Line 37:

	==Usage notes==		==Usage notes==
	<ul><li><var class="term">sl</var>, the output <var>Stringlist</var> produced by <var>AppendProcedureList</var>, has the following format:<dl>		<ul>
	<dt>Col 1-10<dd>Account ID of last updater.<dt>Col 12-19<dd>Size of procedure in bytes.<dt>Col 21-30<dd>Date of last update (YYYY/MM/DD).<dt>Col 32-39<dd>Time of last update (BH:MI:SS).<dt>Col 41-48<dd>File containing the procedure.<dt>Col 49-<dd>Procedure name.</dl></ul>		<li><var class="term">sl</var>, the output <var>Stringlist</var> produced by <var>AppendProcedureList</var>, has the following format:<dl>
			<dt>Col 1-10<dd>Account ID of last updater.<dt>Col 12-19<dd>Size of procedure in bytes.<dt>Col 21-30<dd>Date of last update (YYYY/MM/DD).<dt>Col 32-39<dd>Time of last update (BH:MI:SS).<dt>Col 41-48<dd>File containing the procedure.<dt>Col 49-<dd>Procedure name.</dl>

			<li>Each file in the file or group context specified by <var class="term">sl</var> is processed in turn, in the order of the files in that context.
			<p>
			Within each file, the procedures are added in the order in which they occur in the procedure dictionary, which, since the procedure dictionary is a hashed structure, can essentially be a random order. </p>
			</li>
			</ul>

	==Examples==		==Examples==
Line 41:		Line 54:
	%list = new		%list = new
	%list:appendProcedureList('HOMER', 'S', 'A')		%list:appendProcedureList('HOMER', 'S', 'A')

	%list:print		%list:print
	end		end
Line 49:		Line 61:
	<ul>		<ul>
	<li>The <var>[[AppendOpenProcedure (Stringlist function)\|AppendOpenProcedure]]</var> function appends procedure lines to a <var>Stringlist</var>.		<li>The <var>[[AppendOpenProcedure (Stringlist function)\|AppendOpenProcedure]]</var> function appends procedure lines to a <var>Stringlist</var>.
	</ul>
			<li>The <var>[[ProcedureInfo class\|ProcedureInfo]]</var> class can provide comparable functionality to <var>AppendProcedureList</var>. </ul>

	{{Template:Stringlist:AppendProcedureList footer}}		{{Template:Stringlist:AppendProcedureList footer}}

Dme: /* See also */

2014-04-19T16:21:48Z

JAL at 17:43, 23 October 2012

2012-10-23T17:43:48Z

← Older revision		Revision as of 17:43, 23 October 2012
Line 2:		Line 2:

	This [[Notation conventions for methods#Callable functions\|callable]] function returns information about procedures in a procedure file or group into a <var>Stringlist</var>.		This [[Notation conventions for methods#Callable functions\|callable]] function returns information about procedures in a procedure file or group into a <var>Stringlist</var>.

	~~The <var>AppendProcedureList</var> function accepts three arguments and returns a numeric result.~~

	==Syntax==		==Syntax==

JAL2: /* Examples */

2012-05-15T20:43:04Z

Examples

← Older revision		Revision as of 20:43, 15 May 2012
Line 37:		Line 37:

	==Examples==		==Examples==
	~~<ol><li>~~The following program displays information for all procedures in group <code>HOMER</code> beginning with the letter <code>S</code>, last updated by a user whose account ID begins with the letter <code>A</code>.		The following program displays information for all procedures in group <code>HOMER</code> beginning with the letter <code>S</code>, last updated by a user whose account ID begins with the letter <code>A</code>.

	<p class="code">begin		<p class="code">begin
Line 46:		Line 46:
	%list:print		%list:print
	end		end
	</p~~></ol~~>		</p>

	==See also==		==See also==
	{{Template:Stringlist:AppendProcedureList footer}}		{{Template:Stringlist:AppendProcedureList footer}}

JALWiccan: 1 revision

2011-07-14T19:40:24Z

1 revision

← Older revision	Revision as of 19:40, 14 July 2011
(No difference)

JALWiccan: 1 revision

2011-07-14T19:40:22Z

1 revision

← Older revision		Revision as of 19:40, 14 July 2011
Line 1:		Line 1:
	{{Template:Stringlist:AppendProcedureList subtitle}}		{{Template:Stringlist:AppendProcedureList subtitle}}

	This [[Notation conventions for methods#Callable ~~methods~~\|callable]] function returns information about procedures in a procedure file or group into a <var>Stringlist</var>.		This [[Notation conventions for methods#Callable functions\|callable]] function returns information about procedures in a procedure file or group into a <var>Stringlist</var>.

	The <var>AppendProcedureList</var> function accepts three arguments and returns a numeric result.		The <var>AppendProcedureList</var> function accepts three arguments and returns a numeric result.

JALWiccan: 1 revision

2011-04-14T20:52:18Z

1 revision

← Older revision	Revision as of 20:52, 14 April 2011
(No difference)

JAL at 20:52, 14 April 2011

2011-04-14T20:52:17Z

← Older revision		Revision as of 20:52, 14 April 2011
Line 12:		Line 12:
	<td>A numeric variable that is set to zero if the function is a success; otherwise, it is set to one of these negative error codes:.		<td>A numeric variable that is set to zero if the function is a success; otherwise, it is set to one of these negative error codes:.
	<table>		<table>
	<tr><th>-1</th>		<tr><th><var>-1</var></th>
	<td>File/group not found</td></tr>		<td>File/group not found</td></tr>
	<tr><th>-2</th>		<tr><th><var>-2</var></th>
	<td>No procedures match search criteria</td></tr>		<td>No procedures match search criteria</td></tr>
	</table>		</table>

JAL at 00:44, 9 March 2011

2011-03-09T00:44:22Z

← Older revision		Revision as of 00:44, 9 March 2011
Line 1:		Line 1:
	{{Template:Stringlist:AppendProcedureList subtitle}}		{{Template:Stringlist:AppendProcedureList subtitle}}

	This callable function returns information about procedures in a procedure file or group into a <var>Stringlist</var>.		This [[Notation conventions for methods#Callable methods\|callable]] function returns information about procedures in a procedure file or group into a <var>Stringlist</var>.

	The <var>AppendProcedureList</var> function accepts three arguments and returns a numeric result.		The <var>AppendProcedureList</var> function accepts three arguments and returns a numeric result.

JAL at 22:33, 28 February 2011

2011-02-28T22:33:55Z

← Older revision		Revision as of 22:33, 28 February 2011
Line 27:		Line 27:
	<td>The account ID of the last modifying user for the procedures to be selected. The account ID may contain asterisk (*) characters to indicate wildcard matches. This is an optional parameter, and it defaults to all account IDs.</td></tr>		<td>The account ID of the last modifying user for the procedures to be selected. The account ID may contain asterisk (*) characters to indicate wildcard matches. This is an optional parameter, and it defaults to all account IDs.</td></tr>
	<tr><th>date</th>		<tr><th>date</th>
	<td>A string indicating the last modification date for the procedures to be selected. If specified, this parameter must be six bytes long and begin with an ~~equal~~ sign (<code>=</code>), a less-than sign (<code><</code>), or a greater-than sign (<code>></code>) to indicate whether the date should be equal to, less than, or greater than, respectively, the Julian date that follows, which is the last five characters. For example: the value <code>>03200</code> selects procedures last modified after day 200 of 2003.		<td>A string indicating the last modification date for the procedures to be selected. If specified, this parameter must be six bytes long and begin with an equals sign (<code>=</code>), a less-than sign (<code><</code>), or a greater-than sign (<code>></code>) to indicate whether the date should be equal to, less than, or greater than, respectively, the Julian date that follows, which is the last five characters. For example: the value <code>>03200</code> selects procedures last modified after day 200 of 2003.
	This is an optional parameter, and it defaults to all modification dates.		This is an optional parameter, and it defaults to all modification dates.
	This two-digit year date is interpreted with a <code>CENTSPAN</code> of <code>1975</code>, so values between <code>00000</code> and <code>74365</code> are considered to be in the year range 2000-2074.</td></tr>		This two-digit year date is interpreted with a <code>CENTSPAN</code> of <code>1975</code>, so values between <code>00000</code> and <code>74365</code> are considered to be in the year range 2000-2074.</td></tr>

← Older revision		Revision as of 16:21, 19 April 2014
Line 47:		Line 47:

	==See also==		==See also==
			<ul>
			<li>The <var>[[AppendOpenProcedure (Stringlist function)\|AppendOpenProcedure]]</var> function appends procedure lines to a <var>Stringlist</var>.
			</ul>
	{{Template:Stringlist:AppendProcedureList footer}}		{{Template:Stringlist:AppendProcedureList footer}}