3.10 Include Files

3.10 Include Files

FunnelWeb provides an include file facility with a maximum depth of 10.

When FunnelWeb sees a line of the form @i , it replaces the entire

Tutorial

line (including the EOL) with the contents of the specified include file.

FunnelWeb s include file facility is intended to operate at the line level. If the

Developer

last line of the include file is not terminated by an EOL, FunnelWeb issues a

warning and inserts one (in the copy in memory).

Reference

The @i construct is illegal if it appears anywhere except at the start of a line.

1 Introduction

The construct must be followed by a single blank. The file name is defined to

2 Interface

be everything between the blank and the end of the line (no comments (@!)

3 Scanner

please!). Example: If the input file is

4 Parser

5 Analyser

"Uh Oh, It s the Fuzz. We re busted!" said Baby Bear.

6 Tangle

@i mr_plod.txt

7 Weave

"Quick! Flush the stash down the dunny and split."

   said Father Bear.

8 Shell

9 Commands

and there is a file called mr_plod.txt containing

10 Glossary

11 References

" Ello,  Ello,  Ello! What s all this  ere then?"

   Mr Plod exclaimed.

SEARCH

then the scanner translates the input file into

"Uh Oh, It s the Fuzz. We re busted!" said Baby Bear.

" Ello,  Ello,  Ello! What s all this  ere then?"

   Mr Plod exclaimed.

"Quick! Flush the stash down the dunny and split."

   said Father Bear.

As a point of terminology, FunnelWeb calls the original input file the 

input

file

 and calls include files and their included files 

include files

.

The include file construct operates at a very low level. An include line can

appear anywhere in the input file regardless of the context of the surrounding

lines.

FunnelWeb sets the special character to the default (@) at the start of each

include file and restores it to its previous value at the end of the include file.

This allows macro libraries to be constructed and included that are independent

of the prevailing special character at the point of inclusion. The same goes for

the input line length limit which is reset to the default value at the start of each

http://www.ross.net/funnelweb/reference/scanner_include.html (1 of 2) [3/3/2000 10:47:45 PM]