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.

  ◄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))