Difference between revisions of "PROCNAME()"

From Lianjapedia
Jump to: navigation, search
m (1 revision)
 
(2 intermediate revisions by the same user not shown)
Line 1: Line 1:
 
==Purpose==
 
==Purpose==
 
Function to return name of currently executing procedure
 
Function to return name of currently executing procedure
 
  
 
==Syntax==
 
==Syntax==
 
PROCNAME([<expN>])
 
PROCNAME([<expN>])
 
  
 
==See Also==
 
==See Also==
[[DEBUG]], [[DO]], [[MESSAGE]], [[RESUME]], [[SUSPEND]], [[DOLEVEL()]], [[MESSAGE()]], [[PATH()]], [[PROCLIBS()]], [[PROCLINE()]], [[SYS()]], [[SET DEBUG]], [[SET DOHISTORY]], [[SET ECHO]], [[SET HISTORY]]
+
[[ASTACKTRACE()]], [[DO]], [[DOLEVEL()]], [[PATH()]], [[PROCLIBS()]], [[PROCLINE()]], [[SYS()]]
 
+
  
 
==Description==
 
==Description==
The PROCNAME() function returns the name of the currently executing program or procedure.  This function is useful when used with the SET KEY TO command or ON ERROR routines.  The PROCNAME() function always returns a character string in lower case.  If a program is currently being executed , the ".prg" for program or ".dbo" for compiled program will be returned with the name of the program.  Otherwise if a procedure or user defined function (UDF) is being executed, only the name will be returned.
+
The PROCNAME() 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>===
 
Specifying the optional <expN> causes PROCNAME() 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.
 
Specifying the optional <expN> causes PROCNAME() 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==
 
==Example==
Line 24: Line 20:
 
</code>
 
</code>
  
 
==Products==
 
Recital, Recital Server
 
 
[[Category:Documentation]]
 
[[Category:Documentation]]
 
[[Category:Functions]]
 
[[Category:Functions]]

Latest revision as of 08:34, 30 May 2013

Purpose

Function to return name of currently executing procedure

Syntax

PROCNAME([<expN>])

See Also

ASTACKTRACE(), DO, DOLEVEL(), PATH(), PROCLIBS(), PROCLINE(), SYS()

Description

The PROCNAME() 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 PROCNAME() 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_procname = procname()
dialog message "The error occurred in the procedure &m_procname."