ReplaceImage (Stringlist function) - Revision history

JAL: /* Examples */

2012-11-01T00:39:39Z

Examples

← Older revision		Revision as of 00:39, 1 November 2012
Line 73:		Line 73:
	</p>		</p>

	In this example, <var>[[BindImage ~~(Stringlist function)\|BindImage]]~~</var> associates the image with the <var>Stringlist</var>, eliminating the need to specify the image name on the <var>ReplaceImage</var>.		In this example, <var>BindImage</var> associates the image with the <var>Stringlist</var>, eliminating the need to specify the image name on the <var>ReplaceImage</var>.

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

JAL: /* Syntax terms */

2012-11-01T00:39:00Z

Syntax terms

← Older revision		Revision as of 00:39, 1 November 2012
Line 14:		Line 14:
	<td>The number of the item that the image is to replace.</td></tr>		<td>The number of the item that the image is to replace.</td></tr>
	<tr><th>imageName</th>		<tr><th>imageName</th>
	<td>A string that contains the name of an image. This is an optional argument if an image has been associated with the <var>Stringlist</var> via the <var>[[BindImage (Stringlist function)\|BindImage]]</var>. Otherwise, it is a required argument.</td></tr>		<td>A string that contains the name of an image. This is an optional argument if an image has been associated with the <var>Stringlist</var> via the <var>[[BindImage (Stringlist function)\|BindImage]]</var> method. Otherwise, it is a required argument.</td></tr>
	</table>		</table>

JAL: /* Examples */

2012-11-01T00:38:26Z

Examples

← Older revision		Revision as of 00:38, 1 November 2012
Line 24:		Line 24:

	==Examples==		==Examples==
	~~<ol><li>~~The following example demonstrates how <var>ReplaceImage</var> can be used to maintain the last copy of an image for a particular ID in a <var>Stringlist</var>.		The following example demonstrates how <var>ReplaceImage</var> can be used to maintain the last copy of an image for a particular ID in a <var>Stringlist</var>.

	<p class="code">image cust		<p class="code">image cust
Line 73:		Line 73:
	</p>		</p>

	In this example, <var>[[BindImage (Stringlist function)\|BindImage]]</var> associates the image with the <var>Stringlist</var>, eliminating the need to specify the image name on the <var>ReplaceImage</var>.~~</ol>~~		In this example, <var>[[BindImage (Stringlist function)\|BindImage]]</var> associates the image with the <var>Stringlist</var>, eliminating the need to specify the image name on the <var>ReplaceImage</var>.

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

JAL: /* Usage notes */

2012-11-01T00:37:47Z

Usage notes

