Any of the subroutines loadname , pushname , or popname touch the name stack. The first hit after picking begins is always recorded. A hit is recorded by placing the depth of the name stack into the next vacant slot in the buffer, followed by the entire contents of the name stack. The bottom of the name stack is transferred to the buffer first, followed by the second from the bottom entry of the name stack, and so forth. In other words, from bottom to top is mapped to from left to right.
Parameter buffer Specifies a buffer in which to write the number of hits .
The number of times the name stack was written to the buffer. If the returned function value is negative, then the buffer was too small to contain all the readings from the name stack. The absolute value is the number of stacks actually recorded. The example C language program pick1.c calls the endpick subroutine to turn off picking mode. Related Information Turning off selecting mode with the endselect subroutine.