Erfn

Home › Error Handling Functions › Erfn

Erfn

Returns a pointer to the name of the failing procedure; null unless built with -exx.

Syntax

Declare Function Erfn ( ) As ZString Ptr

Description

An error reporting function returning a pointer to the name of the function.

Return Value

Returns a pointer to the string identifying the function where the error occurred.

Returns NULL if the source is not compiled with the -exx compiler option.

Remarks

Usage

result = Erfn ( )

Dialect Differences

• Not available in the -lang qb dialect unless referenced with the alias __Erfn.

Differences from QB

• New to FreeBASIC

See also

• Erl
• Ermn
• On...Error

Examples

'' test.tiko -- compile with: tiko -exx test.tiko

sub Generate_Error

  on error goto handler

  error 1000

  exit sub

handler:

  print "Error Function: "; *erfn( )

  print "Error Module  : "; *ermn( )

end sub

Generate_Error( )

Output:

Error Function: GENERATE_ERROR
Error Module  : test.tiko

---

Category: Error Handling Functions
Kind: function

---

Reproduced from the FreeBASIC Wiki Manual under the GNU Free Documentation License 1.3 — with no Invariant Sections, no Front-Cover Texts and no Back-Cover Texts. Copyright © the FreeBASIC project and wiki contributors. See License.