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

LASTKLINE()

Syntax:     LASTKLINE()

Returns:    A numeric value.
            Supplies a line number related to the source code.

Usage:      This function supplies the line number that Clipper was executing
            when KEYTIME(), KEYSEC() or COM_KEY() place a key
            into the keyboard buffer.  Clipper's key traps (SET KEY) only
            becomes active when Clipper is in a wait state, such as
            GET...READ.  This function differs from the Clipper function
            PROCLINE() in that the line number in which the event
            concerned occurred will be supplied, not the line of the input
            command where the trap was triggered (e.g., during a READ).

Notes:      LASTKLINE() will only return a line number if the program
            was compiled without the compiler switch -l i.e., with line
            numbers.  The function will return a 0 if the program
            executing at the time of the event was either in a Clipper
            Tools One routine, or in any other low level routine (such as
            C or Assembler).

Library:    CT1.LIB


--------------------------------- Example ------------------------------

Examples:   ? "Trap by " + LASTKFUNC() + "in line " + LASTKLINE()