通过

  • 项目

contains 函数 (XQuery)

返回 xs:boolean 类型的值，以指明 $arg1 值是否包含 $arg2 所指定的字符串值。

语法

fn:contains ($arg1 as xs:string?, $arg2 as xs:string?) as xs:boolean?

参数

  • $arg1
    要测试的字符串值。

  • $arg2
    要查找的子字符串。

注释

如果 $arg2 的值是长度为零的字符串，则函数将返回 True。如果 $arg1 的值是长度为零的字符串，而 $arg2 的值不是长度为零的字符串，则函数将返回 False。

如果 $arg1 或 $arg2 的值是空序列，则该参数将被作为长度为零的字符串来处理。

contains() 函数使用 XQuery 默认的 Unicode 码位排序规则来进行字符串比较。

为 $arg2 指定的子字符串值必须小于或等于 4000 个字符。如果指定的值大于 4000 个字符，将出现动态错误情形，并且 contains() 函数将返回空序列（而非布尔值 True 或 False）。SQL Server 不会对 XQuery 表达式生成动态错误。

若要进行不区分大小写的比较，可以使用 upper-case 或 lower-case 函数。

示例

本主题提供了一些对 XML 实例的 XQuery 示例，这些实例存储在 AdventureWorks 数据库内不同的 xml 类型列中。有关这些列的概述，请参阅AdventureWorks 数据库中的 xml 数据类型表示形式。

A. 使用 contains() XQuery 函数搜索特定的字符串

以下查询将查找概要说明中包含单词 Aerodynamic 的产品。此查询将返回这些产品的 ProductID 和 <Summary> 元素。

--The product model description document uses
--namespaces. The WHERE clause uses the exit()
--method of the xml data type. Inside the exit method,
--the XQuery contains()function is used to
--determine whether the <Summary> text contains the word
--Aerodynamic. 

USE AdventureWorks
GO
WITH XMLNAMESPACES ('https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelDescription' AS pd)
SELECT ProductModelID, CatalogDescription.query('
      <Prod>
         { /pd:ProductDescription/@ProductModelID }
         { /pd:ProductDescription/pd:Summary }
      </Prod>
 ') as Result
FROM Production.ProductModel
where CatalogDescription.exist('
   /pd:ProductDescription/pd:Summary//text()
    [contains(., "Aerodynamic")]') = 1

结果

ProductModelID Result

-------------- ---------

28 <Prod ProductModelID="28">

<pd:Summary xmlns:pd=

"https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelDescription">

<p1:p xmlns:p1="http://www.w3.org/1999/xhtml">

A TRUE multi-sport bike that offers streamlined riding and

a revolutionary design.Aerodynamic design lets you ride with

the pros, and the gearing will conquer hilly roads.</p1:p>

</pd:Summary>

</Prod>