FirebirdSQL logo
 Instructions de procédure SQL (PSQL)Fonctions agrégées 

POSITION()

Disponible en

DSQL, PSQL

Syntaxe
  POSITION (substr IN string)
| POSITION (substr, string [, startpos])
Table 1. paramètres de fonction POSITION
Paramètre Description

substr

Sous-chaîne dont la position est recherchée.

string

La ligne dans laquelle la position est recherchée.

startpos

La position à laquelle la recherche de sous-chaîne commence.
Le type de résultat renvoyé :

INTEGER

La fonction POSITION renvoie la position de la première occurrence d’une sous-chaîne dans la chaîne.Il commence par 1.Le troisième argument (facultatif) indique la position dans la chaîne à laquelle la recherche de la sous-chaîne commence, ignorant ainsi toutes les occurrences de la sous-chaîne dans la chaîne avant cette position.Si aucune correspondance n’est trouvée, la fonction renvoie 0.

Caractéristiques d’utilisation :

  • Un troisième paramètre facultatif n’est pris en charge que par la deuxième variante de la syntaxe (syntaxe à virgules séparées) ;

  • Une chaîne vide, la fonction la traite comme une sous-chaîne de n’importe quelle chaîne. Par conséquent, avec un paramètre d’entrée substr égal à ' (chaîne vide), et avec un paramètre string autre que NULL, le résultat sera :

    • 1, si le paramètre startpos n’est pas donné ;

    • startpos, si startpos ne dépasse pas la longueur du paramètre string ;

    • 0 si startpos est supérieur à la longueur du paramètre string.

Exemple POSITION

Example 1. Utilisation de la fonction POSITION
POSITION ('be' IN 'To be or not to be')   -- Résultat: 4
POSITION ('be', 'To be or not to be')     -- Résultat: 4
POSITION ('be', 'To be or not to be', 4)  -- Résultat: 4
POSITION ('be', 'To be or not to be', 8)  -- Résultat: 17
POSITION ('be', 'To be or not to be', 18) -- Résultat: 0
POSITION ('be' in 'Alas, poor Yorick!') -- Résultat: 0
Voir aussi :

[fblangref-scalarfuncs-substring].