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

TOOL_RES.RFOPEN built-in function

This function opens the specified file as a resource file.

Syntax


FUNCTION TOOL_RES.RFOPEN
(spec VARCHAR2)
RETURN rfhandle;

Parameters

Parameter

Description

spec

A file to be opened. spec is not case-sensitive.

Returns

A handle to the specified file.

Usage notes

The following exceptions may be raised by TOOL_RES.RFOPEN:

FILE_NOT_FOUND

Raised if spec does not point to a valid file, or the file cannot be opened.

TOOL_ERR.TOOL_ERROR

Raised if an internal error is trapped.

Example


  /*
  ** This example uses TOOL_RES.RFOPEN
  */
  PROCEDURE my_init
   (fhandle OUT TOOL_RES.RFHANDLE) IS 
    BEGIN
    /* Open a resource file and assign it to
     the handle, 'fhandle.' */
     fhandle := TOOL_RES.RFOPEN('C;\my_app.res');
    ...
  END;

See also

About the TOOL_RES built-in package

TOOL_RES built-in package