Copy (Stringlist function): Difference between revisions
Jump to navigation
Jump to search
m (camelCase) |
m (typo) |
||
| Line 16: | Line 16: | ||
<ul> | <ul> | ||
<li>All errors in <var>Copy</var> result in request cancellation. | <li>All errors in <var>Copy</var> result in request cancellation. | ||
<li>If the method <var>Stringlist</var> was associated with an image, by either <var>[[BindImage (Stringlist subroutine)|BindImage]]</var> or <var>[[New (Stringlist constructor)|New]]</var>, the output <var>Stringlist</var> is associated with the same image, as if a <var>[[BindImage (Stringlist subroutine)|BindImage]]</var> method had been transparently invoked on the result of the <var>Copy</var>.<li><var>Copy</var> does a page-for-page copy of the input <var>Stringlist</var>. As such, it is very efficient (more efficient than <var>[[CopyItems (Stringlist function)|CopyItems]]</var>). However, it is unsuitable for compressing a <var>Stringlist</var> that has become sparse as the result of heavy <var>[[Insert_(Stringlist_function)|Insert]]</var>, <var>[[Replace_(Stringlist_function)|Replace]]</var>, <var>[[ChangeItemLength_(Stringlist_function)|ChangeItemLength]]</var> or <var>[[RemoveItem_(Stringlist_function)|RemoveItem]]</var> activity. <var>[[Replace_(Stringlist_function)|Replace]]</var> or <var>[[ChangeItemLength_(Stringlist_function)|ChangeItemLength]]</var> may cause a <var>Stringlist</var> to become sparse only if <var>Stringlist</var> items are replaced with larger <var>Stringlist</var> items or increased in size.<li>For list compression, use <var>[[CopyItems (Stringlist function)|CopyItems]]</var>. | <li>If the method <var>Stringlist</var> was associated with an image, by either <var>[[BindImage (Stringlist subroutine)|BindImage]]</var> or <var>[[New (Stringlist constructor)|New]]</var>, the output <var>Stringlist</var> is associated with the same image, as if a <var>[[BindImage (Stringlist subroutine)|BindImage]]</var> method had been transparently invoked on the result of the <var>Copy</var>.<li><var>Copy</var> does a page-for-page copy of the input <var>Stringlist</var>. As such, it is very efficient (much more efficient than <var>[[CopyItems (Stringlist function)|CopyItems]]</var>). However, it is unsuitable for compressing a <var>Stringlist</var> that has become sparse as the result of heavy <var>[[Insert_(Stringlist_function)|Insert]]</var>, <var>[[Replace_(Stringlist_function)|Replace]]</var>, <var>[[ChangeItemLength_(Stringlist_function)|ChangeItemLength]]</var> or <var>[[RemoveItem_(Stringlist_function)|RemoveItem]]</var> activity. <var>[[Replace_(Stringlist_function)|Replace]]</var> or <var>[[ChangeItemLength_(Stringlist_function)|ChangeItemLength]]</var> may cause a <var>Stringlist</var> to become sparse only if <var>Stringlist</var> items are replaced with larger <var>Stringlist</var> items or increased in size.<li>For list compression, use <var>[[CopyItems (Stringlist function)|CopyItems]]</var>. | ||
</ul> | </ul> | ||
==See also== | ==See also== | ||
{{Template:Stringlist:Copy footer}} | {{Template:Stringlist:Copy footer}} | ||
Revision as of 01:21, 27 January 2011
Copy Stringlist (Stringlist class)
This method copies an entire Stringlist, creating a new Stringlist. The Copy method accepts no arguments and returns a Stringlist object. If you are new to object-oriented programming or the Janus APIs you should read about Copying objects.
Syntax
%outList = sl:Copy
Syntax terms
| %outList | A Stringlist to contain the copy of the method Stringlist sl |
|---|---|
| sl | A Stringlist object. |
Usage notes
- All errors in Copy result in request cancellation.
- If the method Stringlist was associated with an image, by either BindImage or New, the output Stringlist is associated with the same image, as if a BindImage method had been transparently invoked on the result of the Copy.
- Copy does a page-for-page copy of the input Stringlist. As such, it is very efficient (much more efficient than CopyItems). However, it is unsuitable for compressing a Stringlist that has become sparse as the result of heavy Insert, Replace, ChangeItemLength or RemoveItem activity. Replace or ChangeItemLength may cause a Stringlist to become sparse only if Stringlist items are replaced with larger Stringlist items or increased in size.
- For list compression, use CopyItems.