Difference between revisions of "PROGRAM()"

From Lianjapedia
Jump to: navigation, search
 
Line 9: Line 9:
  
 
==Description==
 
==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.
+
The PROGRAM() function returns the name of the currently executing program or procedure.  The name is returned as a character string in upper case without path or file extension.
  
 
<expN>
 
<expN>
Line 17: Line 17:
 
<code lang="recital">
 
<code lang="recital">
 
m_program = program()
 
m_program = program()
dialog message "The error occurred in the program; &m_program."
+
messagebox("The error occurred in the program; &m_program.")
 
</code>
 
</code>
  
 
[[Category:Documentation]]
 
[[Category:Documentation]]
 
[[Category:Functions]]
 
[[Category:Functions]]

Latest revision as of 08:34, 30 May 2013

Purpose

Function to return the currently executing program name

Syntax

PROGRAM([<expN>])

See Also

DO, FUNCTION, PROCEDURE, DOLEVEL(), LINENO(), PATH(), PROCLIBS(), PROCLINE(), PROCNAME(), SYS()

Description

The PROGRAM() function returns the name of the currently executing program or procedure. The name is returned as a character string in upper case without path or file extension.

<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()
messagebox("The error occurred in the program; &m_program.")