$INC - Revision history

Admin: Created page with "= Action = Includes a binary file in the program at the current position.
2013-02-06T19:56:04Z

Created page with "= <span class="f_Header">Action</span> = Includes a binary 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 a binary 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">$INC</span> label , size | nosize , "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="17%" style="width: 99px; border: 1px solid rgb(0, 0, 0);" |
Label

| valign="top" width="100%" style="width: 496px; border: 1px solid rgb(0, 0, 0);" |
The name of the label you can use to refer to the data.

|- style="vertical-align: top;"
| valign="top" width="17%" style="width: 99px; border: 1px solid rgb(0, 0, 0);" |
Nosize

| valign="top" width="100%" style="width: 496px; border: 1px solid rgb(0, 0, 0);" |
Specify either nosize or size. When you use size, the size of the data will be included. This way you know how many bytes you can retrieve.

|- style="vertical-align: top;"
| valign="top" width="17%" style="width: 99px; border: 1px solid rgb(0, 0, 0);" |
File

| valign="top" width="100%" style="width: 496px; border: 1px solid rgb(0, 0, 0);" |
Name of the file which must be included.

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

Use RESTORE to get a pointer to the data. And use READ, to read in the data.

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

The $INC statement is an alternative for the DATA statement.

While DATA works ok for little data, it is harder to use on large sets of data.

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

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

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

[[RESTORE]], [[DATA]] , [[READ]]

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

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

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

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

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

Dim Size As Word , W As Word , B As Byte

Restore L1 ' set pointer to label
Read Size ' get size of the data

Print Size ; " bytes stored at label L1"
For W = 1 To Size
Read B : Print Chr(b);
Next

End

'include some data here
$inc L1 , Size , "c:\test.bas"
'when you get an error, insert a file you have on your system
</source><br/>{{Languages}}

[[Category:BASCOM_Language_Reference]]