ArborX

addstr

Longname: add str ing   Open the Documentation Legend
Released: 4.53a 
Created: 4.53a 
See also: defstr twdb wdb wmn
Dialogue Boxes

Summary
 Adds data to a 3B2 string, or copies the contents of one string to the end of another.
Example extract

This example copies the content of string number 1007 to string number 390.

 addstr 390,1007

Syntax (4.53a)
addstr string:n extra data:s  exact:n?
addstr string1:n string2:n
string:n The number of a string to which the data from the extra data parameter will be added.
extra data:s The string of extra data which will be added to the string specified by the string parameter.
exact:n
Ø|0  3B2 processes characters within extra data. That is, \n is converted to a newline, \\ is a single backslash.
exact:n
1  The characters within extra data are not processed. An example of when this is useful is when extra data contains a filename with backslashes.
string1:n The number of the original string.
string2:n The number of the string to be appended to string1.
addstr does not check to see whether or not it has already added a string to another. Repeating addstr without using defstr to reset a string to a default setting, can give your menu or dialogue box strings showing the same item over and over again.
Example

The example below adds a new line to string 390, a user-defined string using the defstr macro. The \n line break character appears at the end of the new line.

 addstr 390,"Line in dialogue box with entry field}^var %1..20s\n"
User string numbers are set and only numbers within the specified ranges can be used. If other numbers are used you run the risk of conflicting with 3B2's own strings and causing problems or crashes. See defstr for more details.

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