Displaying $lists, Stringlists, and Arraylists

You can use the Client's display or watch facilities for $lists, Stringlist objects, or Arraylist objects to view or watch an individual item or the count of items. However, when a quick view of the entire $list, Stringlist, or Arraylist is important, you can access a special type of Value window display to see all the list items and their values at once.

You can also print the window's contents by accessing the File menu's print options, and a search bar on the bottom of the window provides controls for searching the window content.

To access the Value window from the Watch Window:

1. Add the variable to the Watch Window.

2. In the Watch Window, right click the variable.

If this is a list variable and its value is not Null, the List Display context menu option is enabled:

3. Select List Display.

Note: For this feature, subscripted references are allowed for $list variables. For example, to display $list item i in array %L, add %L(%i) to the Watch Window.

Note: The expandList mappable Client command has the same effect for its argument as clicking List Display for a watched item.

By default, a limit of 100 items is enforced. If there are more items than the limit, this is noted in the “Total list items” line, and only the first 100 are displayed, as shown below:

If the limit of 100 is too low, you can reset it in the Display Options area in the Preferences dialog box (accessed via the Preferences option of the File menu):

The limit may be set in the range from 100 to 10,000, in increments of 1000.

See Also

Watching $lists, Stringlists and Arraylists