A script-enabled browser is required for this page to function properly.

ORA_FFI.IS_NULL_PTR built-in function

This function determines whether a library, function, or pointer handle is null.

Syntax


FUNCTION ORA_FFI.IS_NULL_PTR (handle libHandleType)
RETURN BOOLEAN;

FUNCTION ORA_FFI.IS_NULL_PTR (handle funcHandleType)
RETURN BOOLEAN;

FUNCTION ORA_FFI.IS_NULL_PTR (handle pointerType)
RETURN BOOLEAN;

Parameters

Parameter

Description

handle

The library, function, or pointer to evaluate.

Returns

TRUE

If the handle is null.

FALSE

If the handle is not null.

Example


/* This example uses ORA_FFI.IS_NULL_PTR */

PROCEDURE register_libs IS
...
BEGIN
  /* Load foreign function library */
  libhandle := ORA_FFI.LOAD_LIBRARY
  ('C:\oralibs\', 'libfoo.dll');
  /* Test whether library is null */
IF (ORA_FFI.IS_NULL_PTR(libhandle)) THEN
  ...
END;

See also

About the ORA_FFI built-in package

ORA_FFI built-in package