Compartilhar via


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.

Ícone de vínculo de tópico 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)