FINDSTRING (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 (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)