AfArcTextGetPagesByTerm

AfArcTextGetPagesByTerm(alpha1, int2, alpha3, var int4[]) : int
Seitenzahlen eines Suchwortes ermitteln
alpha1 Nummer des Archives int2 Nummer der Anhangdatei alpha3 Suchwort int4[] Array mit den Seitennummern Resultat int Fehlerwert Siehe Verwandte Befehle

Die Funktion ermittelt auf welchen Seiten einer Anhangdatei der angegebene Suchbegriff vorkommt. Die Nummer des Archivs und die Nummer der Anhangdatei werden in (alpha1) und (int2) angegeben. Der Suchbegriff wird in (alpha3) übergeben. In (int4[]) muss ein unbestimmtes Array übergeben werden. Nach erfolgreicher Ausführung der Anweisung stehen in dem Array die Seitennummern und die Anzahl der gefundenen Suchbegriffe auf der Seite.

Beispiel:

local
{
  tErr          : int;
  tPages        : int[];
  tCounter      : int;
  tPage         : int;
  tNumberOfHits : int;
  ...
}

{
  ...
  tErr # AfArcTextGetPagesByTerm(tArcNo,tFileNo,tSearchString,var tPages);
  if (tErr = _ErrOk)
  {
    for tCounter # 0;
    loop inc(tCounter);
    while (tPages[(tCounter * 2) + 1] != 0)
    {
      tPage # tPages[tCounter * 2) + 1]; // Seite mit dem Suchbegriff
      tNumberOfHits # tPages[tCounter * 2) + 2]; // Anzahl der Suchbegriffe auf der Seite
      ...
    }
  }
  else
  {
    // Fehlerbehandlung
    ...
  }
}

Neben den allgemeinen Fehlerwerten können folgende Werte zurückgegeben werden:

Konstante	Wert	Bedeutung
_ErrOk	0	ok - kein Fehler aufgetreten
_rNoRec	5	Das angegebene Archiv existiert nicht
sAfErrNoRights	-20029	Die Berechtigungen sind nicht ausreichend

Für weitere CONZEPT 16-spezifische Rückgabewerte siehe die aktuelle CONZEPT 16-Hilfe.