Version de WDScript : 2.0.5+

Positionne sur le premier enregistrement du fichier dont la valeur d'une rubrique spécifique est supérieure ou égale à une valeur recherchée. L'enregistrement est lu et ses variables sont mises à jour.

Syntaxe

HLitRecherche(<Nom du fichier>, <Rubrique>, <Valeur recherchée> [, <Options>])

<Nom du fichier> : Chaîne de caractères (avec guillemets) contenant le nom du fichier, de la vue ou de la requête manipulé.

<Rubrique > : Chaîne de caractères (avec guillemets) contenant le nom de la rubrique sur laquelle la recherche doit être effectuée. Dans le cas d'une recherche à l'identique, ce paramètre peut correspondre à une rubrique non clé.

<Valeur recherchée> : Type correspondant à la valeur de la rubrique recherchée.

<Options> : Constante ou combinaison de constantes optionnelle pouvant être à :
- hBlocageNon : l'enregistrement pourra être lu ou modifié par une autre application pendant la lecture.
- hBlocageEcriture : l'enregistrement en cours de lecture pourra être lu par une autre application mais ne pourra pas être modifié par une autre application.
- hBlocageLectureEcriture : l'enregistrement en cours de lecture ne pourra ni être lu ni être modifié par une autre application.
- hLimiteParcours : Le parcours s'arrêtera dès que la dernière valeur recherchée sera trouvée. L'enregistrement en cours correspondra au dernier enregistrement trouvé. HTrouve (h.Trouve) vaudra Faux et HEndehors (h.EnDehors) vaudra Vrai. Cette constante permet d'optimiser la vitesse de recherche en mode client / serveur.
- hRespecteFiltre : Le parcours prendra en compte le filtre mis en place avec la fonction HFiltre, même si la clé de parcours utilisée n'est pas optimisée pour le filtre. Rappel : la fonction HFiltre renvoie la clé de parcours optimisée pour le filtre.
Attention : dans ce cas, sur des fichiers de taille importante, des problèmes de performances peuvent survenir. Cette variable ne peut pas être utilisée avec HF 5.
- hIdentique : Par défaut (si paramètre non spécifié), le type de recherche est une recherche générique.

Remarque

La recherche peut être générique ou à l'identique.
- Générique : recherche de tous les enregistrements commençant par la valeur indiquée
- A l'identique : recherche de tous les enregistrements correspondant exactement à la valeur indiquée.

Avec HF 5, pour effectuer une recherche à l'identique, il faut utiliser soit la fonction HLitRecherche en complétant la rubrique avec des espaces grâce à la fonction Complète, soit la fonction HLitRecherchePremier. Pour effectuer une recherche générique, il faut utiliser la fonction HLitRecherche sans la fonction Complète.

Exemple

<wdscript>
// Récupération des informations d'un formulaire
action est une chaîne = GetFormField("_ACTION")
key est un entier long
si action <> "" alors	
	si action~="M" ou action~="S" alors
		key  = GetFormField("CLE")		
		HLitRecherche("PERSONNE", "IDPERSONNE", key)
	fin
	si action = "S" alors
		si HFound alors HSupprime("PERSONNE")
	sinon
		PERSONNE.NOM = GetFormField("NOM")
		PERSONNE.PRENOM = GetFormField("PRENOM")
		PERSONNE.AGE = GetFormField("AGE")
		si action = "M" alors
			HModifie("PERSONNE")
		sinon
			HAjoute("PERSONNE")
		fin
	fin
fin
</wdscript>

Commentaires

Les commentaires doivent si possible être postés en anglais. Ils sont soumis à la modération avant d'être publiés.

Ajouter votre commentaire