Click above to get retro games delivered to your door ever month!

Syntax

ATOS( aValues[, acPictures ] )

Purpose

Construct a single string from an array of strings.

Arguments

     aValues -- array of character strings/expressions

     acPictures -- array of pictures used to format the expressions, or
                       a single picture to apply to all elements of
                       aValues; defaults to "" (ie. no picture)

Setup

The aValues array should be filled with character data expressions,
while the acPictures should either be a parallel array of corresponding
pictures to use or a single picture to apply to all the elements of
cValues.

Example

     LOCAL _vals := { "You've got to ", "pray ", ;
                      "just to make it ", "today!" }, ;
           _pics := { "", "@!", "", "@!" }

     ? ATOS( _vals )
     ? ATOS( _vals, _pics )
     ? ATOS( _vals, "@!" )

Returns

A string containing all the elements of aValues, transformed using the
parallel element in the picture array, then concatenated together.

Side Effects

The program will crash if any array elements are undefined or syntactically
incorrect (eg. not character expressions), or if they reference
non-existent fields or memory variables.

Artful Calls

None.

Source File

AA_ATOS.PRG