FunctX XQuery Functions

FunctX XQuery Function Library > Strings > Contains >

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, O'Reilly Media. 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`

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/

Need XQuery Help?

D A T Y P I C

Training | Consulting | Development

	Get the book!
	XQuery by Priscilla Walmsley