通过

  • 项目

PATINDEX (Transact-SQL)

返回指定表达式中某模式第一次出现的起始位置；如果在全部有效的文本和字符数据类型中没有找到该模式，则返回零。有关详细信息，请参阅搜索条件中的模式匹配。

主题链接图标Transact-SQL 语法约定

语法

PATINDEX ( '%pattern%' , expression )

参数

  • 'pattern'
    包含要查找的序列的字符表达式。可以使用通配符；但 pattern 之前和之后必须有 % 字符（搜索第一个或最后一个字符时除外）。

  • expression
    一个表达式，通常为要在其中搜索指定模式的列，expression 为字符串数据类型类别。

返回类型

如果 expression 的数据类型为 varchar(max) 或 nvarchar(max)，则为 bigint，否则为 int。

注释

如果 pattern 或 expression 为 NULL，则 PATINDEX 返回 NULL。

PATINDEX 基于输入的排序规则执行比较。若要以指定的排序规则进行比较，则可以使用 COLLATE 将显式排序规则应用于输入。

0x0000 (char(0)) 是 Windows 排序规则中未定义的字符，不能包括在 PATINDEX 中。

示例

A. 在 PATINDEX 中使用模式

以下示例查找模式 ensure 在 Document 表的 DocumentSummary 列的某一特定行中的开始位置。

USE AdventureWorks2008R2;
GO
SELECT PATINDEX('%ensure%',DocumentSummary)
FROM Production.Document
WHERE DocumentNode = 0x7B40;
GO

下面是结果集：

-----------

64

(1 row(s) affected)

如果未使用 WHERE 子句限制要搜索的行，查询将返回表中的所有行，对在其中找到该模式的行报告非零值，对未在其中找到该模式的行报告零值。

B. 在 PATINDEX 中使用通配符

以下示例使用通配符查找模式 en_ure 在 Document 表中 DocumentSummary 列的某一特定行中的开始位置，其中下划线为代表任何字符的通配符。

USE AdventureWorks2008R2;
GO
SELECT PATINDEX('%en_ure%', DocumentSummary)
FROM Production.Document
WHERE DocumentNode = 0x7B40;
GO

下面是结果集：

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

64

(1 row(s) affected)

如果没有限制要搜索的行，查询将返回表中的所有行，对在其中找到该模式的所有行报告非零值。

C. 在 PATINDEX 中使用 COLLATE

以下示例使用 COLLATE 函数显式指定要搜索的表达式的排序规则。

USE tempdb;
GO
SELECT PATINDEX ( '%ein%', 'Das ist ein Test'  COLLATE Latin1_General_BIN) ;
GO

D. 使用变量指定模式

下面的示例使用变量将值传递到 pattern 参数。

USE AdventureWorks2008R2; 
GO
DECLARE @MyValue varchar(10) = 'safety'; 

SELECT PATINDEX('%' + @MyValue + '%', DocumentSummary) 
FROM Production.Document
WHERE DocumentNode = 0x7B40;

下面是结果集：

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

22