FILE::INCLUDE 1g 2023 laplante@plcb.ca GOWEB/FILE

title: “file::include Function Documentation” author: “laplante@plcb.ca” date: “2023” version: “1.0.0”

caregory: “GOWEB/FILE”

Name

file::include Include and execute files in the current context.

Synopsis

file::include or include(file[, file…, reload:bool, error: variable])

Description

This function includes a file into the current context.

• If the file is a compiled file, it will be included when the function is called.
• If the file is a text file, it will be compiled and included at the time of the function call.
• All functions within the included file will be defined after inclusion.
• The debugger may not display the correct line numbers in the included file.
• If a file has already been included, it will not be included again unless rerun is set to true.
• If the file path starts with /, the system will prepend the docroot (if defined).

Parameters

• reload : include the files even if they are already included.
• rerun : Re-execute the include but do not append the functions.
• error : variable to capture errors if the inclusion fails.

Examples

res={{
    template := "../../tests/038-file/template10";
    file := "../../tests/038-file/binary10";
    temp := "../../tests/038-file/temp10";
    generate(template:template, file:file, compile:true, save:temp);
    include(file);
    "After include file\n";
    f10(4);
    "end of code\n";
}}endtest.

// with template10

Template10
{{
    func f10(i) {
        "A"; i * 2;
    }
    "execution of template"; f10(5);
}}
\{{
    func f10(i) {
        "B"; i * 2;
    }
    f10(5);
}}endtemplate10.

Return Example

res=Template10
execution of templateA10
B10endtemplate10.
After include file
B8end of code
endtest.

Author

laplante@plcb.ca

See also

• File functions
• Index

Version

• 1.0.0 2023 laplante@plcb.ca initial version