通过

STUFF (Transact-SQL)

  • 项目

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

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

语法

STUFF ( character_expression , start , length , replaceWith_expression )

参数

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

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

  • length
    一个整数，指定要删除的字符数。 如果 length 比第一个 character_expression 长，则最多删除到最后一个 character_expression 中的最后一个字符。 length 的类型可以是 bigint。

  • replaceWith_expression
    一个字符串数据表达式。 character_expression 可以是常量、变量，也可以是字符列或二进制数据列。 此表达式从 start 开始替换character_expression 的 length 个字符。

返回类型

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

注释

如果开始位置或长度值是负数，或者开始位置大于第一个字符串的长度，则返回 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)

请参阅

参考

数据类型 (Transact-SQL)

字符串函数 (Transact-SQL)