Difference between revisions of "PROCLINE()"

From Recital Documentation Wiki
Jump to: navigation, search
 
 
(4 intermediate revisions by 2 users not shown)
Line 1: Line 1:
==Class==
 
Applications
 
 
 
 
==Purpose==
 
==Purpose==
 
Function to return currently executing line number  
 
Function to return currently executing line number  
Line 12: Line 8:
  
 
==See Also==
 
==See Also==
[[FUNCTION]], [[MESSAGE]], [[RESUME]], [[SUSPEND]], [[LINENO()]], [[MESSAGE()]], [[PROCEDURE()]], [[PROGRAM()]], [[SET DEBUG]], [[SET DOHISTORY]], [[SET ECHO]], [[SET HISTORY]]
+
[[FUNCTION]], [[LINENO()]], [[MESSAGE]], [[MESSAGE()]], [[PROCEDURE]], [[PROCNAME()]], [[PROGRAM()]], [[RESUME]], [[SET DEBUG]], [[SET DOHISTORY]], [[SET ECHO]], [[SET HISTORY]], [[SUSPEND]]
  
  
Line 27: Line 23:
  
 
==Products==
 
==Products==
Recital Database Server, Recital Mirage Server, Recital Terminal Developer
+
Recital, Recital Server
 
[[Category:Documentation]]
 
[[Category:Documentation]]
 
[[Category:Functions]]
 
[[Category:Functions]]

Latest revision as of 14:47, 7 December 2009

Purpose

Function to return currently executing line number


Syntax

PROCLINE([<expN>])


See Also

FUNCTION, LINENO(), MESSAGE, MESSAGE(), PROCEDURE, PROCNAME(), PROGRAM(), RESUME, SET DEBUG, SET DOHISTORY, SET ECHO, SET HISTORY, SUSPEND


Description

The PROCLINE() function returns the number of the current line being executed. This function is particularly useful in conjunction with the ON ERROR command. If the currently executing line is within a procedure or function within a multi-procedure/function program or library, the line number returned is relative to the program or library as a whole. If the optional <expN> evaluates to 1, the line number returned is relative to the individual procedure or function. In this case, the PROCEDURE or FUNCTION declaration is treated as line 0 and the first executable line as line 1.


Example

m_procline = procline()
message "The last line number is &m_procline.  Press any key."


Products

Recital, Recital Server