RemoveItem (Stringlist function) - Revision history

JALWiccan: 1 revision

2011-07-14T19:40:25Z

1 revision

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

JAL 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:RemoveItem subtitle}}		{{Template:Stringlist:RemoveItem subtitle}}

	This [[Notation conventions for methods#Callable ~~methods~~\|callable]] method removes an item from a <var>Stringlist</var>, decrementing the item numbers of all items which follow. If removal of an item makes a CCATEMP <var>Stringlist</var> page empty, that page is removed from use by the <var>Stringlist</var>. Otherwise, space taken up by a removed item is made available on the <var>Stringlist</var> page for other items in the same <var>Stringlist</var>.		This [[Notation conventions for methods#Callable functions\|callable]] method removes an item from a <var>Stringlist</var>, decrementing the item numbers of all items which follow. If removal of an item makes a CCATEMP <var>Stringlist</var> page empty, that page is removed from use by the <var>Stringlist</var>. Otherwise, space taken up by a removed item is made available on the <var>Stringlist</var> page for other items in the same <var>Stringlist</var>.

	==Syntax==		==Syntax==

JAL at 02:07, 9 March 2011

2011-03-09T02:07:25Z

← Older revision		Revision as of 02:07, 9 March 2011
Line 1:		Line 1:
	{{Template:Stringlist:RemoveItem subtitle}}		{{Template:Stringlist:RemoveItem subtitle}}

	This callable method removes an item from a <var>Stringlist</var>, decrementing the item numbers of all items which follow. If removal of an item makes a CCATEMP <var>Stringlist</var> page empty, that page is removed from use by the <var>Stringlist</var>. Otherwise, space taken up by a removed item is made available on the <var>Stringlist</var> page for other items in the same <var>Stringlist</var>.		This [[Notation conventions for methods#Callable methods\|callable]] method removes an item from a <var>Stringlist</var>, decrementing the item numbers of all items which follow. If removal of an item makes a CCATEMP <var>Stringlist</var> page empty, that page is removed from use by the <var>Stringlist</var>. Otherwise, space taken up by a removed item is made available on the <var>Stringlist</var> page for other items in the same <var>Stringlist</var>.

	==Syntax==		==Syntax==

Dme: /* Syntax terms */

2011-01-28T03:05:03Z

Syntax terms

← Older revision		Revision as of 03:05, 28 January 2011
Line 11:		Line 11:
	<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>~~itemnum~~</th>		<tr><th>itemNum</th>
	<td>A number that specifies the item number in the <var>Stringlist</var> to be removed.</td></tr>		<td>A number that specifies the item number in the <var>Stringlist</var> to be removed.</td></tr>
	</table>		</table>

Goff: syntax diagram, tags and links

2011-01-27T23:57:20Z

syntax diagram, tags and links

← Older revision		Revision as of 23:57, 27 January 2011
Line 7:		Line 7:
	===Syntax terms===		===Syntax terms===
	<table class="syntaxTable">		<table class="syntaxTable">
	<tr><th>%rc</th>		<tr><th>%count</th>
	<td>A numeric variable to contain the number of items remaining in the <var>Stringlist</var> after the item has been removed.</td></tr>		<td>An optional, numeric variable to contain the number of items remaining in the <var>Stringlist</var> after the item has been removed.</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>itemnum</th>		<tr><th>itemnum</th>
	<td>A number that specifies the item number in the <var>Stringlist</var>.</td></tr>		<td>A number that specifies the item number in the <var>Stringlist</var> to be removed.</td></tr>
	</table>		</table>

	==Usage notes==		==Usage notes==

	<ul><li>All errors in <var>RemoveItem</var> result in request cancellation.<li>Consecutive <var>Stringlist</var> leaf pages that are made relatively empty with <var>RemoveItem</var> will not be merged together. Because of this, heavy use of Insert and <var>RemoveItem</var> can result in "sparse" <var>Stringlist</var>s which place an unnecessary burden on the buffer pool and CCATEMP.<li>Heavy use of Insert and <var>RemoveItem</var> can result in an inability to add an item to the end of the <var>Stringlist</var> (via the Add method) because of a full pointer page, even though the <var>Stringlist</var> is nowhere near the theoretical capacity for a <var>Stringlist</var>. To make matters worse, Copy does a page-for-page copy of a <var>Stringlist</var>, so it does not result in any compression of the resultant <var>Stringlist</var>. <var>Stringlist</var> compression can be achieved using the [[CopyItems (Stringlist function)]].</ul>		<ul><li>All errors in <var>RemoveItem</var> result in request cancellation.<li>Consecutive <var>Stringlist</var> leaf pages that are made relatively empty with <var>RemoveItem</var> will not be merged together. Because of this, heavy use of <var>[[Insert (Stringlist function)\|Insert]]</var> and <var>RemoveItem</var> can result in "sparse" <var>Stringlist</var>s which place an unnecessary burden on the buffer pool and CCATEMP.<li>Heavy use of <var>[[Insert (Stringlist function)\|Insert]]</var> and <var>RemoveItem</var> can result in an inability to add an item to the end of the <var>Stringlist</var> (via the <var>[[Add (Stringlist function)\|Add]]</var> method) because of a full pointer page, even though the <var>Stringlist</var> is nowhere near the theoretical capacity for a <var>Stringlist</var>. To make matters worse, <var>[[Copy (Stringlist function)\|Copy]]</var> does a page-for-page copy of a <var>Stringlist</var>, so it does not result in any compression of the resultant <var>Stringlist</var>. <var>Stringlist</var> compression can be achieved using the <var>[[CopyItems (Stringlist function)\|CopyItems]]</var>.</ul>

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

Wiccan: 1 revision

2011-01-26T18:56:24Z

1 revision

← Older revision	Revision as of 18:56, 26 January 2011
(No difference)

Wiccan: 1 revision

2011-01-26T18:56:18Z

1 revision

← Older revision		Revision as of 18:56, 26 January 2011
Line 19:		Line 19:
	<ul><li>All errors in <var>RemoveItem</var> result in request cancellation.<li>Consecutive <var>Stringlist</var> leaf pages that are made relatively empty with <var>RemoveItem</var> will not be merged together. Because of this, heavy use of Insert and <var>RemoveItem</var> can result in "sparse" <var>Stringlist</var>s which place an unnecessary burden on the buffer pool and CCATEMP.<li>Heavy use of Insert and <var>RemoveItem</var> can result in an inability to add an item to the end of the <var>Stringlist</var> (via the Add method) because of a full pointer page, even though the <var>Stringlist</var> is nowhere near the theoretical capacity for a <var>Stringlist</var>. To make matters worse, Copy does a page-for-page copy of a <var>Stringlist</var>, so it does not result in any compression of the resultant <var>Stringlist</var>. <var>Stringlist</var> compression can be achieved using the [[CopyItems (Stringlist function)]].</ul>		<ul><li>All errors in <var>RemoveItem</var> result in request cancellation.<li>Consecutive <var>Stringlist</var> leaf pages that are made relatively empty with <var>RemoveItem</var> will not be merged together. Because of this, heavy use of Insert and <var>RemoveItem</var> can result in "sparse" <var>Stringlist</var>s which place an unnecessary burden on the buffer pool and CCATEMP.<li>Heavy use of Insert and <var>RemoveItem</var> can result in an inability to add an item to the end of the <var>Stringlist</var> (via the Add method) because of a full pointer page, even though the <var>Stringlist</var> is nowhere near the theoretical capacity for a <var>Stringlist</var>. To make matters worse, Copy does a page-for-page copy of a <var>Stringlist</var>, so it does not result in any compression of the resultant <var>Stringlist</var>. <var>Stringlist</var> compression can be achieved using the [[CopyItems (Stringlist function)]].</ul>

	~~[[Category~~:Stringlist ~~methods\|~~RemoveItem ~~function]]~~		==See also==
			{{Template:Stringlist:RemoveItem footer}}

Wiccan: 1 revision

2011-01-19T16:12:33Z

1 revision

← Older revision	Revision as of 16:12, 19 January 2011
(No difference)

Wiccan: 1 revision

2011-01-19T16:12:29Z

1 revision

← Older revision		Revision as of 16:12, 19 January 2011
Line 17:		Line 17:
	==Usage notes==		==Usage notes==

	<ul><li>All errors in RemoveItem result in request cancellation.<li>Consecutive <var>Stringlist</var> leaf pages that are made relatively empty with RemoveItem will not be merged together. Because of this, heavy use of Insert and RemoveItem can result in "sparse" <var>Stringlist</var>s which place an unnecessary burden on the buffer pool and CCATEMP.<li>Heavy use of Insert and RemoveItem can result in an inability to add an item to the end of the <var>Stringlist</var> (via the Add method) because of a full pointer page, even though the <var>Stringlist</var> is nowhere near the theoretical capacity for a <var>Stringlist</var>. To make matters worse, Copy does a page-for-page copy of a <var>Stringlist</var>, so it does not result in any compression of the resultant <var>Stringlist</var>. <var>Stringlist</var> compression can be achieved using the [[CopyItems (Stringlist function)]].</ul>		<ul><li>All errors in <var>RemoveItem</var> result in request cancellation.<li>Consecutive <var>Stringlist</var> leaf pages that are made relatively empty with <var>RemoveItem</var> will not be merged together. Because of this, heavy use of Insert and <var>RemoveItem</var> can result in "sparse" <var>Stringlist</var>s which place an unnecessary burden on the buffer pool and CCATEMP.<li>Heavy use of Insert and <var>RemoveItem</var> can result in an inability to add an item to the end of the <var>Stringlist</var> (via the Add method) because of a full pointer page, even though the <var>Stringlist</var> is nowhere near the theoretical capacity for a <var>Stringlist</var>. To make matters worse, Copy does a page-for-page copy of a <var>Stringlist</var>, so it does not result in any compression of the resultant <var>Stringlist</var>. <var>Stringlist</var> compression can be achieved using the [[CopyItems (Stringlist function)]].</ul>

	[[Category:Stringlist methods\|RemoveItem function]]		[[Category:Stringlist methods\|RemoveItem function]]

Wiccan: 1 revision

2011-01-18T21:33:44Z

1 revision

← Older revision	Revision as of 21:33, 18 January 2011
(No difference)