$INCLUDE - Revision history

Admin: Created page with "= Action = Includes an ASCII file in the program at the current position.
2013-02-06T19:57:52Z

Created page with "= <span class="f_Header">Action</span> = Includes an ASCII file in the program at the current position. <span style="font-family: Arial;"> </span> <span style="font-fa..."

New page
= <span class="f_Header">Action</span> =

Includes an ASCII file in the program at the current position.

<span style="font-family: Arial;"> </span>

<span style="font-family: Arial;"> </span>

= <span class="f_Header">Syntax</span> =

<span class="f_Syntax">$INCLUDE</span> "file"

<span style="font-family: Arial;"> </span>

<span style="font-family: Arial;"> </span>

= <span class="f_Header">Remarks</span> =
<div style="padding: 0px; margin: 0px 0px 0px 4px;">
{| width="604" cellspacing="0" cellpadding="1" border="1" style="border: 2px solid rgb(0, 0, 0); border-spacing: 0px; border-collapse: collapse;"
|- style="vertical-align: top;"
| valign="top" width="7%" style="width: 39px; border: 1px solid rgb(0, 0, 0);" |
File

| valign="top" width="100%" style="width: 556px; border: 1px solid rgb(0, 0, 0);" |
Name of the ASCII file, which must contain valid BASCOM statements.

<span style="font-family: Arial;"> </span>

This option can be used if you make use of the same routines in many programs. You can write modules and include them into your program.

If there are changes to make you only have to change the module file, not all your BASCOM programs.

You can only include ASCII files!

|}
</div>
<span style="font-family: Arial;"> </span>

Use $INC when you want to include binary files.

<span style="font-family: Arial;"> </span>

 

You can specify an absolute file name (with a drive and full path) like : $INCLUDE "c:\folder\myfile.bas"

Or you can specify a relative file name like : $INCLUDE "myfile.bas"

The main program path will be used to determine the absolute file name.

If your main file is stored under c:\abc\main.bas , and you include a file named "test.inc" , the compiler expects a file named "c:\abc\test.inc"

 

You can include a path too. The path is relative to the main file.

When used in sub folders use " \ " (back slash). The path uses the DOS/Windows convention. A forward slash will work too since windows does not seem to be bothered with it.

Example with sub folder Test:<span style="font-family: Arial;"> </span><span style="font-size: 8pt; font-family: Courier; font-weight: bold; color: rgb(0, 0, 128);">$include</span><span style="font-size: 8pt; font-family: Courier;"> </span><span style="font-size: 8pt; font-family: Courier; color: rgb(0, 128, 128);">"Test\my_functions.bas"</span>

<span style="font-size: 8pt; font-family: Courier; color: rgb(0, 128, 128);"> </span>

<span style="font-size: 8pt; font-family: Courier; color: rgb(0, 128, 128);"> </span>

<span style="font-family: Arial;"> </span>

<span style="font-family: Arial;"> </span>

= <span class="f_Header">See Also</span> =

[[$INC]]

<span style="font-family: Arial;"> </span>

<span style="font-family: Arial;"> </span>

= <span class="f_Header">Example</span> =

<br/><source lang="bascomavr">
$regfile = "m48def.dat"
$crystal = 4000000
$hwstack = 10
$swstack = 10
$framesize = 26
$baud = 19200
Config Com1 = Dummy , Synchrone = 0 , Parity = None , Stopbits = 1 , Databits = 8 , Clockpol = 0

'--------------------------------------------------------------
Print "INCLUDE.BAS"
'Note that the file 123.bas contains an error
$include "123.bas" 'include file that prints Hello
Print "Back in INCLUDE.BAS"
End
</source><br/>{{Languages}}

[[Category:BASCOM_Language_Reference]]