PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEV, WEBDEV ET WINDEV MOBILE

Version : 19.0

WinDevWebDev - Code ServeurWebDev - Code NavigateurWinDev MobileEtats et RequêtesWindowsLinuxWindows MobileWindows PhoneWindows Store appsAndroidWidget AndroidiPhone/iPadJavaPHPAjaxCode Utilisateur (MCU)Langage ExterneHFSQLHFSQL Client/ServeurProcédures stockéesHyper File 5.5OLE DBODBCAccès Natifs
TableCherche (Fonction)
En anglais : TableSeek

Effectue une recherche dans :
  • un champ Table,
  • un champ Table hiérarchique,
  • WinDev une table affichée dans un champ Combo.
Deux modes de recherche sont disponibles :
  • Recherche un élément dans une colonne.
  • Recherche un élément dans la valeur mémorisée du champ.
Versions 16 et supérieures
WinDevLinux Cette fonction est désormais disponible pour les applications WinDev sous Linux.
Nouveauté 16
WinDevLinux Cette fonction est désormais disponible pour les applications WinDev sous Linux.
WinDevLinux Cette fonction est désormais disponible pour les applications WinDev sous Linux.
Exemple
// Recherche l'élément "Chemise" dans la colonne "COL_Produit"
// Recherche générique à partir de ligne 5
ResCherche = TableCherche(COL_Produit, "Chemise", Faux, 5)

// Permet de lister toutes les occurrences d'une valeur recherchée.
Résultat1 est un entier
Résultat1 = TableCherche(COL_NomColonne, "ValeurRecherchée", Vrai)
TANTQUE Résultat1 <> -1
Trace(Résultat1)
Résultat1 = TableCherche(COL_NomColonne, "ValeurRecherchée", ...
Vrai, Résultat1 + 1)
FIN

Syntaxe

Rechercher un élément dans une colonne Masquer les détails

<Résultat> = TableCherche(<Nom de la colonne> , <Élément recherché> [, <Type de recherche> [, <Ligne de départ>]])
<Résultat> : Entier
  • Indice de l'élément trouvé,
  • -1 si aucun élément ne correspond à la recherche.
Si la recherche est réalisée :
  • dans un champ Table mémoire, l'élément trouvé n'est pas sélectionné. Pour sélectionner l'élément trouvé, utilisez la fonction TableSelectPlus.
  • dans un champ Table fichier, l'élément trouvé n'est pas sélectionné, les lignes du champ Table défilent jusqu'à l'élément recherché.
<Nom de la colonne> : Chaîne de caractères (avec ou sans guillemets)
Nom de la colonne dans laquelle s'effectue la recherche.
Si ce paramètre correspond à une chaîne vide (""), la colonne manipulée est la colonne à laquelle appartient le traitement en cours.

Dans un champ Table ou Table hiérarchique fichier, la colonne de recherche doit être liée à une rubrique de type clé. Il n'est pas possible de faire une recherche sur une colonne non liée à une rubrique.

<Élément recherché> : Type de l'élément recherché
Élément à rechercher dans la colonne spécifiée. Si l'élément recherché est de type :
  • "Date" ou "Heure" : la recherche est effectuée sur la valeur retournée.
  • "Monétaire + Euro" : la recherche est effectuée sur la devise mémorisée.
<Type de recherche> : Booléen optionnel
  • Vrai (valeur par défaut) si la recherche doit être à l'identique. Dans ce cas, seuls les éléments ayant une valeur strictement égale à <Élément recherché> sont retournés.
  • Faux si la recherche doit être générique. Dans ce cas, tous les éléments commençant par <Élément recherché> sont retournés.
<Ligne de départ> : Entier optionnel
Numéro de la ligne de départ de la recherche dans la colonne.
Si ce paramètre n'est pas spécifié, la recherche est effectuée dans toute la colonne.
Ce paramètre permet de rechercher toutes les occurrences d'une chaîne dans une colonne.
Ce paramètre est ignoré dans le cas d'un champ Table fichier.
WinDevCode Utilisateur (MCU)

Rechercher un élément dans un champ Table (valeur mémorisée) Masquer les détails

<Résultat> = TableCherche(<Nom de la table> , <Valeur recherchée>)
<Résultat> : Entier
  • Indice de l'élément trouvé,
  • -1 si aucun élément ne correspond à la recherche.
<Nom de la table> : Chaîne de caractères (avec ou sans guillemets)
Nom du champ à manipuler. Ce champ peut correspondre à :
  • un champ Table.
  • un champ Table hiérarchique.
  • WinDev un champ Combo avec table.
Le champ Table doit être lié à un fichier de données ou une variable.
<Valeur recherchée> : Type de l'élément recherché
Valeur de l'élément recherché. Cette valeur est recherchée dans la valeur mémorisée du champ.

Remarques

Conditions d'utilisation

La recherche d'un élément dans une colonne est disponible pour :

  • un champ Table ou Table hiérarchique,
  • un champ fichier ou mémoire,
  • WinDev une table affichée dans un champ Combo,
  • un champ mono-sélection ou multi-sélections.

Pour un champ Table ou Table hiérarchique fichier :

  • le mode de parcours doit être automatique.
  • la colonne doit être liée à une rubrique de type clé.

La recherche un élément dans la valeur mémorisée est disponible pour :

  • un champ Table ou Table hiérarchique.
  • un champ fichier ou lié à une variable.
  • un champ mono-sélection ou multi-sélections.

Type de recherche

  • Recherche à l'identique : Seuls les éléments ayant une valeur strictement égale à <Élément recherché> sont retournés par la fonction TableCherche. Par exemple :
// Retourner tous les "Dupond" de la colonne "COL_ColonneNom"
TableCherche(COL_ColonneNom, "Dupond")
  • Recherche générique : Les éléments commençant par <Élément recherché> sont retournés par la fonction TableCherche. Par exemple :
// Retourner tous les noms commençant par "DUP"
TableCherche(COL_ColonneNom, "DUP", Faux)
WinDevJavaCode Utilisateur (MCU)

Table fichier

  • Dans une table fichier, il est possible d'utiliser la syntaxe suivante pour rechercher un élément dans une colonne :
NomDeLaTable = ElémentRecherché
  • Sur les tables fichier à accès direct, lors de l'utilisation de la fonction TableCherche :
    • l'affichage du champ Table est déplacé.
    • l'indice renvoyé correspond à un indice "approchant" car ce type de champ Table peut gérer des milliards d'enregistrements.

Divers

  • Dans un champ Table mémoire, la recherche effectuée avec la fonction TableCherche n'est pas sensible à la casse (majuscules/minuscules).
  • Dans un champ Table fichier, la recherche effectuée avec la fonction TableCherche tient compte des caractéristiques de recherche définies dans l'analyse pour la rubrique liée à la colonne de recherche (sensible ou non à la casse, ...).

Composantes
WinDev wd190obj.dll
Java wd190java.jar
Linux wd190obj.so
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire