Share via


xp_sscanf (Transact-SQL)

Lê dados da cadeia de caracteres para os locais de argumento especificados por cada argumento de formato.

Ícone de vínculo de tópico Convenções da sintaxe Transact-SQL

Sintaxe

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

Argumentos

  • string
    É a cadeia de caracteres a partir da qual os valores de argumentos serão lidos.

  • SAÍDA
    Quando for especificado, põe o valor de argument no parâmetro de saída.

  • format
    É uma cadeia de caracteres formatada semelhante à qual o suporte é oferecido pela função sscanf da linguagem C. Atualmente, é oferecido suporte apenas para o argumento de formato %s.

  • argument
    É uma variável varchar definida como o valor do argumento format 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_sscanf retorna a seguinte mensagem:

Command(s) completed successfully.

Permissões

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

Exemplos

O exemplo a seguir usa xp_sscanf para extrair dois valores de uma cadeia de caracteres de origem com base em suas posições no formato da cadeia de caracteres de origem.

DECLARE @filename varchar (20), @message varchar (20)
EXEC xp_sscanf 'sync -b -fproducts10.tmp -rrandom', 'sync -b -f%s -r%s', 
  @filename OUTPUT, @message OUTPUT
SELECT @filename, @message

Aqui está o conjunto de resultados.

-------------------- -------------------- 
products10.tmp        random

Consulte também

Referência

Procedimentos armazenados do sistema (Transact-SQL)

Procedimentos armazenados estendidos gerais (Transact-SQL)

xp_sprintf (Transact-SQL)