Arbortext Command Language > Commands > read (Command)
  
read (Command)
read [ { -paste | -bufferbuffername} [ -append]] [ -sgml | -untaggedascii | [ -xml] [ -encodingstring] [ -cc | -nocc] [ -pendingdelete | -nopendingdelete] filename
This command inserts the text of the requested file at the point of the cursor.
-paste loads the text of the requested file into either the current or a named paste buffer.
-bufferbuffername forces the information that is read to be loaded into the named buffer specified by buffername. If the buffer already exists it will be overwritten, else it is created.
-append adds text to the end of the buffer file rather than replaces the contents of the buffer.
-sgml allows you to read in an SGML document that does not have the SGML header created by the write -sgml command, that is, starting with <!DOCTYPE.
-untaggedascii allows you to read in the named document as ASCII. Tagging, if any, are interpreted as literal text, not Arbortext Editor tags. -untagged is a synonym for -untaggedascii.
-xml reads an XML document into the current document (SGML or XML). When this option is selected, a completeness check will not be performed (that is, -nocc is implied), and specifying -cc will have no effect.
-encoding determines the encoding of the file being read, as specified by string; string may be one of the following strings:
Supported Encodings
Adobe-Standard-Encoding
Shift_JIS
CNS11643
Big5
ISO-10646-UCS-2
GB2312
ISO-8859-1 to ISO-8859-11
KSC_5601
ISO-8859-13 to ISO-8859-16
EUC-JP
windows-1250 to windows-1258
CEUC
US-ASCII
TEUC
UTF-16
EUC-KR
UTF-8
cp932
cp949
cp936
cp950
-cc forces Arbortext Editor to do a completeness check when it opens a file created with Arbortext Editor. (By default, a completeness check is not done if the file being read in was saved in Arbortext Editor.) This option is recommended when opening documents which were created in Arbortext Editor but were later edited elsewhere and that may no longer be normalized or complete.
-nocc does not allow Arbortext Editor to do a completeness check when reading a document or file. (By default, a completeness check is done after the file is read in.) In this case, the document should be fully normalized.
-pendingdelete replaces any selected text in the document with the file being read.
-nopendingdelete preserves any selected text in the document and places the file being read to the right of the current selection.
* 
If neither -pendingdelete or -nopendingdelete are set, the command replaces any selected text according to the current setting of the set pendingdelete command.
filename is the file name and path (if needed).
Examples
read mydoc
rea -buffer buf1 wishlist.sgm
rea -sgml /lxr/grants89/proposal.sgm
rea -untag budget.sgm
rea -xml http://www.some_site.com/examples/doc1.xml
Related Topics
Opening, referencing, and saving files