xp_sprintf (Transact-SQL)
Aplica-se:
SQL Server
Formata e armazena uma série de caracteres e valores no parâmetro de saída de cadeia de caracteres. Cada argumento do formato é substituído pelo argumento correspondente.
Convenções de sintaxe de Transact-SQL
Sintaxe
xp_sprintf { 'string' OUTPUT , 'format' }
[ , 'argument' [ , ...n ] ]
Argumentos
Importante
Os argumentos para procedimentos armazenados estendidos devem ser inseridos na ordem específica, conforme descrito na seção sintaxe. Se os parâmetros forem inseridos fora de ordem, ocorrerá uma mensagem de erro.
SAÍDA 'string'
Uma variável varchar que recebe a saída.
Quando OUTPUT é especificado, essa opção coloca o valor da variável no parâmetro de saída.
'formato'
Uma cadeia de caracteres de formato com espaços reservados para valores de argumento , semelhante aos valores suportados pela função de linguagem sprintf C. Atualmente, apenas o %s argumento format é suportado.
'argumento'
Uma cadeia de caracteres que representa o valor do argumento de formato correspondente.
n
Um espaço reservado que indica que um máximo de 50 argumentos podem ser especificados.
Valores do código de retorno
0 (sucesso) ou 1 (falha).
Conjunto de resultados
xp_sprintf retorna a seguinte mensagem:
The command(s) completed successfully.
Permissões
Requer associação à função pública .