xp_sprintf (Transact-SQL)

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 da sintaxe Transact-SQL

Sintaxe

xp_sprintf { string OUTPUT , format }
     [ , argument [ ,...n ] ]

Argumentos

• string
  É uma variável varchar que recebe a saída.

• OUTPUT
  Quando for especificado, põe o valor da variável no parâmetro de saída.

• format
  É uma cadeia de caracteres de formato com espaços reservados para valores de argument, semelhante aos quais a função sprintf da linguagem C oferece suporte. Atualmente, é oferecido suporte apenas para o argumento de formato %s.

• argument
  É uma cadeia de caracteres que representa o valor do argumento de formato correspondente.

• n
  É um espaço reservado que indica que no máximo 50 argumentos podem ser especificados.

Valores de código de retorno

0 (êxito) ou 1 (falha)

Conjuntos de resultados

xp_sprintf retorna a seguinte mensagem:

The command(s) completed successfully.

Permissões

Requer associação na função pública.

Consulte também

Referência

Procedimentos armazenados do sistema (Transact-SQL)

Procedimentos armazenados estendidos gerais (Transact-SQL)

xp_sscanf (Transact-SQL)