Text to find | In this field, specify the search pattern. Type the text manually or select one of the previously specified patterns
from the drop-down list.
-
If you specify the search pattern through a regular expression, use the
$n format in back references
(to refer to a previously found and saved pattern).
-
This field can be left empty. If there is no text to find, but the File mask
check box is selected, then search results include only the files matching the specified mask.
|
Replace with | In this field, specify the replacement text. Type the text manually or select one of the previously specified substitutions
from the drop-down list.
-
If you specify the replacement text through a regular expression, use the
$n format in back references.
-
To use a backslash character
\ in a regular expression, escape the meaningful backslashes by inserting
three extra backslashes in front: \\\\ .
This field is available only in the Replace in Path dialog.
|
Options |
In this area, specify additional search and replace parameters. The available options are:
-
Case sensitive - select this check box to have PyCharm distinguish between upper and lowercase letters
while searching.
-
Preserve case - if this check box is selected, PyCharm retains the case of the first letter
and the case of the initial string in general. For example, MyTest will be replaced with Yourtest
if you specify yourtest as the replacement.
This check box is disabled, if the Case sensitive or
Regular expressions check box is selected.
This field is available only in the Replace in Path dialog.
-
Whole words only (may be faster) - select this check box to have PyCharm search for whole words only,
that is, for character strings separated with spaces, tabs, punctuation, or special characters.
This check box is disabled, if the Regular expressions
check box is selected.
-
Regular expressions -
select this check box if the specified search pattern should be treated as
a regular expression.
Click the [Help] link next to the check box to view reference on regular expressions syntax.
- Context - use this drop-down list to confine the search to a certain context, for example:
- anywhere - select this option to search everywhere.
- In comments - select this option to confine search to comments, ignoring the other occurrences.
- In string literals - select this option to confine search to string literals, ignoring the other occurrences
- Except... - select one of the exception options to perform search avoiding comments, string literals or both.
|
Scope | In this area, specify the scope to apply the search to. The available options are:
-
Whole project - select this option to search through the entire project.
-
Directory - select this option to perform search within the specified directory. By default, the text area
already contains the directory name where a file currently
opened in the editor is located (if you call the dialog from the editor), or where a file selected
in the tool window is located (if you call the dialog from the tool window), or the directory name
selected in the tool window.
Pressing the ellipsis button opens the Select Path dialog, where you can
select the necessary directory.
-
Recursively - this check box is only available for the directory search. If selected, sets the search to be
performed in the chosen directory and its subdirectories.
-
Custom - select this option to search in a
scope.
You can choose one of the scopes from
the drop-down list, or click the ellipsis button, and
define a new scope in the Scopes dialog.
|
File name filter | In this area, specify additional settings to narrow down the search scope.
-
File mask - select this check box to narrow down the search scope through file masks.
In the drop-down list, select the desired mask or specify a new one using wildcards.
Wildcard can include
* to substitute a set of any characters, and
? to substitute a single character.
Note that you can specify multiple file masks, delimited with comma
(for example, *.xml,*.sql,*.html ).
If text to find is not entered, and this check box is selected,
then PyCharm find all files matching the specified mask, regardless of their contents.
|
Result options | Click the down arrow to reveal the result presentation options.
|
Find
|
-
When you click this button in the Find dialog box,
PyCharm displays the encountered occurrences of the search string in the Find tool window,
selects the first occurence and opens the file with this occurrence in the editor and moves the focus to it.
-
When you click this button in the Replace dialog box,
PyCharm displays the encountered occurrences of the search string in the Find tool window,
selects the first occurence and opens the file with this occurrence in the editor and moves the focus to it.
At the same time, PyCharm opens the Replace Usage dialog box. Do one of the following:
-
To have the selected occurence replaced, click Replace.
-
To preserve the selected occurrence and move to the next one, click Skip.
-
To have all the occurrences of the search string in the currently active tab replaced, click Replace All in This File.
-
To preserve the occurrences of the search string in the currently active tab (any) and move to the next file, click Skip to Next File.
-
To have all the detected occurrences replaced, click All Files.
-
To switch to the manual mode, click Preview.
The Replace Usage dialog box closes and the focus moves to the Find tool window. Do one of the following:
-
Browse through the list of detected occurrences, select the ones you want to replace and then click Replace Selected.
-
To have all the occurrences changed click Replace All.
|