STUFF (Transact-SQL

适用于：SQL Server（从 开始）Azure SQL 数据库Azure SQL 数据仓库并行数据仓库

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

TRANSACT-SQL 语法约定

语法

复制

STUFF ( character_expression , start , length , replaceWith_expression )

参数

character_expression

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

start

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

length

一个整数，指定要删除的字符数。如果 length 为负，则返回空字符串。如果 length 的长度大于第一个 character_expression，则最多可以删除到最后一个 character_expression 中的最后一个字符。如果 length 为零，则在字符串中第一个字符之前插入内容。length 的类型可以是 bigint。

replaceWith_expression

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

返回类型

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

Remarks

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

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

补充字符（代理项对）

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

示例

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

复制

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

下面是结果集：

复制

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