InsertImage (Stringlist function) - Revision history

JAL: /* Usage notes */

2014-10-09T22:09:31Z

Usage notes

← Older revision		Revision as of 22:09, 9 October 2014
Line 22:		Line 22:
	<li>All errors in <var>InsertImage</var> result in request cancellation.		<li>All errors in <var>InsertImage</var> result in request cancellation.

	<li><var>InsertImage</var> 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 again, even if subsequent <var>[[~~RemoveImage~~ (Stringlist function)\|~~RemoveImage~~]]</var> invocations make this possible. Because of this splitting, heavy use of <var>[[Insert (Stringlist function)\|Insert]]</var>, <var>InsertImage</var> and/or <var>~~RemoveImage~~</var> can result in "sparse" <var>Stringlists</var> which place an unnecessary burden on the buffer pool and CCATEMP. It 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>. 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 <var>[[CopyItems (Stringlist function)\|CopyItems]]</var>.</ul>		<li><var>InsertImage</var> 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 again, even if subsequent <var>[[RemoveItem (Stringlist function)\|RemoveItem]]</var> invocations make this possible. Because of this splitting, heavy use of <var>[[Insert (Stringlist function)\|Insert]]</var>, <var>InsertImage</var> and/or <var>RemoveItem</var> can result in "sparse" <var>Stringlists</var> which place an unnecessary burden on the buffer pool and CCATEMP. It 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>. 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 <var>[[CopyItems (Stringlist function)\|CopyItems]]</var>.</ul>

	==Examples==		==Examples==

JAL at 15:38, 31 October 2012

2012-10-31T15:38:41Z

← Older revision		Revision as of 15:38, 31 October 2012
Line 5:		Line 5:
	==Syntax==		==Syntax==
	{{Template:Stringlist:InsertImage syntax}}		{{Template:Stringlist:InsertImage syntax}}

	===Syntax terms===		===Syntax terms===
	<table class="syntaxTable">		<table class="syntaxTable">
Line 20:		Line 21:
	<ul>		<ul>
	<li>All errors in <var>InsertImage</var> result in request cancellation.		<li>All errors in <var>InsertImage</var> result in request cancellation.
	<li><var>InsertImage</var> 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 again, even if subsequent <var>[[~~RemoveItem~~ (Stringlist function)\|RemoveImage]]</var> invocations make this possible. Because of this splitting, heavy use of <var>[[Insert (Stringlist function)\|Insert]]</var>, <var>InsertImage</var> and/or <var>~~[[RemoveItem (Stringlist function)\|~~RemoveImage]]</var> can result in "sparse" <var>Stringlists</var> which place an unnecessary burden on the buffer pool and CCATEMP. It 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>. 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 <var>[[CopyItems (Stringlist function)\|CopyItems]]</var>.</ul>
			<li><var>InsertImage</var> 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 again, even if subsequent <var>[[RemoveImage (Stringlist function)\|RemoveImage]]</var> invocations make this possible. Because of this splitting, heavy use of <var>[[Insert (Stringlist function)\|Insert]]</var>, <var>InsertImage</var> and/or <var>RemoveImage</var> can result in "sparse" <var>Stringlists</var> which place an unnecessary burden on the buffer pool and CCATEMP. It 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>. 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 <var>[[CopyItems (Stringlist function)\|CopyItems]]</var>.</ul>

	==Examples==		==Examples==
Line 57:		Line 59:
	</p>		</p>

	In this example, [[BindImage ~~(Stringlist function)\|BindImage]]~~ associates the image with the <var>Stringlist</var>, eliminating the need to specify the image name on the <var>InsertImage</var> invocation.		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>InsertImage</var> invocation.
	</ol>		</ol>

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

JALWiccan: 1 revision

2011-07-14T19:40:24Z

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

	This [[Notation conventions for methods#Callable ~~methods~~\|callable]] method inserts data from an image into a <var>Stringlist</var> at a specific location.		This [[Notation conventions for methods#Callable functions\|callable]] method inserts data from an image into a <var>Stringlist</var> at a specific location.

	==Syntax==		==Syntax==

JAL at 02:05, 9 March 2011

2011-03-09T02:05:34Z

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

	This callable method inserts data from an image into a <var>Stringlist</var> at a specific location.		This [[Notation conventions for methods#Callable methods\|callable]] method inserts data from an image into a <var>Stringlist</var> at a specific location.

	==Syntax==		==Syntax==

Dme: /* Examples */

2011-02-07T22:16:17Z

Examples

← Older revision		Revision as of 22:16, 7 February 2011
Line 29:		Line 29:
	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

	find records to %recset		find records to %recset
	~~<p class="code">~~name = smith		name = smith
	~~</p>~~
	end find		end find

	for each record in %recset		for each record in %recset
	~~<p class="code">~~%cust:ssn = ssn		%cust:ssn = ssn
	%cust:name = name		%cust:name = name
	%cust:bdate = bdate		%cust:bdate = bdate
	for %i from 1 to %list:count		for %i from 1 to %list:count
	if %cust:ssn lt %list:item(%i, 1, 10) then		if %cust:ssn lt %list:item(%i, 1, 10) then
	loop end		loop end
	end if		end if
	end for		end for
	%list:insertImage(%i, 'CUST')		%list:insertImage(%i, 'CUST')
	~~</p>~~
	end for		end for
	</p>		</p>

Wiccan: 1 revision

2011-02-07T21:23:53Z

1 revision

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

Wiccan: 1 revision

2011-02-07T21:23:51Z

1 revision

← Older revision		Revision as of 21:23, 7 February 2011
Line 26:		Line 26:

	<p class="code">image cust		<p class="code">image cust
	~~<p class="code">~~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>		</p>
	end image		end image
Line 55:		Line 55:
	<p class="code">%list:bindImage('CUST')		<p class="code">%list:bindImage('CUST')
	for each record in %recset		for each record in %recset
	~~<p class="code">~~...		...
	%list:insertImage(%i)		%list:insertImage(%i)
	~~</p>~~
	end for		end for
	</p>		</p>

Wiccan: 1 revision

2011-02-06T22:35:23Z

1 revision

← Older revision	Revision as of 22:35, 6 February 2011
(No difference)

Goff: consistent example formatting

2011-02-06T22:35:21Z

consistent example formatting

← Older revision		Revision as of 22:35, 6 February 2011
Line 26:		Line 26:

	<p class="code">image cust		<p class="code">image cust
	ssn is string len 10		<p class="code">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

	find records to %recset		find records to %recset
	name = smith		<p class="code">name = smith
			</p>
	end find		end find

	for each record in %recset		for each record in %recset
	%cust:ssn = ssn		<p class="code">%cust:ssn = ssn
	%cust:name = name		%cust:name = name
	%cust:bdate = bdate		%cust:bdate = bdate
	for %i from 1 to %list:count		for %i from 1 to %list:count
	if %cust:ssn lt %list:item(%i, 1, 10) then		if %cust:ssn lt %list:item(%i, 1, 10) then
	loop end		loop end
	end if		end if
	end for		end for
	%list:insertImage(%i, 'CUST')		%list:insertImage(%i, 'CUST')
			</p>
	end for		end for
	</p>		</p>
Line 52:		Line 55:
	<p class="code">%list:bindImage('CUST')		<p class="code">%list:bindImage('CUST')
	for each record in %recset		for each record in %recset
	...		<p class="code">...
	%list:insertImage(%i)		%list:insertImage(%i)
			</p>
	end for		end for
	</p>		</p>