xp_sscanf (Transact-SQL)

Aplica-se a:SQL Server

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

Transact-SQL convenções de sintaxe

Sintaxe

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

Argumentos

'string' SAÍDA

A cadeia de caracteres a partir da qual ler os valores de argumento.

Quando OUTPUT é especificado, string coloca o valor do argumento no parâmetro de saída.

'formato'

Uma cadeia de caracteres formatada, semelhante aos valores suportados pela função sscanf da linguagem C. Atualmente, apenas o argumento de formato %s é suportado.

'argumento'

Um varchar variável definida como o valor do formato argumento 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_sscanf retorna a seguinte mensagem:

Command(s) completed successfully.

Permissões

Requer a participaçã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 AS VARCHAR (20), @message AS VARCHAR (20);

EXECUTE 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.

(No column name) (No column name)
---------------- --------------------
products10.tmp   random

Conteúdo relacionado

• Procedimentos armazenados do sistema (Transact-SQL)
• Procedimentos armazenados estendidos gerais (Transact-SQL)
• xp_sprintf (Transact-SQL)