Partilhar via


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 da cadeia de caracteres. Cada argumento de formato é substituído pelo argumento correspondente.

Transact-SQL convenções de sintaxe

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 de sintaxe. Se os parâmetros forem inseridos fora de ordem, ocorrerá uma mensagem de erro.

'string' SAÍDA

Um varchar variável 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 argumento valores, semelhante aos valores suportados pela função sprintf da linguagem C. Atualmente, apenas o argumento de formato %s é 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 pode ser especificado.

Valores de código de retorno

0 (sucesso) ou 1 (fracasso).

Conjunto de resultados

xp_sprintf retorna a seguinte mensagem:

The command(s) completed successfully.

Permissões

Requer a participação na função pública.