• Article

FINDSTRING (Expression SSIS)

Renvoie l'emplacement de l'occurrence spécifiée d'une chaîne dans une expression de caractères. Le résultat obtenu est l'index de base un de l'occurrence. Le paramètre de chaîne doit s'évaluer à une expression de caractères et le paramètre de l'occurrence doit s'évaluer à un entier. Si la chaîne est introuvable, la valeur retournée est 0. Si la chaîne se produit moins souvent que l'argument de l'occurrence ne le spécifie, la valeur retournée est 0.

Syntaxe

FINDSTRING(character_expression, searchstring, occurrence)

Arguments

  • character_expression
    Chaîne de caractères dans laquelle la recherche doit être effectuée.

  • searchstring
    Chaîne de caractères à rechercher.

  • occurrence
    Entier signé ou non signé spécifiant l'occurrence de searchstring à signaler.

Types des résultats

DT_I4

Notes

La fonction FINDSTRING s'utilise seulement avec le type de données DT_WSTR. Les arguments character_expression et searchstring qui représentent des littéraux de chaîne ou des colonnes de données du type de données DT_STR sont implicitement convertis dans le type de données DT_WSTR avant que la fonction FINDSTRING soit exécutée. Les autres types de données doivent être explicitement convertis vers le type de données DT_WSTR. Pour plus d'informations, consultez Types de données d'Integration Services et Cast (Expression SSIS) : conversion de types de données SSIS.

La fonction FINDSTRING renvoie la valeur NULL si l'argument character_expression ou searchstring est NULL.

Utilisez la valeur 1 dans l'argument occurrence pour obtenir l'index de la première occurrence, la valeur 2 pour obtenir celui de la deuxième occurrence, et ainsi de suite.

L'argument occurrence doit être un entier supérieur à 0.

Exemples

L'exemple suivant utilise un littéral de chaîne. Il renvoie la valeur 11.

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

L'exemple suivant utilise un littéral de chaîne. La chaîne « NY » ne se produisant que deux fois, le résultat retourné est 0.

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

L'exemple suivant utilise la colonne Name. Il renvoie l'emplacement de la valeur « n » dans la colonne Name. Le résultat obtenu varie en fonction de la valeur de la colonne Name. Si Name contient Anderson, la fonction retourne 8.

FINDSTRING(Name,"n", 2)

L'exemple suivant utilise les colonnes Name et Size. Il renvoie l'emplacement du caractère situé à l'extrême gauche de la valeur Size de la colonne Name. Le résultat obtenu dépend des valeurs de la colonne. Si la colonne Name contient « Mountain,500Red,42 » et que la colonne Size contient « 42 », le résultat obtenu est 17.

FINDSTRING(Name,Size,1)