Rename Refactorings
Rename refactorings allow you to rename symbols and files globally with all the references to them in the code corrected automatically.
Renaming a symbol
To rename a symbol, follow these general steps
- Select the item to be renamed.
To select a file, click the desired file in the Project Tool Window.
To select a symbol in the editor, place the caret at the name of the symbol to be renamed.
To select a symbol in the Project Tool Window, make sure that the members are shown, and then click the desired symbol.
To select a symbol in the Structure view, click the desired symbol in the Structure tool window.
Choose on the main menu or on the context menu, or press Shift+F6.
-
The suggested name appears right below the symbol in question. You can either accept suggestion, or type a new name.
Apply changes.
Renaming a file or directory
To rename a file or directory
Select a desired file in the Project tool window.
Choose on the main or context menu or press Shift+F6.
In Rename File dialog box that opens, specify the new file name. Select Search in comments and strings checkbox to let CLion apply changes to comments and strings.
-
Press Preview to observe possible changes in Find Tool Window. Press Refactor to proceed.
CLion finds all the occurrences of the file name and changes them respectively.
Example
This example represents CMakelists.txt before and after Rename file refactoring:
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}) |
Important notes
- Local variables are renamed in-place.
To be able to use the Rename dialog when renaming local variables, you should disable in-place refactoring in the editor settings.