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

N_GETLINE()


Returns

The source code line number in the procedure that was executing when a 
procedure containing N_GETLINE() was called.

If you compile using the /L option, which suppresses line number 
information, N_GETLINE() will always return zero.

The return value is undefined outside a procedure.



Description

This function is identical to PROCLINE(<nActivation>) in Clipper 
5.x.

The PROCLINE() of Clipper Summer '87, however, does not offer the 
option of reaching backward through the stack. When you call PROCLINE() 
from within a procedure, it will return the line number that was 
executing when PROCLINE() was called. While this information may be 
useful in some situations, it is not particularly helpful if you need 
to know at what point an event interrupted normal program execution. In 
this case call N_GETLINE() from within your event-handling procedure; 
it will return the source code line number that was executing when the 
procedure was called.


Example

* Source file (Summer '87)                     Line 1
MyProc                && Call a procedure      Line 2
RETURN                &&                       Line 3
                      &&                       Line 4
PROCEDURE MyProc      &&                       Line 5
   ? PROCLINE()       && Returns: 6            Line 6
   ? N_GETLINE()      && Returns: 2            Line 7
RETURN