[<<Previous Entry]
[^^Up^^]
[Next Entry>>]
[Menu]
[About The Guide]
REQUEST
Declare a module request list
------------------------------------------------------------------------------
Syntax
REQUEST <idModule list>
Arguments
<idModule list> is the list of modules that will be linked into the
current executable (.EXE) file.
Description
REQUEST is a declaration statement that defines a list of module
identifiers to the linker. Like all other declaration statements, a
REQUEST statement must be specified before any executable statements in
either the program file, or a procedure or user-defined function
definition.
During the compilation of CA-Clipper source code, all explicit
references to procedures and user-defined functions are made to the
linker. In some instances, within a source file, there may be no
references made to procedure or user-defined function names until
runtime. REQUEST resolves this situation by forcing the named
procedures or user-defined functions to be linked even if they are not
explicitly referenced in the source file. This is important in several
instances:
. Procedures, user-defined functions, or formats referenced with
macro expressions or variables
. Procedures and user-defined functions used in REPORT and LABEL
FORMs and not referenced in the source code
. User-defined functions used in index keys and not referenced
in the source code
. ACHOICE(), DBEDIT(), or MEMOEDIT() user functions
. Initialization procedures declared with the INIT PROCEDURE
statement
. Exit procedures declared with the EXIT PROCEDURE statement
To group common REQUESTs together, place them in a header file and then
include (#include) the header file into each program file (.prg) that
might indirectly use them.
Examples
. This example shows a typical header file consisting of common
REQUESTs for REPORT FORMs:
// Request.ch
REQUEST HARDCR
REQUEST TONE
REQUEST MEMOTRAN
REQUEST STRTRAN
See Also:
ACHOICE()
ANNOUNCE
DBEDIT()
EXIT PROCEDURE
EXTERNAL*
This page created by ng2html v1.05, the Norton guide to HTML conversion utility.
Written by Dave Pearson