Add (Stringlist function) - Revision history

JAL: /* Syntax terms */

2012-10-10T15:01:18Z

Syntax terms

← Older revision		Revision as of 15:01, 10 October 2012
Line 4:		Line 4:
	==Syntax==		==Syntax==
	{{Template:Stringlist:Add syntax}}		{{Template:Stringlist:Add syntax}}
	====Syntax terms====		===Syntax terms===
	<table class="syntaxTable">		<table class="syntaxTable">
	<tr><th>%number</th>		<tr><th>%number</th>

JAL: /* Syntax terms */

2012-10-10T15:00:31Z

Syntax terms

← Older revision		Revision as of 15:00, 10 October 2012
Line 4:		Line 4:
	==Syntax==		==Syntax==
	{{Template:Stringlist:Add syntax}}		{{Template:Stringlist:Add syntax}}
	===Syntax terms===		====Syntax terms====
	<table class="syntaxTable">		<table class="syntaxTable">
	<tr><th>%number</th>		<tr><th>%number</th>

JAL: /* Examples */

2012-10-10T14:59:42Z

Examples

← Older revision		Revision as of 14:59, 10 October 2012
Line 25:		Line 25:
	==Examples==		==Examples==

	===Adding a single item to a Stringlist===		====Adding a single item to a Stringlist====
	In the following example, four comma-delimited field values are added to a <var>Stringlist</var> for each record in a <var>Recordset</var>:		In the following example, four comma-delimited field values are added to a <var>Stringlist</var> for each record in a <var>Recordset</var>:
	<p class="code">%list is object stringList		<p class="code">%list is object stringList
Line 37:		Line 37:
	</p>		</p>

	===Adding multiple items to a Stringlist===		====Adding multiple items to a Stringlist====

	In the following example, a string literal, the contents of a variable, and the contents of another <var>Stringlist</var> are added to a <var>Stringlist</var>:		In the following example, a string literal, the contents of a variable, and the contents of another <var>Stringlist</var> are added to a <var>Stringlist</var>:

JAL2: /* Syntax terms */

2012-07-20T21:03:00Z

Syntax terms

← Older revision		Revision as of 21:03, 20 July 2012
Line 8:		Line 8:
	<tr><th>%number</th>		<tr><th>%number</th>
	<td>A numeric variable to contain the number of items in the indicated <var>Stringlist</var> after the strings have been added. <var class="term">%number</var> is also the item number associated with the last added string in the <var>Stringlist</var>.</td></tr>		<td>A numeric variable to contain the number of items in the indicated <var>Stringlist</var> after the strings have been added. <var class="term">%number</var> is also the item number associated with the last added string in the <var>Stringlist</var>.</td></tr>

	<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>~~string~~</th>
	<td>Under <var class="product">Sirius Mods</var> 7.9 and later, this is a comma-delimited set of strings, each of which, from left to right, is added to the method object <var>Stringlist</var>. The items in the list could themselves be<var>Stringlists</var>, in which case each item in the input <var>Stringlist</var> is added to the target<var>Stringlist</var>.		<tr><th>itemList</th>
			<td>Under <var class="product">Sirius Mods</var> 7.9 and later, this is a comma-delimited set of strings, each of which, from left to right, is added to the method object <var>Stringlist</var>. The items in the list could themselves be <var>Stringlists</var>, in which case each item in the input <var>Stringlist</var> is added to the target <var>Stringlist</var>.

	Under <var class="product">Sirius Mods</var> 7.8 and earlier, <var class="term">itemList</var> could only be a single string that is to be added to the <var>Stringlist</var>.</td></tr>		Under <var class="product">Sirius Mods</var> 7.8 and earlier, <var class="term">itemList</var> could only be a single string that is to be added to the <var>Stringlist</var>.</td></tr>

JALWiccan: 1 revision

2011-07-14T19:40:23Z

1 revision

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

Goff at 19:40, 14 July 2011

2011-07-14T19:40:22Z

