item

item


isselect Index Level itemlist*
Syntax item file.reference itemlist* {(options}
Category TCL
Type Verb
Description outputs the base fid of the group to which the specified item-id "hashes", and a list of all item-id's that are currently "hashed" to the same group.

Also displayed is each items' (hexadecimal) byte count field, a count of the total number of items in the group, the total number of bytes, the total number of "full" frames, and the number of bytes used in the "last" frame of the group.

If the given item-id is not found, the group to which it would hash is displayed.

Case sensitivity is an issue in the hashing algorithm used by the Pick system. If a file has a "d-pointer" type of "ds", item-ids are case-sensitive. This means two things: 1, that the item-ids "dog" and "DOG" are treated as two separate items and 2) they would most likely hash to different groups (unless, of course, the file has a modulo of 1). If case sensitivity is "off", "dog" and "DOG" are the same thing, and there can only be one dog. See the "case", "case-on", and "case-off" verbs, and the topic of "file-defining items".

As of release 6.0.0, a new feature has been added to the display of items in a group. In the columns between the address and the byte size, three possible letters may appear. They have the following meanings:

B  Binary item. This normally occurs with FlashBASIC object code found in the dictionary level of source files.

F  File pointer. This occurs only with "d-pointers".

P  Means that this is a "pointer" (indirect) item. This occurs when a file is designated as having a "dp" in its "d-pointer", or when the item size passes approximately eighty percent of the frame size on the system. (See the "what" command for determining frame size).
Options n  Activates nopage function on output to the terminal.

p  Directs output to system printer, via the Spooler.

s  Suppresses output of item-ids'.
See Also group itemlist* case-off case file-defining item modulo istat hash-test create-file what pointer item
Example item testfile stuff
stuff
item not found
320710.0000     01BC  pc.v
1 items 444 bytes 0/444 frames in group 320710

This example illustrates the effect of not finding the item, yet showing the group to which the item would hash if it were there.
Warnings
Compatibility D3 7.0 R83 AP AP 6.0
isselect Index Level itemlist*