Trait string_patterns::pattern_replace::PatternReplace

pub trait PatternReplace
where
    Self: Sized,
{
    // Required methods
    fn pattern_replace_result(
        &self,
        pattern: &str,
        replacement: &str,
        case_insensitive: bool
    ) -> Result<Self, Error>
       where Self: Sized;
    fn pattern_replace_first_result(
        &self,
        pattern: &str,
        replacement: &str,
        case_insensitive: bool
    ) -> Result<Self, Error>
       where Self: Sized;
    fn pattern_replace(
        &self,
        pattern: &str,
        replacement: &str,
        case_insensitive: bool
    ) -> Self
       where Self: Sized;
    fn pattern_replace_first(
        &self,
        pattern: &str,
        replacement: &str,
        case_insensitive: bool
    ) -> Self
       where Self: Sized;

    // Provided methods
    fn pattern_replace_ci(&self, pattern: &str, replacement: &str) -> Self
       where Self: Sized { ... }
    fn pattern_replace_cs(&self, pattern: &str, replacement: &str) -> Self
       where Self: Sized { ... }
    fn pattern_replace_first_ci(&self, pattern: &str, replacement: &str) -> Self
       where Self: Sized { ... }
    fn pattern_replace_first_cs(&self, pattern: &str, replacement: &str) -> Self
       where Self: Sized { ... }
}

Core regular expression replacement methods

Required Methods

fn pattern_replace_result( &self, pattern: &str, replacement: &str, case_insensitive: bool ) -> Result<Self, Error>

where Self: Sized,

Replace all matches of the pattern within a longer text with a boolean case_insensitive flag NB: If the regex doesn’t compile it will return an Error, otherwise in Ok result. If the regex fails, nothing will be replaced

fn pattern_replace_first_result( &self, pattern: &str, replacement: &str, case_insensitive: bool ) -> Result<Self, Error>

where Self: Sized,

Replace only the first match of the pattern within a longer text with a boolean case_insensitive flag NB: If the regex doesn’t compile it will return an Error, otherwise in Ok result. If the regex fails, nothing will be replaced

fn pattern_replace( &self, pattern: &str, replacement: &str, case_insensitive: bool ) -> Self

where Self: Sized,

Replace all matches of the pattern within a longer text with a boolean case_insensitive flag Returns a copy of the same data type. If the regex fails, nothing will be replaced.

fn pattern_replace_first( &self, pattern: &str, replacement: &str, case_insensitive: bool ) -> Self

where Self: Sized,

Replace only the first match of the pattern within a longer text with a boolean case_insensitive flag Returns a copy of the same data type. If the regex fails, nothing will be replaced.

Provided Methods

fn pattern_replace_ci(&self, pattern: &str, replacement: &str) -> Self

where Self: Sized,

Replace all matches of the pattern within a longer text in case-insensitive mode If the regex fails, nothing will be replaced

fn pattern_replace_cs(&self, pattern: &str, replacement: &str) -> Self

where Self: Sized,

Replace all matches of the pattern within a longer text in case-sensitive mode If the regex fails, nothing will be replaced

fn pattern_replace_first_ci(&self, pattern: &str, replacement: &str) -> Self

where Self: Sized,

Replace the first match only of the pattern within a longer text in case-insensitive mode If the regex fails, nothing will be replaced

fn pattern_replace_first_cs(&self, pattern: &str, replacement: &str) -> Self

where Self: Sized,

Replace the first match only of the pattern within a longer text in case-sensitive mode If the regex fails, nothing will be replaced

Object Safety

This trait is not object safe.

Implementations on Foreign Types

impl PatternReplace for String

Core regex replacement methods for Strings

fn pattern_replace_result( &self, pattern: &str, replacement: &str, case_insensitive: bool ) -> Result<String, Error>

Regex-enabled replace method that will return an OK String result if successful and an error if the regex fails

fn pattern_replace_first_result( &self, pattern: &str, replacement: &str, case_insensitive: bool ) -> Result<String, Error>

Regex-enabled replace method that will return an OK String result if successful and an error if the regex fails

fn pattern_replace( &self, pattern: &str, replacement: &str, case_insensitive: bool ) -> String

Simple regex-enabled replace-all method that will return the same string if the regex fails

fn pattern_replace_first( &self, pattern: &str, replacement: &str, case_insensitive: bool ) -> String

Regex-enabled single replace method that will return an OK String result if successful and an error if the regex fails

impl PatternReplace for Vec<String>

Implemented separately of arrays / vectors of strings to ensure the regex is only compiled once

fn pattern_replace_result( &self, pattern: &str, replacement: &str, case_insensitive: bool ) -> Result<Vec<String>, Error>

Optional regex-enabled replace method that will return None if the regex fails

fn pattern_replace_first_result( &self, pattern: &str, replacement: &str, case_insensitive: bool ) -> Result<Vec<String>, Error>

Optional regex-enabled replace method that will return None if the regex fails

fn pattern_replace( &self, pattern: &str, replacement: &str, case_insensitive: bool ) -> Vec<String>

Simple regex-enabled replace-all method that will return the same string if the regex fails

fn pattern_replace_first( &self, pattern: &str, replacement: &str, case_insensitive: bool ) -> Vec<String>

Simple regex-enabled replace-first method that will return the same string if the regex fails

Implementors