Fonction INCLUDE( )

Renvoie une chaîne qui inclut uniquement les caractères spécifiés.

Syntaxe

INCLUDE(chaîne_de_caractères; caractères_à_inclure)

Paramètres

Nom Type Description
chaîne caractère Valeur à limiter aux caractères inclus.
caractères_à_inclure caractère

Liste des caractères à inclure.

Si vous indiquez des guillemets doubles dans les caractères_à_inclure, vous devez placer la liste de caractères à l'intérieur de guillemets simples.

Par exemple : '"-/'

Remarque

Si un caractère que vous spécifiez à inclure n'apparaît pas dans chaîne de caractères, il n'est pas inclus dans la valeur renvoyée.

Sortie

Caractère.

Exemples

Exemples basiques

Renvoie "123", ce qui correspond à la chaîne d'entrée ne contenant que des chiffres :

INCLUDE("123 Main St."; "0123456789")

Renvoie "1231234", ce qui correspond à la chaîne d'entrée ne contenant que des chiffres :

INCLUDE("123-123-4"; "1243")

Renvoie "" (rien), car la chaîne d'entrée ne contient pas de "D" :

INCLUDE("ABC"; "D")

Remarques

Fonctionnement

La fonction INCLUDE( ) compare chaque caractère de la chaîne_de_caractères avec les caractères de la liste caractères_à_inclure. En cas de correspondance, le caractère est inclus dans la chaîne de sortie.

Aucun caractère correspondant

S'il n'existe aucune correspondance entre chaîne_de_caractères et caractères_à_inclure, la sortie de la fonction est vide.

Respect de la casse

La fonction INCLUDE( ) est sensible à la casse. Si vous indiquez « ID » dans caractères_à_inclure, ces caractères ne seront pas inclus dans « id#94022 ». Si vous pensez que la casse est incohérente dans la chaîne, utilisez la fonction UPPER( ) pour convertir tous les caractères en majuscules.

Par exemple :

INCLUDE(UPPER("id#94022"), "ID0123456789")

Conseil d'utilisation

Utilisez INCLUDE( ) si le jeu de caractères à inclure est petit et que le jeu à exclure est grand.

Fonctions associées

La fonction INCLUDE( ) est l'opposé de la fonction EXCLUDE( ).

Guide de création de scripts ACL 14.1