Méthode WorksheetFunction.SearchB (Excel)

  • Article

Search et SearchB recherchent une chaîne de texte dans une deuxième chaîne de texte et retournent le numéro de la position de départ de la première chaîne de texte à partir du premier caractère de la deuxième chaîne de texte.

Syntaxe

expression. SearchB (Arg1, Arg2, Arg3)

Expression Variable qui représente un objet WorksheetFunction .

Parameters

Nom Requis/Facultatif Type de données Description
Arg1 Obligatoire String Find_text : texte que vous souhaitez rechercher.
Arg2 Obligatoire Chaîne Within_text - texte dans lequel vous souhaitez utiliser la fonction find_text.
Arg3 Facultatif Variant Start_num - numéro du caractère de within_text auquel vous souhaitez commencer la recherche.

Valeur renvoyée

Double

Remarques

La recherche est destinée aux langues qui utilisent le jeu de caractères codés sur un octet (SBCS), tandis que SearchB est destiné aux langues qui utilisent le jeu de caractères codés sur deux octets (DBCS). Le paramètre de langue par défaut de l'ordinateur affecte la valeur renvoyée de la manière suivante :

  • La recherche compte toujours 1 pour chaque caractère, qu’il s’agisse d’un octet ou d’un octet double, quel que soit le paramètre de langue par défaut.

  • SearchB compte chaque caractère codé sur deux octets comme 2 lorsque vous avez activé la modification d’une langue qui prend en charge DBCS, puis que vous la définissez comme langue par défaut. Sinon, SearchB compte chaque caractère comme 1.

  • Les langues qui prennent en charge les caractères codés sur deux octets sont le japonais, le chinois (simplifié), le chinois (traditionnel) et le coréen.

Utilisez Search et SearchB pour déterminer l’emplacement d’un caractère ou d’une chaîne de texte dans une autre chaîne de texte afin de pouvoir utiliser les fonctions Mid et MidB ou Replace et ReplaceB pour modifier le texte.

Search et SearchB ne respectent pas la casse. Si vous souhaitez effectuer une recherche respectant la casse, vous pouvez utiliser Find et FindB.

Utilisez les caractères génériques, le point d’interrogation (?) et l’astérisque (*), dans find_text. Un point d'interrogation correspond à un caractère unique, un astérisque à une séquence de caractères. Si vous souhaitez rechercher un point d'interrogation ou un astérisque, entrez un tilde (~) avant le caractère.

Si find_text est introuvable, la valeur d'erreur #VALUE! est renvoyée.

Si start_num est omis, sa valeur est considérée comme étant 1.

Si start_num n'est pas supérieur à 0 (zéro) ou est supérieur à la longueur de within_text, la valeur d'erreur #VALUE! est renvoyée.

Utilisez start_num pour ignorer un certain nombre de caractères. En utilisant la recherche comme exemple, supposons que vous travaillez avec la chaîne AYF0093.YoungMensApparelde texte . Pour rechercher le numéro du premier "Y" dans la partie descriptive de la chaîne de texte, définissez start_num égal à 8 afin que la partie numéro de série du texte ne fasse pas l’objet d’une recherche. La recherche commence par le caractère 8, recherche find_text au caractère suivant et retourne le nombre 9.

La recherche renvoie toujours le nombre de caractères à partir du début de within_text, en comptant les caractères que vous ignorez si start_num est supérieur à 1.

Assistance et commentaires

Avez-vous des questions ou des commentaires sur Office VBA ou sur cette documentation ? Consultez la rubrique concernant l’assistance pour Office VBA et l’envoi de commentaires afin d’obtenir des instructions pour recevoir une assistance et envoyer vos commentaires.