← Older revision		Revision as of 19:40, 14 July 2011
Line 1:		Line 1:
	{{Template:Stringlist:Add subtitle}}		{{Template:Stringlist:Add subtitle}}
	This [[Notation conventions for methods#Callable ~~methods~~\|callable]] method adds arbitrary string data to a <var>Stringlist</var>. The <var>Add</var> method accepts one or more arguments and returns a numeric result.		This [[Notation conventions for methods#Callable functions\|callable]] method adds arbitrary string data to a <var>Stringlist</var>. The <var>Add</var> method accepts one or more arguments and returns a numeric result.

	==Syntax==		==Syntax==

Goff at 02:38, 17 May 2011

2011-05-17T02:38:44Z

← Older revision		Revision as of 02:38, 17 May 2011
Line 1:		Line 1:
	{{Template:Stringlist:Add subtitle}}		{{Template:Stringlist:Add subtitle}}

	This [[Notation conventions for methods#Callable methods\|callable]] method adds arbitrary string data to a <var>Stringlist</var>. The <var>Add</var> method accepts one or more arguments and returns a numeric result.		This [[Notation conventions for methods#Callable methods\|callable]] method adds arbitrary string data to a <var>Stringlist</var>. The <var>Add</var> method accepts one or more arguments and returns a numeric result.

Line 39:		Line 38:

	In the following example, a string literal, the contents of a variable, and the contents of another <var>Stringlist</var> are added to a <var>Stringlist</var>:		In the following example, a string literal, the contents of a variable, and the contents of another <var>Stringlist</var> are added to a <var>Stringlist</var>:
	<p class="code">b		<p class="code">begin
	%sl is object stringlist		%sl is object stringlist
	%python is string len 32		%python is string len 32
	%stooges is object stringlist		%stooges is object stringlist

	~~%stooges = list('Moe', 'Larry', 'Curly')~~
	~~%sl = list('John', 'Michael', 'Eric')~~
	~~%python = 'Graham'~~

	%sl~~:add~~('~~Terry~~', %python~~, %stooges)~~		%stooges = list('Moe', 'Larry', 'Curly')
			%sl = list('John', 'Michael', 'Eric')
			%python = 'Graham'

	%sl:~~print~~		%sl:add('Terry', %python, %stooges)

			%sl:print
	end		end
	</p>		</p>

Alex: /* Usage notes */

2011-03-14T03:16:38Z

Usage notes

← Older revision		Revision as of 03:16, 14 March 2011
Line 18:		Line 18:

	==Usage notes==		==Usage notes==
	<ul><li>All errors result in request cancellation.<li>~~Before~~ <var ~~class="product"~~>~~Sirius Mods~~</var> ~~Version 6.6, it was a request cancelling error to try to add a string longer than~~ the ~~size limit of a~~ <var>~~Stringlist~~</var> ~~item: 6124 bytes. This limitation was eliminated in~~ <var class="product">Sirius Mods</var> ~~Version 6.6~~.<li>~~The~~ <var>~~[[Push (~~Stringlist ~~function)\|Push]]~~</var> ~~and~~ <var>~~[[Enqueue (Stringlist function)\|Enqueue]]~~</var> ~~stringlist methods are the same as the~~ <var>~~Add~~</var> ~~method~~. <var>[[Push (Stringlist function)\|Push]]</var> was designed as a convenience for use with <var>[[Pop (Stringlist function)\|Pop]]</var>. <var>[[Enqueue (Stringlist function)\|Enqueue]]</var> was designed as a convenience for use with <var>[[Dequeue (Stringlist function)\|Dequeue]]</var>.		<ul><li>All errors result in request cancellation.
			<li>The <var>[[Push (Stringlist function)\|Push]]</var> and <var>[[Enqueue (Stringlist function)\|Enqueue]]</var> stringlist methods are the same as the <var>Add</var> method with the exception that (under <var class="product">Sirius Mods</var> 7.9 and later) <var>Add</var> can add more than one item to the method object <var>Stringlist</var> whereas <var>Push</var> and <var>Enqueue</var> can only add one. <var>[[Push (Stringlist function)\|Push]]</var> was designed as a convenience for use with <var>[[Pop (Stringlist function)\|Pop]]</var>. <var>[[Enqueue (Stringlist function)\|Enqueue]]</var> was designed as a convenience for use with <var>[[Dequeue (Stringlist function)\|Dequeue]]</var>.
	</ul>		</ul>

	==Examples==		==Examples==

Alex: /* Examples */

2011-03-14T03:13:51Z

Examples

@@ Line 22: / Line 22: @@
 ==Examples==
 In the following example, four comma-delimited field values are added to a <var>Stringlist</var> for each record in a <var>Recordset</var>:
 <p class="code">%list is object stringList
@@ Line 32: / Line 34: @@
 end for
 </p>
 ==See also==
 {{Template:Stringlist:Add footer}}

Alex: /* Syntax terms */

2011-03-14T03:07:26Z

Syntax terms

← Older revision		Revision as of 03:07, 14 March 2011
Line 13:		Line 13:
	<tr><th>string</th>		<tr><th>string</th>
	<td>Under <var class="product">Sirius Mods</var> 7.9 and later, this is a comma-delimited set of strings, each of which, from left to right, is added to the method object <var>Stringlist</var>. The items in the list could themselves be<var>Stringlists</var>, in which case each item in the input <var>Stringlist</var> is added to the target<var>Stringlist</var>.		<td>Under <var class="product">Sirius Mods</var> 7.9 and later, this is a comma-delimited set of strings, each of which, from left to right, is added to the method object <var>Stringlist</var>. The items in the list could themselves be<var>Stringlists</var>, in which case each item in the input <var>Stringlist</var> is added to the target<var>Stringlist</var>.


	Under <var class="product">Sirius Mods</var> 7.8 and earlier, <var class="term">itemList</var> could only be a single string that is to be added to the <var>Stringlist</var>.</td></tr>		Under <var class="product">Sirius Mods</var> 7.8 and earlier, <var class="term">itemList</var> could only be a single string that is to be added to the <var>Stringlist</var>.</td></tr>
			</table>

	~~</table>~~

	==Usage notes==		==Usage notes==
	<ul><li>All errors result in request cancellation.<li>Before <var class="product">Sirius Mods</var> Version 6.6, it was a request cancelling error to try to add a string longer than the size limit of a <var>Stringlist</var> item: 6124 bytes. This limitation was eliminated in <var class="product">Sirius Mods</var> Version 6.6.<li>The <var>[[Push (Stringlist function)\|Push]]</var> and <var>[[Enqueue (Stringlist function)\|Enqueue]]</var> stringlist methods are the same as the <var>Add</var> method. <var>[[Push (Stringlist function)\|Push]]</var> was designed as a convenience for use with <var>[[Pop (Stringlist function)\|Pop]]</var>. <var>[[Enqueue (Stringlist function)\|Enqueue]]</var> was designed as a convenience for use with <var>[[Dequeue (Stringlist function)\|Dequeue]]</var>.		<ul><li>All errors result in request cancellation.<li>Before <var class="product">Sirius Mods</var> Version 6.6, it was a request cancelling error to try to add a string longer than the size limit of a <var>Stringlist</var> item: 6124 bytes. This limitation was eliminated in <var class="product">Sirius Mods</var> Version 6.6.<li>The <var>[[Push (Stringlist function)\|Push]]</var> and <var>[[Enqueue (Stringlist function)\|Enqueue]]</var> stringlist methods are the same as the <var>Add</var> method. <var>[[Push (Stringlist function)\|Push]]</var> was designed as a convenience for use with <var>[[Pop (Stringlist function)\|Pop]]</var>. <var>[[Enqueue (Stringlist function)\|Enqueue]]</var> was designed as a convenience for use with <var>[[Dequeue (Stringlist function)\|Dequeue]]</var>.