Finding and replacing content in a project
Search some or all of your project for text strings or symbol names, and perform advanced searches using regular expressions.
Overview
Xcode offers sophisticated search and replace capabilities in the Find navigator, which you access from the navigator area of your project. Use the Find navigator to search for text and symbols across your entire project. To perform advanced searches, use regular expressions or use the navigator’s controls to narrow the scope of the search operations.
To display the Find navigator, click the magnifying glass icon in the navigator area of your project.
[Image]
Find text strings
To search for text in your project:
In the search criteria bar, select Find > Text.
Select a search criteria: Containing, Matching, Starting with, or Ending with.
Enter text into the search field.
Select a case-sensitivity option from the pop-up menu.
Press Return.
Xcode displays the results of the search. When you select a result, Xcode displays the result in the editor area. To quickly navigate to the next or previous item, choose Find > Find Next in Project or Find > Find Previous in Project.
Find symbol references and definitions
Xcode offers two ways to search for symbols:
Use Find > References to search your code for the specified symbol name.
Use Find > Definitions to search for the source file that contains the definition of the specified symbol.
When you execute the search, the search results contain only places where your code refers to the symbol. The results don’t include references to the symbol in code comments or other project files. To refine your results, change the matching behavior and case sensitivity options of your search.
Replace instances of found text
To search for text and replace it with another string:
In the search criteria bar, select Replace > Text.
Select a search criteria: Containing, Matching, Starting with, or Ending with.
Enter text into the search field.
Select a case-sensitivity option from the pop-up menu.
Enter text in the replacement field.
Press Return.
Xcode displays the results of the search, but it doesn’t automatically replace the text. To replace the text for a single result, select it and click the Replace button. To replace the text for all results, click Replace All.
Filter the list of search results
After any search, you can narrow the search results further by entering a secondary string into the filter bar. The Find navigator temporarily removes results that don’t also contain the string you type into the filter bar. To restore the original results, clear the text from the filter bar.
Limit the scope of a find or replace operation
When you execute a search, Xcode searches all files in your project by default. To search only a subset of files, click Scope and choose from the options that appear.
Click a project or group to restrict searches to the designated part of your Xcode project.
Create a custom scope to restrict searches to files in specific locations or files with a specific name, path, extension, type, or source-control status.
[Image]
Refine searches to match predefined pattern strings
Pattern tokens help you match strings that contain variable content. For example, you might use a pattern token to represent an email address in a string.
To add a pattern to your search string, click the magnifying glass in the search field and choose Insert Pattern from the pop-up menu.
[Image]
Select the pattern you want from the pop-up menu to add it to your search field. Xcode defines pattern tokens for white space, URLs, hexadecimal digits, and other specific character sets. Include one or more tokens plus literal text to perform complex pattern matching.
[Image]
Find or replace using a regular expression
Regular expressions let you define your own custom pattern strings to use during matches. The NSRegularExpression class in the Foundation framework defines the syntax that you use for Xcode regular expressions.
To find or replace text using a regular expression:
In the search criteria bar, select Find > Regular Expression or Replace > Regular Expression.
Select a search criteria: Containing, Matching, Starting with, or Ending with.
Enter the regular expression into the Find or Replace search field.
Select a case-sensitivity option from the pop-up menu.
Press Return.
[Image]