ArborX


@

Longname: @   Open the Documentation Legend
Released: not available 
Created: not available 
See also: <#> tyone

Summary
Inserts a specified string of characters at the current text cursor position exactly as typed. This is useful for inserting attribute changes directly, or even for inserting an item of 'boilerplate' text quickly.
Example extract

The macro below inserts the codes for a typeface change into the text stream at the text cursor position, and then redraws the screen. Because it is followed by another macro, @ and its text have to be placed within parentheses:

 (@<?tf="Times-b">):wdr

Syntax (SVNNA)
insert_string:b The string of characters to be inserted in the text stream. These are not validated, so it is quite easy to get invalid sequences of characters (e.g. mismatched brackets).

An alternative to using the @ macro is to click on the icon in the Status bar (see tyone)

Example

When an @ macro appears within parentheses the (, ) and \ characters are treated specially. Preceding any of these characters with the backslash will output the character itself, so the macro below will output ()\.

 (@\(\)\\)
Example

This is particularly important to remember if you use @ to set up Maths keys with functions which require use of the backslash. The macro below does this correctly, and also includes some nested macros which make entering a fraction such as \curr{78}\over{999} easier:

 (@<$>\\curr{}\\over{}<$>):(9 klf):(*1077 (7 krt):(*1077 krt))
Example

The simple script sample below inserts the contents of the ^name variable at the end of strm0 text stream and places a carriage return after that also.

 ^name=chris 1
 tend "strm0" 2
 @^name^ 3
 #13 4
1
Defines the contents of the variable ^name as 'chris'.
2
Instructs 3B2 to go to the end of the current text stream. For more information see the tend command.
3
Insert the contents of the variable ^name.
4
Inserts a hard return.

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