# Itemcount

> [HTML Version](itemcount.htm)

This parameter specifies a number of items—i.e. "rows"—with the precise meaning being relative to the opcode, as shown in the following table. _itemcount_ may be specified by any numeric data type.

| | |
|------|------|
| **XTR.OPCODE** | **itemcount interpretation** |
| XTROP\_CREATE | For array mode, set to # of items to load from the data _array_ parameter. For file mode, set to 0 to load the entire file. |
| XTROP\_REPLACE | Same as for XTROP\_CREATE. If less than the number of items already in the tree, the excess items will be deleted from the tree. |
| XTROP\_APPEND | \# of items to append (from the data _array_ parameter to the end of the existing items in the tree) |
| XTROP\_DELETE | Ignored |
| XTROP\_RESELECT | \# of items currently in the tree (see _Comments_) |
| XTROP\_DELSEL | Same as for XTROP\_RESELECT |
| XTROP\_PRINT | If tree doesn't already exist, set to # of items to load from the data _array_. Else set as for XTROP\_RESELECT. |
|  | **Definition file:** [ashell.def](ashell_def.htm.md) |




**Comments**

•	In PCKLST, _itemcount_ specified the maximum number of items in the input array, and was ignored for file mode. XTREE obeys it for both array and file mode, but interprets 0 as meaning to load the entire file.

•	Note that when loading an array starting from some position other than the first element, _itemcount_ must be adjusted so that it does not cause the input operation to run past the end of the array.

•	For operations that don't involve adding data but may involve processing an _answer_ array (such as XTROP\_RESELECT and XTROP\_DELSEL), _itemcount_ is mainly needed in order to identify the number of elements in the answer array when the _answer_ parameter is specified as an array element (rather than as an unformatted variable overlaying the entire array).

	Note: this parameter (_itemcount_) was previously known as _addcnt_. The documentation was changed in January 2011 to make its m\&eaning clearer.