Tamino XQuery User Guide - Software AG Documentation

Text Retrieval
XQuery Function Call
tf:containsText($a, " ")
tf:containsText($a, " ")
tf:containsText($a, ' *")
tf:containsText($a, ' *")
tf:containsText($a, " ")
tf:containsAdjacentText($a, 1, " ", " ")
tf:containsNearText($a, 1, " ", " ")
tf:containsNearText($a, 1, " *", "* ")
Matching Samples
1, 2, 3
—
1, 2, 3, 4
1, 2, 3
3
—
3, 4
The Escapecard Character
With the help of the escapecard character you can negate any special meaning of the following
single character. By default, the escapecard character is the backslash character "\". Use it if you
want to look for any of the maskcard, escapecard or wildcard characters as literal characters.
Example 1: Escaping an Asterisk
let $text:= text{"** End of code **"}
return tf:containsText($text, "\*\*")
Here, the match succeeds if there is any two-letter word in $text that consists only of asterisks.
This is true for the first and last words in $text.
Example 2: Escaping a Backslash
The following checks the path separator character that is used in $path and returns the result as
plain text, ordered by platform:
{?serialization method="text" media-type="text/plain"?}
let $path := text{"C:\Program Files\Software AG\Tamino"}
return
( "Path Separators Used
",
"DOS/Windows	: ", tf:containsText($path, "*\\*"), "
",
"UNIX	: ", tf:containsText($path, "*/*"), "
",
"MacOS	: ", tf:containsText($path, "*:*")
)
In the pattern, the path separator character must be enclosed by the regular wildcard character,
since it would not form a word on its own. Provided that the path separator character is defined
as a regular character, the query reports for each platform whether its standard path separator
character is used, although this example is certainly not a bullet-proof method. However, if the
102
XQuery User Guide