SEARCHUP

La fonction SEARCHUP 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 SEARCHUP exige que le caractère 0 soit placé avant 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 SEARCHUP exige que le caractère EBCDIC A soit placé avant 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 :

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

Signification :

SEARCHUP (objet_correspondant_à_renvoyer, éléments_croissants_à_rechercher, élément_correspondant)

Renvoie :

Un objet unique

SEARCHUP effectue une recherche binaire sur la série d'éléments ascending_items_to_search. La série ascending_items_to_search doit être triée par ordre d'octets de page de codes croissant. La valeur à rechercher est spécifiée par item_to_match et doit être du même type que élément_croissant_à_rechercher.

L'objet renvoyé (corresponding_object_to_return) doit être associé à ascending_items_to_search par un nom d'objet commun. Si aucune correspondance n'est trouvée, SEARCHUP renvoie "none".

Exemples

• SEARCHUP (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, SEARCHUP renvoie la première Colonne Age de cette Ligne. Si la valeur de Colonne SSN est supérieure à la Valeur_SSN dans Message, la recherche se poursuit dans la troisième Ligne. Si la valeur de Colonne SSN est inférieure à la Valeur_SSN dans Message, la recherche se poursuit dans la septième Ligne de SélectBD. 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.

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

Fonctions associées

• EXTRACT
• LOOKUP
• SEARCHDOWN