Altium NEXUS Documentation

Find-Replace Text

Modified by Susan Riege on Jul 16, 2018

   The two variations and tabs of the Find-Replace Text dialog 

Summary

The Find-Replace Text dialog is used to quickly find and replace text in a text document. The Find Text dialog is used only to find text; the Replace Text dialog is used to find then replace text. This can save you from having to constantly scroll up or down to find text and is particularly useful when developing and debugging macro scripts.

Access

The dialog is accessed in the following ways:

  • The Find Text dialog is accessed by clicking Edit » Find from the main menus within a text document.
  • The Replace Text dialog is accessed by clicking Edit » Replace within a text document.

Options/Controls

Find/Replace Text Tab

  • Text to find - enter the string of text to find in the document or use the drop-down to select the string from previous searches.
  • Replace with - enter the string of text to replace the found text with or use the drop-down to select the replacement string from previous replacement strings. This command is available only in the Replace Text dialog.
  • Options 
    • Case sensitive - check to perform the search paying attention to the case.
    • Whole words only - check to find only whole words.
    • Regular expressions - check to search using regular expressions.
      • ^ - only match when the string is at the start of a line.​
      • $ - only match when the string is at the end of a line.
      • . - indicates any single character (e.g., "te.t" matches "test", "text", and "tent", but not "tet").
      • - indicates any set of characters, including no characters (e.g., "te*" matches "text", "tent", and "te", but not "t").
      • + - indicates any set of characters, except no characters (e.g., "te+" matches "text", and "tent", but not "te").
      • [ ] - find any of the characters enclosed in the brackets.
      • [^] - a caret at the start of a string in brackets means NOT (e.g., "[^tes]" matches any characters except t, e, or s).
      • [-] - a hyphen within a string in brackets signifies a range of characters (e.g., "[l-o]" matches the characters l, m, n, and o).
      • { } - used to group characters or expressions. Groups can be nested with a maximum number of 10 groups in a single pattern.
      • - a backslash before a wildcard character tells the Text Editor to treat that character literally, not as a wildcard (e.g., "\^test" does not look for the string test at the start of a line; it looks for the string "^test").
  • Prompt on replace - check to be prompted before replacement occurs. This command is available only in the Replace Text dialog.
  • Search hidden text - check to include hidden text in the search.
  • Wrap search - check to wrap the search string. This command is available only in the Find Text dialog.
  • Direction - use these selections in conjunction with the Origin options to determine from where and how the text is searched..
    • Forward - select to perform the search forward from the cursor.
    • Backward -select to perform the search backward from the cursor.
  • Scope
    • Global - select to search the entire document.
    • Selected text - select to only search currently selected text.
  • Origin - use these selections in conjunction with the Direction options to determine from where and how the text is searched.
    • From cursor - select to begin the search from the cursor location.
    • Entire scope - select to perform the search of the entire document.

Find in Files/Replace in Files Tab

  • Text to find - enter the string of text to find in the document or use the drop-down to select the string from previous searches.
  • Replace with - enter the string of text to replace the found text with or use the drop-down to select the replacement string from previous replacement strings. This command is available only in the Replace Text dialog.
  • Options 
    • Case sensitive - check to perform the search paying attention to the case.
    • Whole words only - check to find only whole words.
    • Regular expressions - check to search using regular expressions. Valid regular expressions include the following:
      • ^ - only match when the string is at the start of a line.​
      • $ - only match when the string is at the end of a line.
      • . - indicates any single character (e.g., "te.t" matches "test", "text", and "tent", but not "tet").
      • - indicates any set of characters, including no characters (e.g., "te*" matches "text", "tent", and "te", but not "t").
      • + - indicates any set of characters, except no characters (e.g., "te+" matches "text" and "tent", but not "te").
      • [ ] - find any of the characters enclosed in the brackets.
      • [^] - a caret at the start of a string in brackets means NOT (e.g., "[^tes]" matches any characters except t, e, or s).
      • [-] - a hyphen within a string in brackets signifies a range of characters (e.g., "[l-o]" matches the characters l, m, n, and o).
      • { } - used to group characters or expressions. Groups can be nested with a maximum number of 10 groups in a single pattern.
      • - a backslash before a wildcard character tells the Text Editor to treat that character literally, not as a wildcard (e.g., "\^test" does not look for the string "test" at the start of a line; it looks for the string "^test").
  • Prompt on replace - check to be prompted before replacement occurs. This command is available only in the Replace Text dialog.
  • Search hidden text - check to include hidden text in the search.
  • Where
    • Search all files in project - select to search within all files in the current project.
    • Search all open files - select to search within all open files.
    • Search in directories - select to search within directories.
    • Open changed files in editor - select to open changed files.
  • Search Directory Options 
    • File Mask -​ click the Browse button to open a dialog to select the desired folder to search.
      • Include subdirectories - check to include subdirectories in the search.

Additional Controls

  • Replace All - click to replace all found strings with the text entered in the Replace with textbox. This command is available only in the Replace Text dialog.
Found an issue with this document? Highlight the area, then use Ctrl+Enter to report it.

Contact Us

Contact our corporate or local offices directly.

You are reporting an issue with the following selected text
and/or image within the active document:
ALTIUM DESIGNER FREE TRIAL
Altium Designer Free Trial
Let’s get started. First off, are you or your organization already using Altium Designer?

If would like to speak with a representative, please contact your local Altium office.
Copyright © 2019 Altium Limited

In that case, why do you need an evaluation license?

If would like to speak with a representative, please contact your local Altium office.
Copyright © 2019 Altium Limited

Got it. You actually don’t need an evaluation license for that.

Click the button below to download the latest Altium Designer installer.

Download Altium Designer Installer

If would like to speak with a representative, please contact your local Altium office.
Copyright © 2019 Altium Limited

Please fill out the form below to get a quote for a new seat of Altium Designer.

By clicking “Get Your Free Trial”, you are agreeing to our Privacy Policy.
You may receive communications from Altium and can change your notification preferences at any time.

If you are on Altium Subscription, you don’t need an evaluation license.

If you are not an active Altium Subscription member, please fill out the form below to get your free trial.

By clicking “Get Your Free Trial”, you are agreeing to our Privacy Policy.
You may receive communications from Altium and can change your notification preferences at any time.

Why are you looking to evaluate Altium Designer?

If would like to speak with a representative, please contact your local Altium office.
Copyright © 2019 Altium Limited

You came to the right place! Please fill out the form below to get your free trial started.

By clicking “Get Your Free Trial”, you are agreeing to our Privacy Policy.
You may receive communications from Altium and can change your notification preferences at any time.

Great News!

Valid students can get their very own 6-month Altium Designer Student License for FREE! Just fill out the form below to request your Student License today.

By clicking “Get Your Free Trial”, you are agreeing to our Privacy Policy.
You may receive communications from Altium and can change your notification preferences at any time.

Got it. You can download a free Altium Designer Viewer license which is valid for a 6 months.

Please fill out the form below to request one.

By clicking “Get Your Free Trial”, you are agreeing to our Privacy Policy.
You may receive communications from Altium and can change your notification preferences at any time.

That’s great! Making things is awesome. We have the perfect program for you.

Upverter is a free community-driven platform designed specifically to meet the needs of makers like you.

Click here to give it a try!

If would like to speak with a representative, please contact your local Altium office.
Copyright © 2019 Altium Limited

Got it. You can download a free Altium Designer Viewer license which is valid for a 6 months.

Please fill out the form below to request one.

By clicking “Get Your Free Trial”, you are agreeing to our Privacy Policy.
You may receive communications from Altium and can change your notification preferences at any time.