WireTextTools::findReplaceEscapeChars() method

Find escaped characters in $str, replace them with a placeholder, and return the placeholders

Usage

Available since version 3.0.162.

Example

// 1. Escape certain chars in a string that you want to survive some processing:
$str = 'Hello \*world\* foo \"bar\" baz';

// 2. Use this method to find escape chars and replace them temporarily:
$a = $sanitizer->getTextTools()->findReplaceEscapeChars($str, [ '*', '"' ]);

// 3. Process string with anything that you want NOT to see chars that were escaped:
$str = some_function_that_processes_the_string($str);

// 4. Do this to restore the escaped chars (restored without backslashes by default):
$str = str_replace(array_keys($a), array_values($a), $str); 

Usage

// basic usage
$array = $wireTextTools->findReplaceEscapeChars($str, array $escapeChars);

// usage with all arguments
$array = $wireTextTools->findReplaceEscapeChars($str, array $escapeChars, array $options = []);

Arguments

NameType(s)Description
str
escapeCharsarray

Array of chars you want to escape i.e. [ '*', '[', ']', '(', ')', '`', '_', '\', '"' ]

options (optional)array

Options to modify behavior:

  • escapePrefix (string): Character used to escape another character (default is backslash).
  • restoreEscape (bool): Should returned array also include the escape prefix, so escapes are restored? (default=false)
  • gluePrefix (string): Prefix for placeholders we substitute for escaped characters (default='{ESC')
  • glueSuffix (string): Suffix for placeholders we substitute for escaped characters (default='}')
  • unescapeUnknown (bool): If we come across escaped char not in your $escapeChars list, unescape it? (default=false)
  • removeUnknown (bool): If we come across escaped char not in your $escapeChars list, remove the escape and char? (default=false)

Return value

array

Returns assoc array where keys are placeholders substituted in $str and values are escaped characters.


WireTextTools methods and properties

API reference based on ProcessWire core version 3.0.172

Twitter updates

  • This week ProcessWire gained powerful new tools for finding pages and controlling how they are loaded. If you like to maximize performance and efficiency, you’ll like what 3.0.172 brings— More
    5 February 2021
  • ProcessWire 3.0.171 dev branch core updates – More
    22 January 2021
  • Preliminary 2021 roadmap in progress in this week’s update— More
    8 January 2021

Latest news

  • ProcessWire Weekly #353
    In the 353rd issue of ProcessWire Weekly we're going to check out the weekly update from Ryan and the latest core updates, check out a brand new site of the week, and launch a new poll. Read on!
    Weekly.pw / 13 February 2021
  • ProcessWire 3.0.172 – Find faster and more efficiently
    This week ProcessWire gained powerful new tools for finding pages and controlling how they are loaded. If you like to maximize performance and efficiency, you’ll like what 3.0.172 brings.
    Blog / 5 February 2021
  • Subscribe to weekly ProcessWire news

“Yesterday I sent the client a short documentation for their ProcessWire-powered website. Today all features already used with no questions. #cmsdoneright—Marc Hinse, Web designer/developer