PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEV, WEBDEV ET WINDEV MOBILE

Accueil | Connexion | Français FR
  • Conditions d'utilisation
  • Type de recherche
  • Table fichier
  • Divers
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadApple WatchUniversal Windows 10 AppWindows Mobile
Autres
Procédures stockées
Effectue une recherche dans :
  • un champ Table,
  • un champ Table hiérarchique,
  • WINDEVWindows Mobile une table affichée dans un champ Combo.
Deux modes de recherche sont disponibles :
  • Recherche d'un élément dans une colonne.
  • Recherche d'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.
Versions 19 et supérieures
WEBDEV - Code Navigateur Cette fonction est désormais disponible en code Navigateur pour les champs Table en mode navigateur.
Nouveauté 19
WEBDEV - Code Navigateur Cette fonction est désormais disponible en code Navigateur pour les champs Table en mode navigateur.
WEBDEV - Code Navigateur Cette fonction est désormais disponible en code Navigateur pour les champs Table en mode navigateur.
Versions 20 et supérieures
Android Cette fonction est désormais disponible pour les applications Android.
iPhone/iPad Cette fonction est désormais disponible pour les applications iPhone/iPad.
Nouveauté 20
Android Cette fonction est désormais disponible pour les applications Android.
iPhone/iPad Cette fonction est désormais disponible pour les applications iPhone/iPad.
Android Cette fonction est désormais disponible pour les applications Android.
iPhone/iPad Cette fonction est désormais disponible pour les applications iPhone/iPad.
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
// Recherche l'élément "Chemise" dans la colonne "COL_Produit"
// Recherche générique à partir de ligne 5
soit ResCherche = TableCherche(COL_Produit, "Chemise", rechercheCommencePar, 5)
// Permet de lister toutes les occurrences d'une valeur recherchée.
Résultat1 est un entier
Résultat1 = TableCherche(COL_NomColonne, "ValeurRecherchée", rechercheIdentique)
TANTQUE Résultat1 <> -1
Trace(Résultat1)
Résultat1 = TableCherche(COL_NomColonne, "ValeurRecherchée", ...
rechercheIdentique, 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> : Constante optionnelle de type Entier
Type de recherche à effectuer :
  • Vrai (valeur par défaut) : Recherche à l'identique (du type "Egale à") : Les éléments ayant une valeur strictement égale à <Élément recherché> sont retournés.
  • Faux : Recherche générique (du type "Commence par") : Les éléments ayant une valeur commençant par <Élément recherché> sont retournés.
Type de recherche à effectuer :
Versions 21 et supérieures
rechercheCommencePar
Nouveauté 21
rechercheCommencePar
rechercheCommencePar (ou Faux par compatibilité)		Recherche générique du type "Commence par"
Les éléments ayant une valeur commençant par <Élément recherché> sont retournés.
Versions 21 et supérieures
rechercheContient
Nouveauté 21
rechercheContient
rechercheContient		Recherche générique du type "Contient"
Les éléments ayant une valeur contenant <Élément recherché> sont retournés.
WEBDEV - Code NavigateurPHP Cette constante n'est pas disponible.
Versions 21 et supérieures
rechercheDéfaut
Nouveauté 21
rechercheDéfaut
rechercheDéfaut		Recherche par défaut. Pour cette fonction, la recherche par défaut est une recherche à l'identique (du type "Egale à").
Les éléments ayant une valeur strictement égale à <Élément recherché> sont retournés.
WEBDEV - Code NavigateurPHP Cette constante n'est pas disponible.
Versions 21 et supérieures
rechercheIdentique
Nouveauté 21
rechercheIdentique
rechercheIdentique (ou Vrai par compatibilité)
(Valeur par défaut)		Recherche à l'identique (du type "Egale à")
Les éléments ayant une valeur strictement égale à <É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.
WINDEVWEBDEV - Code ServeurEtats et RequêtesWindows MobilePHPAjaxCode Utilisateur (MCU)

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

<Résultat> = TableCherche(<Champ Table> , <Valeur recherchée>)
<Résultat> : Entier
  • Indice de l'élément trouvé,
  • -1 si aucun élément ne correspond à la recherche.
<Champ Table> : Nom de champ
Nom du champ à manipuler. Ce champ peut correspondre à :
  • un champ Table.
  • un champ Table hiérarchique.
  • WINDEVWindows Mobile 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

Syntaxe 1 : 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,
  • WINDEVWindows Mobile une table affichée dans un champ Combo,
  • Versions 19 et supérieures
    WEBDEV - Code Navigateur un champ Table en mode navigateur,
    Nouveauté 19
    WEBDEV - Code Navigateur un champ Table en mode navigateur,
    WEBDEV - Code Navigateur un champ Table en mode navigateur,
  • un champ monosélection ou multisélection.
    WEBDEV - Code ServeurPHP Rappel : Les champs multisélections sont disponibles uniquement en Ajax. WEBDEV - Code ServeurPHP Rappel : La multisélection n'est pas disponible sur les champs Table "classique".
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é.
WINDEVWEBDEV - Code ServeurEtats et RequêtesWindows MobilePHPAjaxCode Utilisateur (MCU) Syntaxe 2 : 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 monosélection ou multisélection.
    WEBDEV - Code ServeurPHP Rappel : Les champs multisélections sont disponibles uniquement en Ajax. WEBDEV - Code ServeurPHP Rappel : La multisélection n'est pas disponible sur les champs Table "classique".

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)
    Par exemple :
    // Retourner tous les noms commençant par "DUP"
    TableCherche(COL_ColonneNom, "DUP", rechercheCommencePar)
WINDEVEtats et RequêtesAndroidiPhone/iPadWindows MobilePHPCode 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, ...).
Composante : wd240obj.dll
Voir Aussi
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire