Page Comparison

Warning
Looking for the documentation on the newest versions of SIL Engine and the Simple Issue Language for Jira 8 for Server/Data Center? Click here !

Info

title	Availability

This routine is available since katl-commons starting with SIL Engine™ 2.0.3 (for JIRA Jira 5.x ) or katl-commons SIL Engine™ 1.1.10 ( for JIRA Jira 4.3.x and /4.4.x).

Syntax

...

matches(string, regex)

Description

...

Excerpt
Returns "true" if character expression string matches the regular expression regex.

Parameters

...

Parameter name
Type
Required
Description
string
string
Yes
Specifies a character expression to match the regex against.
regex
string
Yes
Specifies a regular expression to match the specified string.

Return type

...

boolean (true/false)

Related routines

Filter by label (Content by label)

showLabels	false
spaces	SIL40
showSpace	false
cql	label = "regex" and space = "SIL"
labels	regex

Example

...

Example 1

...

Code Block
wret = matches("This will return ?", ".will."); print("Return " + wret);

Matches any string containing "will". Prints Return true

Example 2

...

Code Block
wret = matches("This will return ?", "will"); print("Return " + wret);

Matches only the string "will". Prints Return false

Example 3

...

Code Block
wret = matches("This will return ?", ".will[^\\?]\\?"); print("Return " + wret);

Matches any string containing "will" and ending with a question mark. Prints Return true

Notes

...

Note
As shown in Example 3, use double backslash (\\) instead of a single backslash where needed.
For more information on regular expressions, see
http://docs.oracle.com/javase/7/docs/api/java/util/regex/Pattern.html
Oracle documentation.

Versions Compared

Old Version 1

New Version Current

Key

Syntax

matches(string, regex)

Description

Excerpt
Returns "true" if character expression string matches the regular expression regex.

Parameters

Parameter name
Type
Required
Description
string
string
Yes
Specifies a character expression to match the regex against.
regex
string
Yes
Specifies a regular expression to match the specified string.

Return type

boolean (true/false)

Related routines

Example

Example 1

Code Block
wret = matches("This will return ?", ".will."); print("Return " + wret);
Matches any string containing "will". Prints Return true

Example 2

Code Block
wret = matches("This will return ?", "will"); print("Return " + wret);
Matches only the string "will". Prints Return false

Example 3

Code Block
wret = matches("This will return ?", ".will[^\\?]\\?"); print("Return " + wret);
Matches any string containing "will" and ending with a question mark. Prints Return true

Notes

Note
As shown in Example 3, use double backslash (\\) instead of a single backslash where needed.
For more information on regular expressions, see
http://docs.oracle.com/javase/7/docs/api/java/util/regex/Pattern.html
Oracle documentation.

See also

Filter by label (Content by label)
showLabels false
max 100
showSpace false
cql label = "string_routines"
labels string_routines

Parameter name	Type	Required	Description
string	string	Yes	Specifies a character expression to match the regex against.
regex	string	Yes	Specifies a regular expression to match the specified string.

Page Comparison

Versions Compared

Old Version 1

New Version Current

Key

Syntax

matches(string, regex)

Description

ExcerptReturns "true" if character expression string matches the regular expression regex.

Parameters

Parameter nameTypeRequiredDescriptionstringstringYesSpecifies a character expression to match the regex against.regexstringYesSpecifies a regular expression to match the specified string.

Return type

boolean (true/false)

Related routines

Example

Example 1

Code Blockwret = matches("This will return ?", ".*will.*"); print("Return " + wret); Matches any string containing "will". Prints Return true

Example 2

Code Blockwret = matches("This will return ?", "will"); print("Return " + wret); Matches only the string "will". Prints Return false

Example 3

Code Blockwret = matches("This will return ?", ".*will[^\\?]*\\?"); print("Return " + wret); Matches any string containing "will" and ending with a question mark. Prints Return true

Notes

NoteAs shown in Example 3, use double backslash (\\) instead of a single backslash where needed.For more information on regular expressions, see http://docs.oracle.com/javase/7/docs/api/java/util/regex/Pattern.html Oracle documentation.

See also

Filter by label (Content by label)showLabelsfalsemax100showSpacefalsecqllabel = "string_routines"labelsstring_routines

Excerpt
Returns "true" if character expression string matches the regular expression regex.

Parameter name
Type
Required
Description
string
string
Yes
Specifies a character expression to match the regex against.
regex
string
Yes
Specifies a regular expression to match the specified string.

Code Block
wret = matches("This will return ?", ".will."); print("Return " + wret);
Matches any string containing "will". Prints Return true

Code Block
wret = matches("This will return ?", "will"); print("Return " + wret);
Matches only the string "will". Prints Return false

Code Block
wret = matches("This will return ?", ".will[^\\?]\\?"); print("Return " + wret);
Matches any string containing "will" and ending with a question mark. Prints Return true

Note
As shown in Example 3, use double backslash (\\) instead of a single backslash where needed.
For more information on regular expressions, see
http://docs.oracle.com/javase/7/docs/api/java/util/regex/Pattern.html
Oracle documentation.

Filter by label (Content by label)
showLabels false
max 100
showSpace false
cql label = "string_routines"
labels string_routines