String operations

You can use dynamic expressions to modify and verify data in strings. If your string contains special characters, you have to escape them.

Engines 3.0 provide on-screen descriptions of syntax and relevant examples.

To see them, start typing the relevant expression into the Value field. This opens a drop-down list where you can browse available expressions.

This chapter describes string operations for Engines 3.0. For information on string operations in Classic engines, see chapter "TC String Operations".

Available string operations

The following string operations are available in Engines 3.0:

Dynamic expressions for string operations

Expression

Description

Example

Result

{STRINGTOLOWER}

Syntax: {STRINGTOLOWER[InputText]}

Converts uppercase characters in the string to lowercase characters.

{STRINGTOLOWER[Nice Day]}

nice day

{STRINGTOUPPER}

Syntax: {STRINGTOUPPER[InputText]}

Converts lowercase characters in the string to uppercase characters.

{STRINGTOUPPER[Nice Day]}

NICE DAY

{TRIM}

Syntax: {TRIM[InputText][Optional Parameter]}

Removes whitespace characters from the start or the end of the string, or both:

  • If you don't use an optional parameter, the expression removes whitespace characters from both the start and the end of the string (default).

  • If you use the optional parameter [START], Tricentis Tosca removes whitespaces from the start of the string.

  • If you use the optional parameter [END], Tricentis Tosca removes whitespaces from the end of the string.

{TRIM[ no starting space ][START]}

no starting space

{BASE64}

Syntax: {BASE64[InputText][Parameter]}

Parameter ENCODE encodes the string to Base64 format, parameter DECODE decodes the Base64 string.

{BASE64[Hello][ENCODE]}

SGVsbG8=

{STRINGREPLACE}

Syntax: {STRINGREPLACE[InputText][Pattern][NewValue][Optional parameter1, Optional parameter2]}

Replaces all occurrences of a defined input or pattern with a new defined value.

  • If you use the optional parameter [REPLACEFIRST], Tricentis Tosca only replaces the first occurrence.

  • If you use the optional parameter [IGNORECASE], Tricentis Tosca ignores the letter case during the search.

{STRINGREPLACE[WeekEnd][e][x][IGNORECASE]}

Wxxkxnd

{NUMBEROFOCCURRENCES}

Syntax: {NUMBEROFOCCURRENCES[InputText][Pattern][Optional parameter]}

Counts all occurrences of the defined input or pattern in the string.

If you use the optional parameter [IGNORECASE], Tricentis Tosca ignores the letter case during the search.

{NUMBEROFOCCURRENCES[Mississippi][ss]}

2

{STRINGLENGTH}

Syntax: {STRINGLENGTH[InputText]}

Counts the number of characters in the string.

{STRINGLENGTH[Nice2MeetU]}

10