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.

                                             ◄Up► ◄Contents► ◄Index► ◄Back►
─────Programmer's WorkBench─────────────────────────────────────────────────
 
     The Qreplace function performs a find-and-replace operation on the
     current file, prompting for find-and-replacement strings and
     confirmation at each occurrence.
 
     Qreplace («qreplace»)
          Performs the replacement from the cursor to the end of the
          file, wrapping around the end of the file if the Searchwrap
          switch is set to yes.
          See: Searchwrap
 
     Arg <boxarg> │ <linearg> │ <streamarg> Qreplace
     («arg» <boxarg> │ <linearg> │ <streamarg> «qreplace»)
          Performs the replacement over the selected area.
 
          NOTE: PWB does not adjust the selection at each replacement
                for changes in the length of the text. For boxargs and
                streamargs, PWB may replace text that was not included
                in the original selection or miss text included in the
                original selection.
 
     Arg mark Qreplace («arg» mark «qreplace»)
          Performs the replacement on text from the cursor to the
          specified mark. Replaces over text as if it were selected,
          according to the current selection mode. The <mark> argument
          cannot be a line number.
 
     Arg number Qreplace («arg» number «qreplace»)
          Performs the replacement for the specified number of lines,
          starting with the line at the cursor.
 
     Arg Arg ... Qreplace («arg» «arg» ... «qreplace»)
          As above except using regular expressions.
          See: ◄Regular Expressions►
 
     Meta ... Qreplace («Meta» ... «Qreplace»)
          As above except the sense of the Case switch is reversed for
          the operation.
 
     Returns
 
     True:  At least one replacement was performed.
     False: String not found, or invalid pattern.
 
     See
 
     ◄Regular Expressions►
 
     See
 
     Mreplace, Replace, Searchwrap
                                    -♦-