Rename

Last modified: 11 January 2023

Shortcut for the action: Shift+F6

General refactoring settings: Settings | Editor | General

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. Select 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 icon next 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): 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 the Search in comments and strings checkbox to let CLion apply changes to comments and strings.

    • Clear the Rename associated file checkbox if don't want CLion to rename the associated files with the same name.

    • Change the refactoring scope in the corresponding field if needed.

    Rename a directory

  4. Click Preview to observe possible changes in Find Tool Window. Click 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})

See also

Reference

External Links