Rename

Last modified: 24 January 2025

Shortcut:

Main menu: Refactor | Rename

Context menu: Rename

General refactoring settings: Settings | Editor | Code Editing

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 Rename from the context menu or press . 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 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 . 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 the file or directory in the Project tool window.

  2. Press or select Rename from the context menu.

  3. In the Rename dialog that opens, specify the new name.

    Rename a directory

    • 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.

  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