Click above to get retro games delivered to your door ever month!

   tp_onchar() - notify on receipt of character

   nNote := tp_onchar(nPort, cChar, [cFunction])

   nPort       Serial port number.
   cChar       Character to watch for.
   cFunction   Name of notification function.

   Returns     Notification handle.

   Requests notification when a single character cChar is received on a
   given port.  Up to four tp_onchar() notifications may be posted at
   one time on any port.  (This is in addition to the limit of sixteen
   pending notifications in all.)

   If cFunction is omitted, deletes any posted notification request for
   the specified character on that port.

   Example:

       tp_onchar(1, chr(5), "SendACK")     // On receiving ENQ....

       procedure SendACK
           tp_onchar(1, chr(5), "SendACK")
           tp_send(1, chr(6))
           return