# VerifyString

La fonction VerifyString permet de vérifier une chaîne de caractères et produire une sortie réussite/échec.

## VerifyString – Entrées

Paramètre | Description
Chaîne | Spécifie une chaîne de caractères ou une référence à une cellule de feuille de calcul contenant une chaîne de caractères.
Chaîne du champ | Indique le nombre de caractère contenus dans la chaîne de caractères et fournit des informations sur les caractères attendus aux différentes positions dans la chaîne.
Définition de champs | Vous pouvez utiliser le paramètre Définition du champ pour créer des entrées personnalisées pour la Chaîne du champ. Lorsqu’elles sont incluses dans la Chaîne du champ, ces entrées limitent la liste des caractères valides aux positions auxquelles elles sont insérées.

### Chaîne du champ

Une entrée Chaîne du champ peut être tout caractère alphanumérique, dont les caractères (A à Z), (a à z), (0 à 9), le tiret (-), les points (.) et les espaces ( ).

Chaque caractère de la Chaîne du champ correspond à une position de champ indexée. La Chaîne du champ doit contenir au moins autant de positions qu’il y a de caractères dans la chaîne pour que la vérification de la chaîne de caractères réussisse (par exemple, si 10 caractères sont présents et que la Chaîne du champ ne spécifie que 9 caractères, les 9 meilleures correspondances sont renvoyées ; cependant, si 8 caractères sont présents et que la Chaîne du champ spécifie 9 caractères, la fonction renvoie #ERR). Par défaut, chaque position de la Chaîne du champ st représentée par un astérisque (*), c’est-à-dire un « caractère générique » alphanumérique. Ceci signifie que tout caractère est valide à toute position de la chaîne.

Les entrées de Chaîne du champ prédéfinies sont les suivantes :

Entrée Chaîne du champ | Description | Caractères valides
* | Caractère générique | Tout caractère appris dans la police.
N | Numérique | 0123456789
A | Alphabétique en majuscules | ABCDEFGHIJKLMNOPQRSTUVWXYZ
a | Alphabétique en minuscules | abcdefghijklmnopqrstuvwxyz
H | Hexadécimal, alphabétique en majuscules et numérique | 0123456789abcdef
h | Hexadécimal, alphabétique en minuscules et numérique | 0123456789abcdef
O | Octal | 01234567

Exemples de chaîne du champ :

- Exemple 1 : Si la Chaîne du champ est **********AN, tous les caractères de la police sont valides dans les 10 premières positions de Chaîne du champ. A la onzième position, seuls les caractères alpha majuscules sont pris en compte lors de la vérification. A la douzième position, seuls des caractères numériques sont pris en considération.

- Exemple 2 : La police ne contient que les caractères numériques 0-9 et le caractère /. Si la Chaîne du champ est NN/NN/NN, seuls les caractères numériques seront pris en compte aux première et deuxième, quatrième et cinquième, septième et huitième positions. Seule la barre oblique (/) sera prise en considération aux troisième et sixième positions.

  Cependant, si la Chaîne du champ est NN/NN/AA, la vérification de la chaîne de caractères renvoie #ERR car la police ne contient pas de caractères alpha.

### Définition de champs

Vous pouvez utiliser le paramètre Définition du champ pour créer des entrées personnalisées pour la Chaîne du champ. Lorsqu’elles sont incluses dans la Chaîne du champ, ces entrées limitent la liste des caractères valides aux positions auxquelles elles sont insérées.

Vous pouvez remplacer les définitions prédéfinies en ajoutant une nouvelle définition à ce champ. Par exemple, si la valeur de Définition du champ est A=A, seul le caractère A sera considéré comme un caractère valide car la Définition du champ A=A écrase l’entrée de chaîne du champ prédéfinie.

Exemples de définitions du champ :

- Exemple 1 : Si la valeur de Définitions du champ est #=123;$=3456;%=789, et que celle de Chaîne du champ est #$%*******, les seuls caractères valides en première position seront 1, 2 ou 3. Les seuls caractères valides en deuxième position seront 3, 4, 5 ou 6. En troisième position, seuls 7, 8, ou 9 seront valides. Tous les caractères de la police sont valides de la quatrième à la dixième position.
- Exemple 2 : Si la valeur de Définitions du champ est #=123;$=3456;%=789, A=A et que celle de Chaîne du champ est #$%******A, les seuls caractères valides en première position seront 1, 2 ou 3. Les seuls caractères valides en deuxième position seront 3, 4, 5 ou 6. En troisième position, seuls 7, 8, ou 9 seront valides. Tous les caractères de la police sont valides de la quatrième à la neuvième position. Seul le caractère A sera pris en compte à la dixième position car la Définition du champ A=A remappe l’entré Chaîne du champ prédéfinie.

## VerifyString – Sorties

Renvoie | L’état réussite/échec de la chaîne dans la structure de données Text référencée, ou #ERR si l’un des paramètres d’entrée est incorrect. 0 = Échec 1 = Succès