Expression Language
Also available as:
PDF

replaceFirst

Description: Replaces the first occurrence of one literal String or regular expression within the Subject with another String.

Subject Type: String

Arguments:

  • Search String : The String (literal or regular expression pattern) to find within the Subject

  • Replacement : The value to replace Search String with

Return Type: String

Examples: If the "filename" attribute has the value "a brand new filename.txt", then the following Expressions will provide the following results:

Table 1.9. Table 9. ReplaceFirst Examples

Expression

Value

${filename:replaceFirst('a', 'the')}

the brand new filename.txt

${filename:replaceFirst('[br]', 'g')}

a grand new filename.txt

${filename:replaceFirst('XYZ', 'ZZZ')}

a brand new filename.txt

${filename:replaceFirst('\w{8}', 'book')}

a brand new book.txt