设置一系列字符和值的格式并将其存储到字符串输出参数中。每个格式参数都用相应的参数替换。

语法

xp_sprintf {string OUTPUT, format}

    [, argument [,...n]]

参数

string

是接收输出的 varchar 变量。

OUTPUT

如果指定，则将变量值放在输出参数中。

format

是带有与 argument 值对应的占位符的格式字符串，类似于 C 语言的 sprintf 函数所支持的格式字符串。目前仅支持 %s 格式参数。

argument

是代表相应格式参数值的字符串。

n

是表示最多可以指定 50 个参数的占位符。

返回代码值

0（成功）或 1（失败）

结果集

xp_sprintf 返回下列消息：

The command(s) completed successfully.

权限

执行权限默认授予 public 角色。

示例

下例使用参数创建 INSERT 语句。

DECLARE @ret_string varchar (255)
EXEC xp_sprintf @ret_string OUTPUT, 'INSERT INTO %s VALUES (%s, %s)', 'table1', '1', '2'
PRINT @ret_string

下面是结果集：

INSERT INTO table1 VALUES (1, 2)