@STRING(Text)

Description

Returns the value that is specified as a string. The STRING directive allows hard coded text to be passed as a parameter to an action without the text being interpreted as a smart parameter. While this is not required for most text, if the hardcoded input text contains smart parameter special characters such as slashes, @, +, then this will prevent them from being interpreted.

Example

In the first example, the action passes a string, unchanged, to rrCompareCase.

Action and result

Action: rrCompareCase("@STRING(me@example.com)", "@F", "false")

Result: This action compares the string "me@example.com" to the value of the current field and returns true if the values match. The action does not try to interpret the @ as a smart parameter symbol.

In this example is a variant that shows other strings can still be concatenated, as supported by smart parameter syntax.

Action: rrCompareCase("another+@STRING(me@example.com)", "@F", "false")

Result: This action compares the string "anotherme@example.com" to the value of the current field and returns true if the values match. The action does not try to interpret the @ as a smart parameter symbol.

In this example, the text 'Airfare' + 'Taxes' = 'Total_Cost' is passed to CalculateFields without any additional processing that could change the meaning of the string.

Action: CalculateFields("@STRING('Airfare' + 'Taxes' = 'Total_Cost')", "", "")