xp_sprintf (Transact-SQL)

Aplica-se a: 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

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 .