• Artigo

FINDSTRING (expressão SSIS)

Retorna o local da ocorrência especificada de uma cadeia de caracteres dentro de uma expressão de caractere. O resultado de retorno é o índice da ocorrência. O parâmetro de cadeia de caracteres deve ser avaliado como uma expressão de caractere e o parâmetro de ocorrência deve ser avaliado como um inteiro. Se a cadeia de caracteres não for localizada, o valor de retorno será 0. Se a cadeia de caracteres acontecer menos vezes que o argumento de ocorrência especifica, o valor de retorno será 0.

Sintaxe

FINDSTRING(character_expression, searchstring, occurrence)

Argumentos

  • character_expression
    É a cadeia de caracteres para pesquisa.

  • searchstring
    É a cadeia de caracteres para pesquisa.

  • occurrence
    É um inteiro assinado ou não assinado que especifica qual ocorrência de searchstring deve ser informada.

Tipos de resultado

DT_I4

Comentários

FINDSTRING funciona apenas com o tipo de dados Dt_WSTR. Os argumentos character_expression e searchstring, literais de cadeia de caracteres ou uma coluna de dados com o tipo de dados DT_STR, são implicitamente convertidos para o tipo de dados DT_WSTR antes de FINDSTRING executar sua operação. Outros tipos de dados devem ser explicitamente convertidos para o tipo de dados DT_WSTR. Para obter mais informações, consulte Tipos de dados do Integration Services e Cast (expressão SSIS): Converter tipos de dados SSIS.

FINDSTRING retornará nulo se character_expression ou searchstring forem nulos.

Use um valor de 1 no argumento occurrence para obter o índice da primeira ocorrência, 2 para a segunda ocorrência e assim por diante.

A occurrence deve ser um inteiro com um valor maior do que 0.

Exemplos

Este exemplo usa um literal de cadeia de caracteres. Retorna o valor 11.

FINDSTRING("New York, NY, NY", "NY", 1)

Este exemplo usa um literal de cadeia de caracteres. Porque a cadeia de caracteres "NY" ocorre só duas vezes, o resultado de retorno é 0.

FINDSTRING("New York, NY, NY", "NY", 3)

Este exemplo usa a coluna Name. Ele retorna o local do valor n na coluna Name. O resultado de retorno varia, dependendo do valor em Name. Se Name contiver Anderson, a função retornará 8.

FINDSTRING(Name,"n", 2)

Este exemplo usa as colunas Name e Size. Retorna o local do caractere na extrema esquerda do valor Size na coluna Name. O resultado de retorno varia, dependendo de valores de coluna. Se Name contiver Mountain,500Red,42 e Size contiver 42, o resultado de retorno será 17.

FINDSTRING(Name,Size,1)