ArborX

tsavetxt

Longname: t save t e xt   Open the Documentation Legend
Released: 4.02a 
Created: 4.02a 
Last modified: 6.01a 
See also: tftext

Summary
 Saves a Arbortext APP text stream tag as an ASCII file with or without Arbortext APP formatting codes.
Example extract

The example below saves the text stream 'tx1' to a file called 'volume1.txt' in the specified directory, and strip the Arbortext APP attributes.

 tsavetxt "tx1","d:/text/volume1.txt",0

Syntax (4.02a)
tsavetxt Ø
tsavetxt (   tag:t?  file:s?  mode:n?  options:s?  )
Ø Displays the Save Text Tag (ASCII) dialogue box.
Ø:

The name of the current text tag will be shown in the Save Text Tag (ASCII) dialogue box and you can type in the name of the file you want to save it to and enter the save mode.
tag:t

The name of the tag to be saved.
file:s

The name of the file under which you want to save the tag.

Version specific information7.89e  If a specific encoding is to be used this must be specified on the front of this path or file in the form {:encoding}, e.g. {:utf-8}{myfiles}demo.3d

The encoding menu items are described below.

XML Encoding

Initiates auto XML from the Import types, uses info from file header or BOM 'if it is an XML file'

3B2 Standard

3B2 Modified ASCI

UTF-8

standard

UTF-16

standard

ISO-8859-1

standard
mode:n
0  Remove Arbortext APP controls, e.g. text codes, index references, etc.
1  Leave Arbortext APP controls intact.
options:s

These options allow you to specify an output character map to use when exporting text. Maps may be either internal streams or external maps located in the smaps.3ad file.

–  Specifying a hyphen toggles character map inversion on or off. All of the character maps described below convert from a particular character set to the ISO character set used by Arbortext APP. With tsavetxt we would usually want this to be inverted by specifying a – (hyphen) first to convert from the ISO character set to another character set. For example, specifying –a will save from Arbortext APP ISO to the ANSI character set.
a  Use ANSI character set.
i  Use IBM character set.
o  Use IBM Danish character set.
g  Use IBM Greek character set.
b  Use SmartFont (TextData) character set.
c  Use Mac character set.
s  Use ISO character set (default).
[...]  A specific character map name may be specified between square brackets [ ], e.g. specifying [_m_a_p_ibm] is equivalent to specifying i.

Document created on 08-Feb-2003 (revision 1)