STUFF (Transact-SQL)

  • 项目

适用于：SQL ServerAzure SQL 数据库Azure SQL 托管实例Azure Synapse AnalyticsAnalytics Platform System (PDW)Microsoft Fabric 中的 SQL 分析终结点Microsoft Fabric 中的仓库

STUFF 函数将字符串插入到另一个字符串中。 它从第一个字符串的开始位置删除指定长度的字符；然后将第二个字符串插入到第一个字符串的开始位置。

Transact-SQL 语法约定

语法

STUFF ( character_expression , start , length , replace_with_expression )

注意

若要查看 SQL Server 2014 (12.x) 及更早版本的 Transact-SQL 语法，请参阅早期版本文档。

自变量

character_expression

字符数据的表达式。 character_expression 可以是常量、变量，也可以是字符列或二进制数据列。

start

一个整数值，指定删除和插入的开始位置。 如果 start 为负或为零，则返回空字符串。 如果 start 的长度大于第一个 character_expression，则返回空字符串。 start 的类型可以是 bigint。

length

一个整数，指定要删除的字符数。 如果 length 为负，则返回空字符串。 如果 length 的长度大于第一个 character_expression，则最多可以删除到最后一个 character_expression 中的最后一个字符。 如果 length 为零，则插入在 start 位置发生，并且不会删除任何字符。 length 的类型可以是 bigint。

replace_with_expression

字符数据的表达式。 replace_with_expression 可以是常量、变量，也可以是字符列或二进制数据列。 此表达式从 start 开始替换 length 个字符的 character_expression。 通过为 replace_with_expression 提供 NULL，可以在不插入任何内容的情况下删除字符。

返回类型

如果 character_expression 是支持的字符数据类型之一，则返回字符数据。 如果 character_expression 是支持的二进制数据类型之一，则返回二进制数据。

备注

如果开始位置或长度值是负数，或者开始位置大于第一个字符串的长度，则返回 Null 字符串。 如果开始位置为 0，则返回 Null 值。 如果要删除的长度大于第一个字符串的长度，则删除到第一个字符串中的第一个字符。

如果结果值大于返回类型支持的最大值，则会引发错误。

补充字符（代理项对）

使用增补字符 (SC) 排序规则时，character_expression 和 replace_with_expression 都可以包含代理项对。 length 参数将 character_expression 中的每个代理项计为一个字符。

示例

以下示例从第一个字符串 abcdef 的第 2 个位置 (b) 开始删除三个字符，然后在删除位置插入第二个字符串，从而创建并返回一个字符串。

SELECT STUFF('abcdef', 2, 3, 'ijklmn');
GO

下面是结果集。

---------
aijklmnef
  
(1 row(s) affected)

另请参阅