fn:contains
Whether one string contains another
Description
The fn:contains function returns true if $arg1 contains the characters of $arg2 anywhere in its contents, including at the beginning or end.
This description is © Copyright 2007, Priscilla Walmsley. It is excerpted from the book XQuery by Priscilla Walmsley, O'Reilly, 2007. For a complete explanation of this function, please refer to Appendix A of the book.
Arguments and Return Type
| Name | Type | Description |
|---|---|---|
$arg1 |
xs:string? |
the string to test |
$arg2 |
xs:string? |
the substring to test for |
$collation |
xs:string |
the collation to use for sorting |
| return value | xs:boolean |
Examples
| XQuery Example | Results |
|---|---|
contains('query', 'e') |
true |
contains('query', 'ery') |
true |
contains('query', 'query') |
true |
contains('query', 'x') |
false |
contains('query', '') |
true |
contains('query', ()) |
true |
contains( (), 'q') |
false |
See Also
| functx:contains-word | Whether one string contains another, as a separate word |
| functx:contains-case-insensitive | Whether one string contains another, without regard to case |
| functx:contains-any-of | Whether a string contains any of a sequence of strings |
| functx:index-of-string | The position(s) of a substring |
| functx:index-of-string-first | The first position of a substring |
| functx:index-of-string-last | The last position of a substring |
| fn:starts-with | Whether one string starts with another |
| fn:ends-with | Whether one string ends with another |
| fn:matches | Whether a string matches a regular expression |
History
| Published On | Last Updated | Contributor(s) |
|---|---|---|
| 2006-06-27 | 2007-02-26 | W3C, XQuery 1.0 and XPath 2.0 Functions and Operators, http://www.w3.org/TR/xpath-functions/ |
Recommended Reading:
