Escape

 

Description

Escapes special characters in strings so that the results of constant and macro expressions can be embedded in code snippets for the target language/usage.

 

Arguments

1.Escape - Name of the Macro.

2.Target - platform where the string escape is targeted.  Valid values are XML, XMLAttribute, HTML, HTMLAttribute, C#, and both the ' (Single Quote), and " (Double Quote) characters.

3.Expression - A macro expression that will be escaped.

 

Examples

 

Note that in some of the examples the characters in the strings are also macro expression separator characters and are themselves escaped with a % character (further demonstrating why this is necessary).

 

<Escape|C#|This string contains a backslash \ and a double quote " character.>

Returns "This string contains a backslash \\ and a double quote \" character."

 

<Escape|'|Escaping characters is "fun", isn't it?>

Returns "Escaping characters is "fun", isn''t it?"

 

<Escape|"|Escaping characters is "fun", isn't it?>

Returns "Escaping characters is ""fun"", isn't it?"

 

<Escape|HTML|This is an %<HTML%> string with an ampersand & in it.>

Returns "This is an &lt;HTML&gt; string with an ampersand &amp; in it.".

 

<Escape|HTML|'This' is an %<HTML%> string with &#65;n entity reference>

Returns "&#39;This&#39; is an &lt;HTML&gt; string with a&#65;n entity reference".

 

<Escape|HTMLAttribute|This is an %<HTML%> string>

Returns "This is an &lt;HTML> string".

 

<Escape|XML|This is an %<XML%> string with an ampersand & in it.>

Returns "This is an &lt;XML&gt; string with an ampersand &amp; in it".

 

<Escape|XML|'This' is an %<XML%> string with &#65;n entity reference>

Returns "&apos;This&apos; is an &lt;XML&gt; string with &#65;n entity reference".

 

<Escape|XMLAttribute|This is an %<XML%> string>

Returns "This is an &lt;XML> string".

 

Notes

This macro command handles the following target language operations:

•':  Replaces each single quote with two single quote characters.  Ideal for use with SQL Server character types and PowerShell literal strings.

•":  Replaces each double quote with two double quote characters.  Ideal for use with PowerShell expansion strings and Visual Basic language.

•C#: Escapes backslash characters and double quote characters.  Ideal for use in Managed Code or Managed Assembly job steps targeting the C# language.

•HTML: Escapes the ampersand (&), single and double quotes (' and "), and both angle brackets (< and >) and character entity references with HTML specific coding.  Ideal for HTML raw element content.

•HTMLAttribute: Escapes the ampersand (&), double quote ("), and left angle bracket (<) with HTML specific coding.  Ideal for HTML attributes.

•XML: Escapes the ampersand (&), single and double quotes (' and "), and both angle brackets (< and >) with XML specific coding.  Ideal for XML raw element content.

•XMLAttribute: Escapes the ampersand (&), double quote ("), and left angle bracket (<) with XML specific coding.  Ideal for XML attributes.

 

Copyright © 2024 pasUNITY, Inc.

 

Send comments on this topic.