advr.hlp (Topic list)
Important Notice
The pages on this site contain documentation for very old MS-DOS software, purely for historical purposes. If you're looking for up-to-date documentation, particularly for programming, you should not rely on the information found here, as it will be woefully out of date.
SPC Function Details
  Summary  Details  Example                Contents  Index  Back
──────────────────────────────────────────────────────────────────────────────
 SPC(n%)
 
 Usage Notes
   ■ For screen output, the SPC function moves the text cursor to a new
     print position and also overwrites any existing characters on a display
     screen with blanks.
 
   ■ The n% blank characters are printed starting at the current print
     position.
 
   ■ The leftmost print position on an output line is always 1; to have any
     effect, the value of n% must be >= 1.
 
   ■ The rightmost print position is the current line width of the output
     device. See: WIDTH Statement
 
   ■ The behavior of an SPC function depends on the relationship between
     three values:
     • The argument n%
     • The output-line print position when the SPC function is executed
     • The current output-line width
 
   ■ The following table summarizes this relationship:
 
         If Current Position
         On Current Line Is...     Then SPC...
         ══════════════════════    ═════════════════════════════════════════
         n% > output-line width    Calculates (n% MOD width) and skips that
                                   many blanks, starting at current print
                                   position
         n% < output-line width    Skips to the beginning of the next line
         (or n% MOD width)         and generates a number of blanks equal to:
 
                                      (n% * (width * current print position))