← Older revision		Revision as of 00:37, 1 November 2012
Line 18:		Line 18:

	==Usage notes==		==Usage notes==
	<ul><li>All errors in <var>ReplaceImage</var> result in request cancellation.<li><var>ReplaceImage</var> is extremely efficient if the <var>Stringlist</var> item size is not being changed (return value for <var>ReplaceImage</var> of 0), fairly efficient when a <var>Stringlist</var> item is being replaced with a shorter string (return value of 1), and can be fairly expensive when a <var>Stringlist</var> item is being replaced with a longer string (return value of 2). Replacement with a longer string can be expensive because it can result in the splitting of a <var>Stringlist</var> leaf page. Once a leaf page is split, it will not be merged back together, even if subsequent <var>[[RemoveItem (Stringlist function)\|RemoveItem]]</var> invocations make this possible. Because of this leaf-page splitting, heavy use of <var>ReplaceImage</var> calls that increase <var>Stringlist</var> item size (and <var>[[Insert (Stringlist function)\|Insert]]</var> and <var>~~[[RemoveItem (Stringlist function)\|~~RemoveItem]]</var>) can result in "sparse" <var>Stringlist</var>s which place an unnecessary burden on the buffer pool and CCATEMP. Such heavy use can also result in an inability to add an item to the end of the <var>Stringlist</var> (via <var>[[Add (Stringlist function)\|Add]]</var>) because of a full pointer page, even though the <var>Stringlist</var> is nowhere near the theoretical capacity for a <var>Stringlist</var>. <var>Stringlist</var> compression can be achieved using the <var>[[CopyItems (Stringlist function)\|CopyItems]]</var>.</ul>		<ul>
			<li>All errors in <var>ReplaceImage</var> result in request cancellation.
			<li><var>ReplaceImage</var> is extremely efficient if the <var>Stringlist</var> item size is not being changed (return value for <var>ReplaceImage</var> of 0), fairly efficient when a <var>Stringlist</var> item is being replaced with a shorter string (return value of 1), and can be fairly expensive when a <var>Stringlist</var> item is being replaced with a longer string (return value of 2). Replacement with a longer string can be expensive because it can result in the splitting of a <var>Stringlist</var> leaf page. Once a leaf page is split, it will not be merged back together, even if subsequent <var>[[RemoveItem (Stringlist function)\|RemoveItem]]</var> invocations make this possible. Because of this leaf-page splitting, heavy use of <var>ReplaceImage</var> calls that increase <var>Stringlist</var> item size (and <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. Such heavy use can also result in an inability to add an item to the end of the <var>Stringlist</var> (via <var>[[Add (Stringlist function)\|Add]]</var>) because of a full pointer page, even though the <var>Stringlist</var> is nowhere near the theoretical capacity for a <var>Stringlist</var>. <var>Stringlist</var> compression can be achieved using the <var>[[CopyItems (Stringlist function)\|CopyItems]]</var>.
			</ul>

	==Examples==		==Examples==

JALWiccan: 1 revision

2011-07-14T19:40:25Z

1 revision

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

JAL2 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:ReplaceImage subtitle}}		{{Template:Stringlist:ReplaceImage subtitle}}

	This [[Notation conventions for methods#Callable ~~methods~~\|callable]] method replaces a <var>Stringlist</var> item with the contents of an image.		This [[Notation conventions for methods#Callable functions\|callable]] method replaces a <var>Stringlist</var> item with the contents of an image.

	==Syntax==		==Syntax==

JAL2 at 21:56, 13 April 2011

2011-04-13T21:56:13Z

← Older revision		Revision as of 21:56, 13 April 2011
Line 18:		Line 18:

	==Usage notes==		==Usage notes==
	<ul><li>All errors in <var>ReplaceImage</var> result in request cancellation.<li><var>ReplaceImage</var> is extremely efficient if the <var>Stringlist</var> item size is not being changed (return value for <var ~~class="term"~~>ReplaceImage</var> of 0), fairly efficient when a <var>Stringlist</var> item is being replaced with a shorter string (return value of 1), and can be fairly expensive when a <var>Stringlist</var> item is being replaced with a longer string (return value of 2). Replacement with a longer string can be expensive because it can result in the splitting of a <var>Stringlist</var> leaf page. Once a leaf page is split, it will not be merged back together, even if subsequent <var>[[RemoveItem (Stringlist function)\|RemoveItem]]</var> invocations make this possible. Because of this leaf-page splitting, heavy use of <var>ReplaceImage</var> calls that increase <var>Stringlist</var> item size (and <var>[[Insert (Stringlist function)\|Insert]]</var> and <var>[[RemoveItem (Stringlist function)\|RemoveItem]]</var>) can result in "sparse" <var>Stringlist</var>s which place an unnecessary burden on the buffer pool and CCATEMP. Such heavy use can also result in an inability to add an item to the end of the <var>Stringlist</var> (via <var>[[Add (Stringlist function)\|Add]]</var>) because of a full pointer page, even though the <var>Stringlist</var> is nowhere near the theoretical capacity for a <var>Stringlist</var>. <var>Stringlist</var> compression can be achieved using the <var>[[CopyItems (Stringlist function)\|CopyItems]]</var>.</ul>		<ul><li>All errors in <var>ReplaceImage</var> result in request cancellation.<li><var>ReplaceImage</var> is extremely efficient if the <var>Stringlist</var> item size is not being changed (return value for <var>ReplaceImage</var> of 0), fairly efficient when a <var>Stringlist</var> item is being replaced with a shorter string (return value of 1), and can be fairly expensive when a <var>Stringlist</var> item is being replaced with a longer string (return value of 2). Replacement with a longer string can be expensive because it can result in the splitting of a <var>Stringlist</var> leaf page. Once a leaf page is split, it will not be merged back together, even if subsequent <var>[[RemoveItem (Stringlist function)\|RemoveItem]]</var> invocations make this possible. Because of this leaf-page splitting, heavy use of <var>ReplaceImage</var> calls that increase <var>Stringlist</var> item size (and <var>[[Insert (Stringlist function)\|Insert]]</var> and <var>[[RemoveItem (Stringlist function)\|RemoveItem]]</var>) can result in "sparse" <var>Stringlist</var>s which place an unnecessary burden on the buffer pool and CCATEMP. Such heavy use can also result in an inability to add an item to the end of the <var>Stringlist</var> (via <var>[[Add (Stringlist function)\|Add]]</var>) because of a full pointer page, even though the <var>Stringlist</var> is nowhere near the theoretical capacity for a <var>Stringlist</var>. <var>Stringlist</var> compression can be achieved using the <var>[[CopyItems (Stringlist function)\|CopyItems]]</var>.</ul>

	==Examples==		==Examples==

JAL at 02:08, 9 March 2011

2011-03-09T02:08:08Z

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

	This callable method replaces a <var>Stringlist</var> item with the contents of an image.		This [[Notation conventions for methods#Callable methods\|callable]] method replaces a <var>Stringlist</var> item with the contents of an image.

	==Syntax==		==Syntax==

Dme: /* Examples */

2011-02-07T22:05:53Z

Examples

← Older revision		Revision as of 22:05, 7 February 2011
Line 24:		Line 24:

	<p class="code">image cust		<p class="code">image cust
	ssn is string len 10		ssn is string len 10
	name is string len 20		name is string len 20
	bdate is string len 8		bdate is string len 8
	~~</p>~~
	end image		end image
	~~<p class="code">~~...		...
	~~</p>~~
	%list = new		%list = new

	repeat forever		repeat forever
	~~<p class="code">~~read image cust		read image cust
	if $status then		if $status then
	loop end		loop end
	end if		end if
	%n = %list:findImageItem(%cust:ssn)		%n = %list:findImageItem(%cust:ssn)
	if %n then		if %n then
	%list:replaceImage(%n, 'CUST')		%list:replaceImage(%n, 'CUST')
	else		else
	%list:addimage('CUST')		%list:addimage('CUST')
	end if		end if
	~~</p>~~
	end repeat		end repeat
	</p>		</p>
Line 50:		Line 47:
	Here is a neater and more efficient way of coding this:		Here is a neater and more efficient way of coding this:

	<p class="code">%list:bindimage('CUST')		<p class="code">image cust
			ssn is string len 10
			name is string len 20
			bdate is string len 8
			end image
			...
			%list = new
			%list:bindimage('CUST')

	repeat forever		repeat forever
	~~...~~		read image cust
	%n = %list:findImageItem(%cust:ssn)		if $status then
	if %n then		loop end
	%list:replaceImage(%n)		end if
	else		%n = %list:findImageItem(%cust:ssn)
	%list:addimage		if %n then
	end if		%list:replaceImage(%n)
			else
			%list:addimage
			end if
	end repeat		end repeat
	</p>		</p>

Wiccan: 1 revision

2011-02-07T21:23:53Z

1 revision

← Older revision	Revision as of 21:23, 7 February 2011
(No difference)