PATINDEX (Transact-SQL)
返回模式在指定表达式中第一次出现的起始位置;如果在所有有效的文本和字符数据类型中都找不到该模式,则返回零。
语法
PATINDEX ( '%pattern%' , expression )
参数
pattern
包含要查找的序列的字符表达式。 可以使用通配符;但 pattern 之前和之后必须有 % 字符(搜索第一个或最后一个字符时除外)。 pattern 是字符串数据类型类别的表达式。 pattern 最多包含 8000 个字符。expression
是一个表达式,通常是针对指定模式搜索的列。 expression 属于字符串数据类型类别。
返回类型
如果 expression 的数据类型为 varchar(max) 或 nvarchar(max),则返回 bigint;否则返回 int。
注释
如果 pattern 或 expression 为 NULL,则 PATINDEX 返回 NULL。
PATINDEX 基于输入的排序规则执行比较。 若要以指定排序规则进行比较,则可以使用 COLLATE 将显式排序规则应用于输入。
补充字符(代理项对)
在使用 SC 排序规则时,返回值将 expression 参数中的任何 UTF-16 代理项对计为一个字符。 有关详细信息,请参阅排序规则和 Unicode 支持。
0x0000 (char(0)) 是 Windows 排序规则中未定义的字符,不能包括在 PATINDEX 中。
示例
A.在 PATINDEX 中使用模式
以下示例查找模式 ensure 在 Document 表的 DocumentSummary 列的特定行中的开始位置。
USE AdventureWorks2012;
GO
SELECT PATINDEX('%ensure%',DocumentSummary)
FROM Production.Document
WHERE DocumentNode = 0x7B40;
GO
下面是结果集:
-----------
64
(1 row(s) affected)
如果未使用 WHERE 子句限制要搜索的行,查询将返回表中的所有行,对找到该模式的行报告非零值,对未找到该模式的行报告零值。
B.在 PATINDEX 中使用通配符
以下示例使用 % 和 _ 通配符查找模式 'en'(后跟任意一个字符和 'ure')在指定字符串中的开始位置(索引从 1 开始):
SELECT PATINDEX('%en_ure%', 'please ensure the door is locked');
下面是结果集:
------------
8
PATINDEX 的作用与 LIKE 类似,因此,您可以使用任何通配符。 不必将模式放在百分号之间。 PATINDEX('a%', 'abc') 将返回 1;PATINDEX('%a', 'cba') 将返回 3。
与 LIKE 不同的是,PATINDEX 返回一个位置,这与 CHARINDEX 类似。
C.在 PATINDEX 中使用 COLLATE
以下示例使用 COLLATE 函数显式指定要搜索的表达式的排序规则。
USE tempdb;
GO
SELECT PATINDEX ( '%ein%', 'Das ist ein Test' COLLATE Latin1_General_BIN) ;
GO
D.使用变量指定模式
下面的示例使用变量将值传递到 pattern 参数。
USE AdventureWorks2012;
GO
DECLARE @MyValue varchar(10) = 'safety';
SELECT PATINDEX('%' + @MyValue + '%', DocumentSummary)
FROM Production.Document
WHERE DocumentNode = 0x7B40;
下面是结果集:
------------
22
请参阅
参考
[ ](通配符 - 要匹配的字符)(Transact-SQL)