CopyItems (Stringlist function): Difference between revisions
Jump to navigation
Jump to search
m (1 revision) |
m (camelCase) |
||
| Line 15: | Line 15: | ||
<tr><th>inlist</th> | <tr><th>inlist</th> | ||
<td>The input <var>Stringlist</var>, This is a required argument. </td></tr> | <td>The input <var>Stringlist</var>, This is a required argument. </td></tr> | ||
<tr><th> | <tr><th>startItem</th> | ||
<td>The starting item number in the input <var>Stringlist</var>, see <var class="term">inlist</var>, from which items are to be copied. This is an optional argument, and it defaults to the first item in the input <var>Stringlist</var> if not specified. </td></tr> | <td>The starting item number in the input <var>Stringlist</var>, see <var class="term">inlist</var>, from which items are to be copied. This is an optional argument, and it defaults to the first item in the input <var>Stringlist</var> if not specified. </td></tr> | ||
<tr><th> | <tr><th>numItems</th> | ||
<td>The number of items from <var class="term">inlist</var> that are to be copied. This is an optional argument, and it defaults to the number of items in the input <var>Stringlist</var> after and including the starting item number. If set to a number greater than the number of items after and including the starting item number, all items after and including the starting item number are copied. A zero value for this argument is treated the same as if it were not specified.</td></tr> | <td>The number of items from <var class="term">inlist</var> that are to be copied. This is an optional argument, and it defaults to the number of items in the input <var>Stringlist</var> after and including the starting item number. If set to a number greater than the number of items after and including the starting item number, all items after and including the starting item number are copied. A zero value for this argument is treated the same as if it were not specified.</td></tr> | ||
</table> | </table> | ||
Revision as of 23:59, 26 January 2011
Copy items between Stringlists (Stringlist class)
This method copies items from one Stringlist to another. The copied items are added to the end of the method Stringlist.
CopyItems accepts three arguments and returns a numeric result. It is a callable method.
Syntax
[%count =] sl:CopyItems( inList, [startItem], [numItems])
Syntax terms
| %rc | A numeric variable that is set to the number of items in the output Stringlist after the method is completed. |
|---|---|
| sl | A Stringlist object. |
| inlist | The input Stringlist, This is a required argument. |
| startItem | The starting item number in the input Stringlist, see inlist, from which items are to be copied. This is an optional argument, and it defaults to the first item in the input Stringlist if not specified. |
| numItems | The number of items from inlist that are to be copied. This is an optional argument, and it defaults to the number of items in the input Stringlist after and including the starting item number. If set to a number greater than the number of items after and including the starting item number, all items after and including the starting item number are copied. A zero value for this argument is treated the same as if it were not specified. |
Usage notes
- All errors in CopyItems result in request cancellation.
- CopyItems does an item-for-item copy, so it can be used to compress a Stringlist that has become sparse as the result of heavy Insert, Replace, ChangeItemLength and/or RemoveItem activity. Replace, ChangeItemLength may cause a Stringlist to become sparse only if Stringlist items are replaced with larger Stringlist items or increased in size. The following chunk of code shows how Stringlist %list can be compressed:
%newList = new %newList:copyItems(%list) %list = %newList
- If copying an entire Stringlist, and no compression is required, the Copy is more efficient than CopyItems because Copy does a page-for-page copy while CopyItems does an item-for-item copy.