Movatterモバイル変換

34.9.1. Including Files

34.9.2. The define and undef Directives

34.9.3. ifdef, ifndef, elif, else, and endif Directives

To include an external file into your embedded SQL program, use:

EXEC SQL INCLUDEfilename;EXEC SQL INCLUDE <filename>;EXEC SQL INCLUDE "filename";

The embedded SQL preprocessor will look for a file namedfilename.h, preprocess it, and include it in the resulting C output. Thus, embedded SQL statements in the included file are handled correctly.

Theecpg preprocessor will search a file at several directories in following order:

But whenEXEC SQL INCLUDE "filename" is used, only the current directory is searched.

In each directory, the preprocessor will first look for the file name as given, and if not found will append.h to the file name and try again (unless the specified file name already has that suffix).

Note thatEXEC SQL INCLUDE isnot the same as:

#include <filename.h>

because this file would not be subject to SQL command preprocessing. Naturally, you can continue to use the C#include directive to include other header files.

Similar to the directive#define that is known from C, embedded SQL has a similar concept:

EXEC SQL DEFINEname;EXEC SQL DEFINEnamevalue;

So you can define a name:

EXEC SQL DEFINE HAVE_FEATURE;

And you can also define constants:

EXEC SQL DEFINE MYNUMBER 12;EXEC SQL DEFINE MYSTRING 'abc';

Useundef to remove a previous definition:

EXEC SQL UNDEF MYNUMBER;

Of course you can continue to use the C versions#define and#undef in your embedded SQL program. The difference is where your defined values get evaluated. If you useEXEC SQL DEFINE then theecpg preprocessor evaluates the defines and substitutes the values. For example if you write:

EXEC SQL DEFINE MYNUMBER 12;...EXEC SQL UPDATE Tbl SET col = MYNUMBER;

thenecpg will already do the substitution and your C compiler will never see any name or identifierMYNUMBER. Note that you cannot use#define for a constant that you are going to use in an embedded SQL query because in this case the embedded SQL precompiler is not able to see this declaration.

If multiple input files are named on theecpg preprocessor's command line, the effects ofEXEC SQL DEFINE andEXEC SQL UNDEF do not carry across files: each file starts with only the symbols defined by-D switches on the command line.

You can use the following directives to compile code sections conditionally:

ifdef/ifndef...endif constructs can be nested, up to 127 levels deep.

This example will compile exactly one of the threeSET TIMEZONE commands:

EXEC SQL ifdef TZVAR;EXEC SQL SET TIMEZONE TO TZVAR;EXEC SQL elif TZNAME;EXEC SQL SET TIMEZONE TO TZNAME;EXEC SQL else;EXEC SQL SET TIMEZONE TO 'GMT';EXEC SQL endif;