CHANGE_CASE

    Changes the case of all alphabetic characters in a buffer, range, or
    string, according to the keyword that you specify.

    Optionally, returns a string, range, or buffer containing the changed
    text.

 SYNTAX

    [returned_buffer |
     returned_range  |
     returned_string  := ] CHANGE_CASE ({buffer | range | string},
                                        {LOWER | UPPER | INVERT},
                                        [IN_PLACE | NOT_IN_PLACE])

 PARAMETERS

     buffer            The buffer in which you want VAXTPU to change the
                       case.  Note that you cannot use the keyword
                       NOT_IN_PLACE if you specify a buffer for the first
                       parameter.

     range             The range in which you want VAXTPU to change the
                       case.  Note that you cannot use the keyword
                       NOT_IN_PLACE if you specify a range for the first
                       parameter.

     string            The string in which you want VAXTPU to change the
                       case.  If you specify IN_PLACE for the third
                       parameter, CHANGE_CASE makes the specified change to
                       the string specified in the first parameter.
                       CHANGE_CASE has no effect on string constants.

     LOWER             A keyword directing VAXTPU to change letters to all
                       lowercase.

     UPPER             A keyword directing VAXTPU to change letters to all
                       uppercase.

     INVERT            A keyword directing VAXTPU to change uppercase
                       letters to lowercase, and lowercase letters to
                       uppercase.

     IN_PLACE          A keyword directing VAXTPU to make the indicated
                       change in the buffer, range, or string specified.
                       This is the default.

     NOT_IN_PLACE      A keyword directing VAXTPU to leave the specified
                       string unchanged and return a string that is the
                       result of the specified change in case.  You cannot
                       use NOT_IN_PLACE if the first parameter is specified
                       as a range or buffer.  To use NOT_IN_PLACE, you must
                       specify a return value for CHANGE_CASE.

     returned_buffer   A variable of type buffer pointing to the buffer
                       containing the modified text, if you specify a
                       buffer for the first parameter.  The variable
                       "returned_buffer" points to the same buffer pointed
                       to by the buffer variable specified as the first
                       parameter.

     returned_range    A range containing the modified text, if you specify
                       a range for first parameter.  The returned range
                       spans the same text as the range specified as a
                       parameter, but they are two separate ranges.  If you
                       subsequently change or delete one of the ranges,
                       this has no effect on the other range.

     returned_string   A string containing the modified text, if you
                       specify a string for the first parameter.

 EXAMPLES


    1.  CHANGE_CASE (main_buffer, UPPER);

        Makes all characters in the main buffer uppercase.  If you enter
        this on the command line and if the buffer is associated with a
        visible window, you will see the changes take effect immediately.

    2.  returned_value := CHANGE_CASE (CURRENT_BUFFER, LOWER, IN_PLACE);

        Makes all characters in the current buffer lowercase.  The variable
        returned_value contains the newly modified current buffer.


    3.  returned_value := CHANGE_CASE (the_string, INVERT, NOT_IN_PLACE);

        Inverts the case of all characters in the string pointed to by
        "the_string", and returns the modified string in the variable
        "returned_value".


 Related Topic

    EDIT    TRANSLATE