foundText | |||||||
Type | function | ||||||
Dictionary | LCS | ||||||
Library | LiveCode Script | ||||||
Syntax |
| ||||||
Summary | |||||||
Introduced | 1.0 | ||||||
OS | mac, windows, linux, ios, android | ||||||
Platforms | desktop, server, mobile | ||||||
Example |
| ||||||
Values |
| ||||||
Related | Keyword: word, string, selection Command: find Function: clickText, foundField Control Structure: function Glossary: command, return, current card | ||||||
Description | Use the foundText function to determine which word in the search string was found, and whether it matches a whole word or a portion of a word. Depending on what form of the find command you used, the text found may be different from the text you searched for. For example, the command find "hurl" can find any word that starts with the string "hurl", such as "hurling" or "hurler". In this case, the entire word --not just the portion specified in the find command --is surrounded by a box, and the foundText returns the entire word. The foundText function is cleared when the text selection moves into the foundField or when the current card is closed. At the same time, the box the find command draws around the found text disappears. If there is no box, the foundText function returns empty. To get the location of the text that was found, use the foundChunk function. | ||||||
Tags | database |