Skip to content

Commit

Permalink
Update README.md
Browse files Browse the repository at this point in the history
  • Loading branch information
daddel80 authored Aug 31, 2024
1 parent c62cec3 commit 413598e
Showing 1 changed file with 11 additions and 13 deletions.
24 changes: 11 additions & 13 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# MultiReplace for Notepad++
[![License: GPL-2.0](https://img.shields.io/badge/license-GPL--2.0-brightgreen)](https://github.com/daddel80/notepadpp-multireplace/blob/main/license.txt)
[![Latest Stable Version](https://img.shields.io/badge/version-3.1.1.17-blue)](https://github.com/daddel80/notepadpp-multireplace/releases/tag/3.1.1.17)
[![Latest Stable Version](https://img.shields.io/badge/version-3.1.2.18-blue)](https://github.com/daddel80/notepadpp-multireplace/releases/tag/3.1.2.18)
[![Total Downloads](https://img.shields.io/github/downloads/daddel80/notepadpp-multireplace/total?logo=github)](https://github.com/daddel80/notepadpp-multireplace/releases)

MultiReplace is a Notepad++ plugin that allows users to create, store, and manage search and replace strings within a list, perfect for use across different sessions or projects. It increases efficiency by enabling multiple replacements at once, supports sorting and applying operations to specific columns in CSV files, and offers flexible options for replacing text in various ways.
Expand Down Expand Up @@ -33,25 +33,23 @@ MultiReplace is a Notepad++ plugin that allows users to create, store, and manag

## Key Features

- **Multiple Replacements**: Execute multiple replacements in a single operation, in one document or across all opened documents.
- **Entry Toggling**: Toggle list entries for replacement, highlighting, or searching.
- **String Storage**: Store and load your search and replace strings in a list, facilitating reuse across different sessions or projects.
- **CSV Scope Functionality**: Apply search, replace, or sort operations to specific columns in a CSV or other delimited file by selecting column numbers.
- **Scripted Text Replacements**: Export to bash script for scripted text replacements.
- **Highlighting**: Highlight multiple find words in unique colors for better visual distinction.
- **Variable Usage**: Employ variables for conditional and computational operations within the replacement string.
- **Multiple Replacements:** Execute multiple replacements in a single operation, in one document or across all opened documents.
- **Entry Toggling:** Toggle list entries for replacement, highlighting, or searching.
- **String Storage:** Store and load your search and replace strings in a list, facilitating reuse across different sessions or projects.
- **CSV Scope Functionality:** Apply search, replace, or sort operations to specific columns in a CSV or other delimited file by selecting column numbers.
- **Scripted Text Replacements:** Export to bash script for scripted text replacements.
- **Highlighting:** Highlight multiple find words in unique colors for better visual distinction.
- **Variable Usage:** Employ variables for conditional and computational operations within the replacement string.

## Match and Replace Options

This chapter provides an overview of the various match and replace options available in MultiReplace, enhancing the flexibility and precision of your search and replace operations.

**Match Whole Word Only:** When this option is enabled, the search term is matched only if it appears as a whole word. This is particularly useful for avoiding partial matches within larger words, ensuring more precise and targeted search results.

**Match Case:** Selecting this option makes the search case-sensitive, meaning 'Hello' and 'hello' will be treated as distinct terms. It's useful for scenarios where the case of the letters is crucial to the search.

**Use Variables:** This feature allows the use of variables within the replacement string for dynamic and conditional replacements. For more detailed information, refer to the [Option 'Use Variables' chapter](#option-use-variables).

**Replace First Match Only:** The "Replace First Match Only" option is ideal for Replace-All operations, where it replaces only the first occurrence of a match in each list entry. This is particularly useful for different replace strings with the same find pattern. It's designed for modifying only the initial match in a document or scope, while keeping other instances intact. The same effect can be achieved with the 'Use Variables' option using `cond(CNT == 1, 'Replace String')` for conditional replacements.
**Replace First Match Only:** For Replace-All operations, this option replaces only the first occurrence of a match for each entry in a Search and Replace list, instead of all matches in the text. This is useful when using different replace strings with the same find pattern. The same effect can be achieved with the 'Use Variables' option using `cond(CNT == 1, 'Replace String')` for conditional replacements.

**Wrap Around:** When this option is active, the search will continue from the beginning of the document after reaching the end, ensuring that no potential matches are missed in the document.

Expand Down Expand Up @@ -85,9 +83,9 @@ Scope functions define the range for searching and replacing strings:
| Remove Leading Zeros (Non-decimal) | `\b0+(\d*)` | `$1` | Yes | No |

## Option 'Use Variables'
Activate the '**Use Variables**' checkbox to employ variables associated with specified strings, allowing for conditional and computational operations within the replacement string. This Dynamic Substitution is compatible with all search settings of Search Mode, Scope, and the other options. The functionality relies on the [Lua engine](https://www.lua.org/).
Activate the '**Use Variables**' checkbox to employ variables associated with specified strings, allowing for conditional and computational operations within the replacement string. This Dynamic Substitution is compatible with all search settings of Search Mode, Scope, and the other options. This functionality relies on the [Lua engine](https://www.lua.org/).

**Note**: Utilize either the `set()` or `cond()` command in 'Replace with:' to channel the output as the replacement string. Only one of these commands should be used at a time.
**Note**: Utilize either the [`set()`](#command-overview) or [`cond()`](#command-overview) command in 'Replace with:' to channel the output as the replacement string. Only one of these commands should be used at a time.

### Variables Overview
| Variable | Description |
Expand Down

0 comments on commit 413598e

Please sign in to comment.