fn:exactly-one
Returns a sequence if it contains exactly one item, otherwise errors
Description
The fn:exactly-one function returns $arg if it contains one and only one item. Otherwise, the error FORG0005 is raised. This function is useful when static typing is in effect, to avoid apparent static type errors.
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 |
|---|---|
$arg |
item()* |
| return value | item() |
Examples
| XPath Example | Results |
|---|---|
exactly-one( () ) |
Error FORG0005 |
exactly-one('a') |
a |
exactly-one( ('a', 'b') ) |
Error FORG0005 |
See Also
| fn:one-or-more | Returns a sequence if it contains one or more items, otherwise errors |
| fn:zero-or-one | Returns a sequence if it contains zero or one items, otherwise errors |
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:
