Difference between revisions of "PROGRAM()"
Yvonnemilne (Talk | contribs) |
Helengeorge (Talk | contribs) (→Class) |
||
| Line 1: | Line 1: | ||
| − | |||
| − | |||
Revision as of 15:09, 28 October 2009
Purpose
Function to return the currently executing program name
Syntax
PROGRAM([<expN>])
See Also
DEBUG, DO, FUNCTION, MESSAGE, PROCEDURE, RESUME, SUSPEND, DOLEVEL(), LINENO(), MESSAGE(), PATH(), PROCLIBS(), PROCLINE(), PROCNAME(), SYS(), SET DEBUG, SET DOHISTORY, SET ECHO, SET HISTORY
Description
The PROGRAM() function returns the name of the currently executing program or procedure. This function is particularly useful when used with the SET KEY TO command or ON ERROR routines. The PROGRAM() function always returns a character string in upper case. If a program is currently being executed, the full path and the file extension, ".PRG" for program or ".DBO" for compiled program, will be returned with the name of the program. If a procedure or user defined function (UDF) is being executed, only the name will be returned.
<expN> Specifying the optional <expN> causes PROGRAM() to return the name of the procedure or program at the <expN> level. If there is no program or procedure at the specified level, an empty string is returned. The name of the master or starting program is returned if <expN> is 0 or 1.
Example
m_program = program() dialog message "The error occurred in the program; &m_program."
Products
Recital Database Server, Recital Mirage Server, Recital Terminal Developer
