CLion 2020.3 Help

Rename

Rename refactoring allows you to rename symbols, files, and directories globally with all the references to them in the code corrected automatically.

Rename a symbol

  1. Select an item to be renamed.

  2. Choose Refactor | Rename from the main or context menu or press Shift+F6. The selected symbol gets highlighted and you can type a new name in the highlighted area.

  3. CLion displays the Rename in comments and strings icon and the Rename in text occurrences iconnext to the highlighted element.

    The in-place rename refactoring

    You can click these icons or press Tab to open the context menu and select the additional rename options.

    The inplace rename refactoring dialog
    • Comments and strings: the occurrences of the symbol will be also renamed in comments and string literals.

    • Text occurrences (Objective-C only): the occurrences of the symbol will be also renamed in files that don't contain any source code (documentation, text files, HTML files, and so on).

  4. If you want to change other refactoring options or preview the refactoring results, click the More options link or press Shift+F6. In the dialog that opens, you can select the refactoring scope and click Preview to preview the changes in a separate tool window before applying them.

    The Rename dialog

Rename a file or directory

  1. Select a desired file in the Project tool window.

  2. Choose Refactor | Rename on the main or context menu or press Shift+F6.

  3. In the Rename dialog that opens, specify the new filename. Select Search in comments and strings checkbox to let CLion apply changes to comments and strings.

    Rename a directory
  4. Press Preview to observe possible changes in Find Tool Window. Press Refactor to proceed.

    CLion finds all the occurrences of the filename and changes them respectively.

Example

This example represents CMakelists.txt before and after applying Rename file to Calendar.cpp:

Before After
cmake_minimum_required(VERSION 3.2) project(Calendar_master) set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -std=c++11") set(SOURCE_FILES calendars/Calendar.cpp calendars/Calendar.h main.cpp) add_executable(Calendar_master ${SOURCE_FILES}
cmake_minimum_required(VERSION 3.2) project(Calendar_master) set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -std=c++11") set(SOURCE_FILES calendars/CalendarRen.cpp calendars/CalendarRen.h main.cpp) add_executable(Calendar_master ${SOURCE_FILES})
Last modified: 25 November 2020