endselect(3G)

NAME
     endselect - turns off selecting mode

C SPECIFICATION
     long endselect(buffer)
     short buffer[];

PARAMETERS
     buffer   expects a buffer into which to write hits.

FUNCTION RETURN VALUE
     The returned function values is the number of hits made while selection
     mode was active.  Each time there is a hit, the system writes the name
     stack to buffer.

     If the value returned is negative, the buffer is not large enough to hold
     all the hits that occurred.

DESCRIPTION
     endselect turns off selection mode.  The buffer stores any hits generated
     by drawing routines between gselect and endselect.  Every hit that occurs
     causes the entire contents of the name stack to be recorded in the
     buffer, preceded by the number of names in the stack. Thus, if the name
     stack contains 5, 9, 17 when a hit occurs, the numbers 3, 5, 9, 17 are
     added to the buffer.

SEE ALSO
     gselect, loadname, initnames pushname, popname

NOTE
     This routine is available only in immediate mode.