TextSearch
obj -> TextSearch(int1, int2, int3, alpha4[, alpha5[, int6]]) : int
Zeichenfolge in einem Text suchen / ersetzen
Details
- obj: Textpuffer-Deskriptor
- int1: Anfangszeile
- int2: Anfangsspalte
- int3:
- Optionen:
_TextSearchCI_TextSearchCount_TextSearchToken
- alpha4: Suchbegriff
- alpha5: Ersatzbegriff (optional)
- int6: Ersetzungsanzahl (optional)
- Resultat:
intSuchresultat Zeilenummer Suchbegriffsfunde Ersetzungsvorgänge - Siehe: Verwandte Befehle ,
TextOpen (),TextInfo (),TextSearchRegEx (),WinRtfSearch ()
Mit dieser Funktion wird der Textpuffer (obj) nach der Zeichenfolge (alpha4) durchsucht. In (int1) wird die Zeile und in (int2) die Spalte angegeben, ab welcher die Suche erfolgen soll. Resultat der Funktion ist die Zeilenummer in der der Suchbegriff zum ersten mal gefunden wurde. Falls der Begriff nicht gefunden wurde ist das Resultat 0.
Beispiel:
if (tTextHdl->TextSearch(1, 1, _TextSearchCI, 'CONZEPT 16') > 0)
{
// Begriff gefunden
...
}
Mit der Funktion TextInfo () mit der Option _TextSearchClm kann die Spaltenposition der gefundenen Zeichenfolge ermittelt werden.
Folgende Optionen (int3) sind zulässig:
_TextSearchCIBei der Suche wird die Groß/-Kleinschreibung nicht beachtet._TextSearchCountDas Resultat ist die Anzahl der Suchbegriffsfunde._TextSearchTokenDie Suchergebnisse beschränken sich auf gänze Wörter.
Falls ein Ersatzbegriff (alpha5) angegeben ist, wird der Suchbegriff (alpha4) an jeder Stelle im Text durch den Ersatzbegriff ersetzt und die Funktion liefert die Anzahl der Ersetzungsvorgänge zurück.
In (int6) kann die Anzahl der Ersetzungsvorgänge begrenzt werden.
Mögliche Laufzeitfehler:
_ErrHdlInvalid: Textpuffer-Deskriptor (obj) ungültig