Skip to main content

2 Bash commands to change strings in multiple files at once

Search and replace text in several files simultaneously, right from the Linux terminal, to gain efficiency and minimize mistakes.

Think about some situations when you need to change strings in text files in your Linux hosts.

Depending on the case, you will simply change the file directly in your favorite text editor.

[ Check out this article comparing various text editors. ]

But what if there are too many files? Too many changes? And on top of that, you want a more automated method to perform this task precisely, in a way that is also repeatable and somehow self-documented.

Got your attention? OK, I'll elaborate.

Things to consider before making any changes

If you are using an integrated development environment (IDE), you probably already have a function for global search and replace in multiple files. In this case, you would have the option to confirm, case by case, which occurrence to replace (unless you are pretty sure that you really want to replace all).

Think of the following examples as methods to perform these types of changes using only the command line instead of an IDE.

But you may also want to inspect the changes before applying them because—different from the IDE option—the command-line method is more immediate (no confirmation is asked, by default).

In my example scenario, I have three files that contain references to variables user_name and user_home, which for some good reason I must change to admin_name and admin_home.

Before making any changes, I inspect the occurrences in the current directory:

Image
The grep user_ command
(Roberto Nozaki, CC BY-SA 4.0)

Hmm. I can see the string user_ in the files playbook.yml and vars.yml, but there is also a directory. I can use the following command to include that in the search:

Image
Use find, grep, xargs to display results
(Roberto Nozaki, CC BY-SA 4.0)

Note: As the combination of find and xargs grep does not highlight the string user_ like in the first example, I added an extra grep command to highlight the string.

In other scenarios, you may have to use regular expressions more elaborate than the example above to catch strings preceded by a comment (#) followed by zero or more spaces or a mix of upper and lower case. Yes, regular expressions can get complex.

Following are two ways you can change strings in multiple files simultaneously.

1. Change strings in files in the same directory

If I only wanted to change the strings in the files in the present directory, I could use:

sed -i 's/user_/admin_/g' *.yml

Here, I used the sed command with the -i argument to make the changes in place. The /g at the end of the parameter means replace all occurrences in each file.

2. Change strings in files in the current and subdirectories

In my example scenario, there are files in subdirectories that also need to be changed. For that, I use the find command again:

find ./ -type f | xargs sed -i 's/user_/admin_/g'

In this case, I use the find command with the parameter -type f to return only files and not directory names. The xargs command will receive each file name returned by the find command and apply the sed command.

[ Download now: A system administrator's guide to IT automation. ]

Wrap up

If you know exactly what you need to change, and you are dealing with a string that is safe to be replaced by another, you can speed up the process by using the commands shown here.

Be extra careful with strings that may be common in your files: If you apply a global change that affects more than what you intended, you may have to revert to your backup copies (which you certainly have, right?).

Check out these related articles on Enable Sysadmin

Topics:   Bash   Command line utilities   Text editors   Automation  
Author’s photo

Roberto Nozaki

Roberto Nozaki [RHCSA/RHCE]  is a Senior Consultant at Red Hat Canada where he specializes in IT automation with Ansible. More about me

On Demand: Red Hat Summit 2021 Virtual Experience

Relive our April event with demos, keynotes, and technical sessions from
experts, all available on demand.

Related Content

OUR BEST CONTENT, DELIVERED TO YOUR INBOX