Museum

Home

Lab Overview

Retrotechnology Articles

⇒ Online Manual

Media Vault

Software Library

Restoration Projects

Artifacts Sought

EVE REPLACE — VMS 5.4

 REPLACE

 Searches for the "old string" you specify and replaces it with the "new
 string" you specify.

 Steps:

    1.  Use REPLACE (or with the WPS keypad, press GOLD-; or GOLD-:).

    2.  Type the old string---the text you want to find.

    3.  Type the new string---the text you want to use instead, if any.

 Example:

    The following command replaces the old string ("butter") with the new
    string ("margarine"):

       Command: REPLACE butter margarine

 Usage notes:

 o  The search begins in the current direction.  If the old string is not
    found in that direction, EVE automatically searches in the opposite
    direction.  If the old string is found in the opposite direction, EVE
    asks if you want to change direction and go there---press RETURN for
    Yes, or type No and press RETURN.

 o  If the old string is found, EVE highlights the text, and asks you for
    one of the following choices:

       YES .... (Default.)  Replaces this one and find the next one.
       NO ..... Skips this one and finds the next one.
       ALL .... Replaces all the occurrences in the current direction.
       LAST ... Replaces this one and stops here.
       QUIT ... Cancels---skips this one and stops here.

 o  If the search covers the buffer more than once, EVE asks if you want to
    continue, so you can avoid replacing a string again when the old and
    new strings are similar.  When the operation finishes, EVE tells you
    how many replacements were made.  If the old string is not found, EVE
    tells you it replaced 0 occurrences.

 o  By default, if the old string is all lowercase, EVE searches for any
    occurrence regardless of its case in the buffer.  If the old string has
    any uppercase letters, EVE searches for an exact match.  If you want to
    find and replace lowercase occurrences only, use SET FIND CASE EXACT.

 o  If the new string is also all lowercase, EVE tries to match the case
    appropriately for each replacement.  For example, a capitalized version
    of the old string is replaced by a capitalized version of the new
    string; an all uppercase old string is replaced by an all uppercase new
    string; other versions of the old string are replaced by lowercase
    versions of the new string.

 o  If the new string contains any uppercase letters, the replacement is
    case exact.  The following table shows how EVE uses the case of the
    strings:

       Old string  New string     Highlights   Replacements
       ----------------------------------------------------
       butter      margarine      butter       margarine
                                  Butter       Margarine
                                  BUTTER       MARGARINE
                                  BuTtEr       margarine

       Butter      margarine      Butter       margarine

       butter      Margarine      butter       Margarine
                                  Butter       Margarine
                                  BUTTER       Margarine
                                  BuTtEr       Margarine

       Butter      Margarine      Butter       Margarine

 o  To replace phrases (several words), let EVE prompt you for the strings
    or put them in quotes, as follows (unless you are typing the strings in
    a DECwindows dialog box):

       Command: REPLACE "Samuel L. Clemens" "Mark Twain"

 o  After REPLACE, the old string becomes the search string for the next
    FIND.  Thus, using FIND NEXT or pressing the FIND key twice searches
    for the old string.

 Related topics:

    FIND     FIND NEXT     SET FIND CASE EXACT     WILDCARD FIND

Typewritten Software • bear@typewritten.org • Edmonds, WA 98026