SEARCHDOWN

La fonction SEARCHDOWN effectue une recherche binaire sur la série triée et renvoie un objet associé qui correspond à l'élément trouvé.

L'ordre des octets des caractères varie en fonction de la page de codes. Par exemple, étant donné que le caractère ASCII A (0x41) possède une valeur numérique supérieure à celle du caractère ASCII 0 (0x30), la fonction SEARCHDOWN exige que le caractère 0 soit placé après le caractère ASCII A dans la série. Le caractère EBCDIC A (0xC1) possède une valeur numérique inférieure à celle du caractère EBCDIC 0, par conséquent la fonction SEARCHDOWN exige que le caractère EBCDIC A soit placé après le caractère EBCDIC 0 dans la série.

Les valeurs de propriété du jeu de caractères Lien HCL modifient l'ordre de classement de certains caractères. Par exemple, la valeur de propriété de la langue nationale allemande est classée selon l'ordre des octets, à l'exception de certains caractères : æ est commandé après a, e est commandé avant ä, etc. Il existe des règles de classement particulières pour d'autres valeurs de propriété de langue nationale. Cependant, il n'existe pas d'ordre de classement pour les valeurs de propriété "Europe occidentale" et "Japonais", et les valeurs de propriété de jeu de caractères obsolètes sont toujours classées dans l'ordre des octets.

Syntaxe :

SEARCHDOWN (expression-objet-série, expression-objet-élément-série, expression-élément-unique)

Signification :

SEARCHDOWN (objet_correspondant_à_renvoyer, éléments_décroissants_à_rechercher , élément_correspondant)

Renvoie :

Un objet unique

SEARCHDOWN effectue une recherche binaire sur la série d'éléments descending_items_to_search. La série descending_items_to_search doit être triée par ordre d'octets de page de codes décroissant. La valeur à rechercher est spécifiée par item_to_match. L'objet renvoyé (corresponding_object_to_return) doit être associé à descending_items_to_search par un nom d'objet commun.

Si aucune correspondance n'est trouvée, SEARCHDOWN renvoie "none".

Exemples

• SEARCHDOWN (Colonne Age:Ligne:SélectBD, Colonne SSN:Ligne:SélectBD, Valeur_SSN:Message )

  Si SélectBD contient dix lignes, la recherche commence par comparer la première Colonne SSN de la cinquième ligne à la Valeur_SSN dans Message. Si le résultat est concordant, SEARCHDOWN renvoie la première Colonne Age de cette Ligne. Si la valeur de Colonne SSN est inférieure à la Valeur_SSN dans Message, la recherche se poursuit dans la troisième Ligne. Si la valeur de Colonne SSN est supérieure à la Valeur_SSN dans Message, la recherche se poursuit dans la septième Colonne de Sélect_BD. La recherche continue de cette façon jusqu'à ce qu'une concordance soit trouvée ou qu'une Ligne soit sélectionnée. S'il existe plusieurs Colonnes SSN pour la Ligne sélectionnée, une recherche similaire est lancée sur toutes les Colonnes SSN afin de trouver la Ligne sélectionnée dans SélectBD.

  SEARCHDOWN renvoie la première Colonne Age pour la Ligne sélectionnée de SélectBD.

Fonctions associées

• EXTRACT
• LOOKUP
• SEARCHUP