[<<Previous Entry] [^^Up^^] [Next Entry>>] [Menu] [About The Guide]
 LASTKLINE()
 Returns the line number of the most-recent key trap
------------------------------------------------------------------------------
 Syntax

     LASTKLINE() --> nLineNumber

 Returns

     LASTKLINE() returns a source code line number.

 Description

     This function notes the program lines where KEYTIME(), KEYSEC(),
     COM_KEY(), or COM_SKEY() placed a key code in the keyboard buffer.  With
     CA-Clipper, key traps only become active when a wait state is triggered.
     This function differs from the CA-Clipper PROCLINE() function because it
     returns the line number where the respective result occurs, rather than
     the line of the input command that triggered the trap.

 Notes

     .  LASTKLINE() returns a value, only if the program compiles
        without the compiler switch value of -l (suppress line number
        information).

     .  The function returns a value of 0 when the executed line is in
        CA-Clipper Tools, the external function, or -1 option.

 Example

     Return the line number of the last key trap:

     ? "Trap by", LASTKFUNC(), "in line", LASTKLINE()


See Also: LASTKFUNC() LASTKPROC() KEYTIME() KEYSEC() COM_KEY()
This page created by ng2html v1.05, the Norton guide to HTML conversion utility. Written by Dave Pearson