[Main page] [Overview]     /master /include_file

---

SYNOPSIS
mixed include_file (string file, string compiled_file, int sys_include)

DESCRIPTION
Generate the pathname of an included file.

Arguments:
previous_object(): The object causing the compile.
file : The name given in the #include directive.
compiled_file : The object file which is just compiled.
(compat: name given without leading "/")
sys_include : TRUE for #include <> directives.

Result:
0: use the normal include filename generation (""-includes are
used as they are, <>-includes are handled according to
H_INCLUDE_DIRS).

<path>: the full absolute pathname of the file to include,
without parentdir parts ("/../"). Leading slashes ("/")
may be omitted.

else: The include directive is not legal.

If the function does not generate a valid pathname, the driver
will next try to resolve the include using the H_INCLUDE_DIRS hook.

HISTORY
Introduced in LDMud 3.2.8.

SEE ALSO
hooks(C), inherit_file(M), include_dirs(H)