APPEND
Command
APPEND source [TO] destination [(parameters)]
Appends the contents of the source onto the end of the contents of
the destination. (The contents of the source file remain the same.)
You can use APPEND to combine two files
on
a disk.
The source
is
a valid TRSDOS filespec or input devspec, and
destination
is
a valid TRSDOS filespec.
The parameters are:
ECHO echoes the characters to the screen when appending a
device
to
a file.
STRIP backspaces the destination file one byte before the
append begins. Use this parameter with files, such as
SCRIPSIT files, that have
an
"internal end of file marker."
Examples
APPEND
EAST/DAT:l
TO
WEST/DAT:0(ENTER)
adds the information
in
EAST/OAT
on
Drive 1 onto the end of the
information
in
WEST/OAT
on
Drive
0.
APPEND
*K
I
TO
WEST
IDAT:
0
(ENTER)
appends the information that you type
on
the keyboard to the end of
WEST/OAT
on
Drive
0.
Press
(CONTROL)(SHIFT)(@)
(at the same time)
to end the append.
APPEND
*KI
TO
WEST/DAT:0
(ECHO)
(ENTER)
displays what you are appending to WEST/OAT as you type
it.
Press
(CONTROL)(SHIFT)(@)
(at the same time) to end the append.
Error
Conditions
If the records
in
source and destination are not the same length, then
an
error message appears.
APPEND
is
mainly for data files since
it
works only with files
containing ASCII text. You cannot APPEND program files that are
in
the "load module format." Also,
you
cannot
APPEND BASIC
programs
unless
they
are saved
in
the
ASCII format.
Some programs (such as SCRIPSIT) place a special marker at the
end of a file. If this marker
is
in
the file, you must use the STRIP
parameter when appending to it. If you do not use the STRIP
parameter, the program ignores the appended section of the file.
Consider the following example:
1-17
To Next Page
Loading...
