Class

FunctionNotFoundException

Description

A function declared using the Declare statement's "Soft" keyword could not be loaded.

Properties

Name	Type	Read-Only	Shared
ErrorNumber	Integer
Message	String

Methods

Name	Parameters	Returns
Constructor	message As String = "", errorCode As Integer = 0
Stack		String()
StackFrames		StackFrame()

Property descriptions

FunctionNotFoundException.ErrorNumber

ErrorNumber As Integer

Used to contain an error number that describes the runtime error.

FunctionNotFoundException.Message

Message As String

Used to contain descriptive text to display when the runtime exception is encountered.

Method descriptions

FunctionNotFoundException.Constructor

Constructor(message As String = "", errorCode As Integer = 0)

Note

Constructors are special methods called when you create an object with the New keyword and pass in the parameters above.

Used to raise your own RuntimeException with a message and optional error code.

FunctionNotFoundException.Stack

Stack As String()

Returns a String array that contains a list of all of the methods in the stack from the main entrypoint to the point at which the exception was invoked.

The stack contains all the method names up and including the current method name.

This feature only works if the IncludeFunctionNames property on the App object is selected in the Shared Build Settings.

In addition to your own method calls, you will also see framework method calls, but these may not always be completely accurate due to insufficient symbols for the OS to resolve.

FunctionNotFoundException.StackFrames

StackFrames As StackFrame()

Returns an array containing the stack when the exception was first raised.

Notes

A FunctionNotFoundException is raised when a Soft Declare statement such as this:

Soft Declare Function getpid Lib "libc" () As Integer

fails to find the specified function or library and it cannot be loaded. If a “hard” Declare fails to load the function, the application will not run at all.

To determine whether the function can be loaded without actually using the Soft Declare, use the System module's IsFunctionAvailable method. It returns a Boolean indicating whether the function can be loaded on the user's machine.

Sample code

The following example adds a RuntimeException handler to the above example.

Soft Declare Function getpid Lib "libc" () As Integer

Exception err As FunctionNotFoundException
  MessageBox(err.Message + " Error No.: " + Str(err.ErrorNumber))

Compatibility

All project types on all supported operating systems.